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Vorwort 


Ober  vier  Jahre  sind  vergangen,  seitdem  die  erste  Auflage  des  Profibuchs  erschienen  ist.  In 
der  Zwischenzeit  hat  sich  vieles  bei  Hardware  (MEGA  ST,  STE,  MEGA  STE,  TT,  Stacy, 
SCSI-Festplatten)  und  Software  (neue  TOS-Versionen,  XCONTROL)  getan.  Auch  liber  viele 
betriebssysteminteme  Zusammenhange  wissen  wir  heute  mehr  als  damals.  Alle  diese  neuen 
Informationen  haben  wir  in  diese  komplette  Uberarbeitung  einflieBen  lassen. 

Wie  Sie  sehen,  haben  wir  dabei  nunmehr  das  maximale  Fassungsvermogen  fur  ein  einzelnes 
Buch  erreicht.  Mit  kiinftigen  Weiterentwicklungen  -  ob  beim  Betriebssystem  (Multitasking?) 
oder  bei  der  Hardware  (ST-Book,  68040-Rechner)  -  werden  wir  uns  daher  voraussichtlich  zu 
einem  spateren  Zeitpunkt  in  einem  Erganzungsband  befassen. 

Im  vorliegenden  Band  sind  wir  unserem  Motto  treu  geblieben,  Fakten  moglichst  vollstandig, 
aktuell,  iibersichtlich,  prazise  und  preisgiinstig  zu  prasentieren.  Wir  hoffen,  daB  Sie  mit  dem 
Ergebnis  zufrieden  sind. 

Munster,  im  Oktober  1991 

Hans-Dieter  Jankowski,  Dietmar  Rabich  und  Julian  Reschke 

Elektronische  Mail  kann  an  folgende  Adressen  gerichtet  werden: 

Hardware:  Hans-Dieter_Jankowski@  un.maus.de 

Software:  Dietmar_Rabich@do.maus.de 

Julian_Reschke@ms.maus.de 


Hans-Dieter  Jankowski 

Nach  nicht  unerheblichem  Arbeitsaufwand  ist  es  endlich  geschafft!  Die  Hardware-Kapitel 
zum  ATARI  ST/STE/TT  Profibuch  sind  endlich  fertig.  Nach  Erscheinen  der  ersten  Auflage 
des  ATARI  ST  Profibuchs  hat  sich  ja  doch  einiges  auf  dem  Hardware-Sektor  bei  Atari  getan. 
So  istdenn  auch  einiges  an  Informationen  zusammengekommen,  das  hier  niedergelegt  wurde. 
Wie  immer  hat  “unsereiner”  sich  mal  wiederbeziiglich  des  dazu  erforderlichen  Zeitaufwandes 
um  ca,  300  Prozent  verschatzt,  aber  dennoch:  Es  ist  vollbracht! 

“Unsereiner”  ist  jetzt  Mitte  30,  heiBt  Hans-Dieter  Jankowski  und  ist  von  Beruf  immer  noch 
Ingenieur  fur  Nachrichtentechnik.  Wahrend  des  Studiums  in  den  Jahren  1974  bis  1977  ist 
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“unsereiner”  kaum  von  der  Datenverarbeitung  “beriihrt”  worden  (eher  abgeschreckt  durch  die 
Praktika  an  der  DV-Anlage  in  unserer  Hochschule,  welche  mit  Lochkarten  und  in  “PROS A 
300”  -  ist  auch  eine  Programmiersprache,  wenn  ich  mich  noeh  recht  erinnere  -  programmiert 
wurde). 

Nach  dem  Einstieg  mit  programmierbaren  Taschenrechnem  um  1979,  mit  ersten  Erfolgs- 
erlebnissen  in  Form  von  selbsterstellten Programmer  erfolgte  ein  Wechsel  auf  einen  “echten” 
Homecomputer  mit  Z80-CPU,  16  KByte  RAM  und  Kassettenrekorder  als  “Massenspeicher” 
(vielleicht  erinnnert  sich  ja  der  eine  oder  andere  Leser  noch  an  das  “Video  Genie”-System). 
Dann  muBte  Grafik  und  am  besten  auch  Farbe  her.  Das  fuhrte  zur  Anschaffung  eines  “DAI”- 
Systems  (8080  CPU,  48  KByte  RAM  und  gute  Farbgrafik-Bigenschaften),  aber  leider  auch 
in  eine  Sackgasse.  Es  gab  nur  sehr  wenige  Anwender  und  kaum  Software! 

Aber  dann  (um  1983)  entdeckte  “unsereiner”  den  ATARI  800XL  und  in  diesem  Zusammen- 
hang  auch  Julian  Reschke  (nein,  nein,  ich  habe  Julian  Reschke  nicht  entdeckt ,  sondem 
lediglich  kennen-  und  schatzengelemt!).  Julian  arbeitete  ebenfalls  auf  einem  8-Bit-Atari  und 
hatte  schon  bald  Erfolge  als  Fachautor.  Also  warum  nicht  selbst  einen  Versuch  starten;  Ideen 
waren  genug  da.  Zuerst  kamen  kleine  Software-Tips,  dann  Utilities,  die  auch  von  den  V erlagen 
angenommen  wurden.  Spater  kamen  noch  Erfahrungsberichte  liber  Software  dazu. 

Aber  letztlich  kann  keiner  gegen  seine  Natur  und  “unsereiner”  nicht  gegen  seine  Leidenschaft 
fur  die  Hardware  und  damit  das  “Innenleben”  der  Ataris.  Drucker-  und  sonstige  Interfaces 
wurden  gebaut  und  auch  ein  Cartridge-Experimentiersystem  fur  die  8-Bit- ATARIs  entwickelt 
(erschien  mal  im  ATARI-Sonderheft  von  “Happy  Computer”).  1 986  kam  dann  der  “Umstieg” 
auf  den  ersten  16-Bit-Computer  (520ST+)  von  Atari.  Begeistert  von  der  Bedienungs- 
freundlichkeit  (erster  Gedanke:  Ein  tolles  Ding,  diese  Maus;  zweiter  Gedanke:  Wie  die  wohl 
von  innen  aussieht?)  und  der  groBartigen  Bildschirmdarstellung  (erster  Gedanke:  Das  Bild 
flimmert  ja  gar  nicht;  zweiter  Gedanke:  Da  muBte  man  doch  mal  das  Videosignal  unter- 
suchen),  verschlang  “unsereiner”  alles,  was  an  Informationen  zu  bekommen  war.  Besonders 
die  Hardware  interessierte  natiirlich,  aber  da  waren  die  Infos  doch  sehr  sparlich.  Letztlich 
fuhrte  diese  Leidenschaft  dann  dazu,  die  Kenntnisse  iiber  die  Hardware  der  ST-Computer  in 
einem  Buch  mit  konzentrierten  Infos  iiber  die  Betriebssystemsoftware  zusammenzufassen, 
und  so  wurde  das  ATARI  ST  Profibuch  (Idee:  Julian  Reschke)  “geboren”. 

Nachdem  Atari  nun  im  Herbst  ’90  mit  der  neuen  Reehnergeneration  TT  auf  dem  Markt 
erschien,  wurde  natiirlich  auch  eine  Uberarbeitung  des  “Profibuchs”  erforderlich.  Wobei  wir 
aber  ganz  schnell  zu  dem  Ergebnis  kamen,  daB  es  mit  einigen  weiteren  Anhangen  nicht  getan 
sein  wiirde.  Also  muBte  ein  komplettes,  neues  Buch  her,  mit  natiirlich  bereits  im  ST  Profibuch 
enthaltenen  Infos,  aber  eben  auch  einer  ganzen  Menge  an  neuen  Daten  iiber  den  TT/STE. 
(Wenn  wir  noch  lange  warten,  miissen  wir  den  Umfang  des  Buches  noch  weiter  “aufblasen”, 
um  auch  den  STBook  und  STPad  mit  aufzunehmen,  ganz  zu  schweigen  von  Geriichten  um 
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ein  Multitasking-TOS!  Das  ftihrt  dann  letztlich  dazu,  daB  dieses  Buch  nie  erscheint,  well 
immer  was  Neues  dazukommt.) 

Nachdem  der  TT  dann  endlich  fiir  Entwickler  lieferbar  war  (also  wurde  ich  schnell  “Ent- 
wickler”,  denn  schlieBlich  sollte  man  so  ein  Gerat,  iiber  dessen  Innenleben  man  zu  schreiben 
gedenkt,  schon  besitzen!),  wurde  auf  dem  schnellsten  Wege  ein  TT  geordert.  Dank  Herm 
Henseleits  Einsatz  (Dank,  Dank,  Dank!)  von  Atari-Deutschland  kam  “mein”  Exemplar  auch 
sehr  schnell.  Karton  aufgemacht,  und  “Uberraschung!”:  Es  war  scheinbar  ein  Bausatz,  denn 
alle  Komponenten  (ST-RAM-Erweiterung,  FAST-RAM  usw.)  waren  separat  geliefert  wor- 
den.  Der  nette  Kommentar  von  Herm  Henseleit  dazu:  “Sie  wollen  ja  das  “Ding”  sowieso  aus- 
einandemehmen!  Wir  hatten  es  hier  im  Dauertest  und  haben  es,  da  Sie  es  ja  schnell  haben 
wollten,  sofort  zerlegt  versendet.” 

Aber  nun  genug  der  Historie  und  Philosophiererei!  Ein  besonders  groBes  Dankeschon  geht 
natiirlich  noch  an  meine  Frau  Marianne.  Sie  hat  es  nicht  immer  leicht  gehabt,  mich  aus  dem 
Innenleben  der  Rechner  und  Peripherie  und  dem  Gewirr  von  MeBleitungen  von  Oszilloskop 
und  Logikanalyzer  (Originalton:  “Mein  Gott,  hoffentlich  kriegst  du  den  (gemeint  war  der 
zerlegte  ST)  noch  einmal  wieder  zusammen !  ”)  herauszulosen.  Verbunden  ist  damit  auch  eine 
Bitte  urn  Entschuldigung  an  sie  und  den  Rest  der  Familie  (inzwischen  drei  prachtige  Ausgaben 
“selbstgemachter  Hardware”  mannlichen  Geschlechts,  acht  Monate,  acht  und  zehn  Jahre  alt 
und  mit  gesunder  “natiirlicher  Intelligenz”  ausgestattet.  Der  Jiingste  heiBt  iibrigens  auch  Ju¬ 
lian,  mal  sehen,  ob  es  was  ntitzt!)  fur  die  viele  Zeit,  die  ich  statt  mit  ihnen  an  den  Computem 
(vor  alien  Dingen  bei  der  Erstellung  des  Buches)  verbracht  habe.  Nachdem  das  Manuskript 
des  Hard  ware-Teils  nun  fertig  ist,  verspreche  ich,  mich  mehr  urn  sie  (die  Familie)  zu  kilmmem 
(hm,  da  war  doch  noch  was  von  wegen  Harddisktreiber  usw...). 

Ein  weiteres  Dankeschon  an  Herm  Henseleit  und  Herm  Jurkat  von  Atari-Deutschland,  die  fiir 
mich  immer  ein  offenes  Ohr  und  reichlich  Informationen  hatten. 


Dietmar  Rabich 

Als  im  Jahre  1962  eine  Computergeneration  begann,  erblickte  auch  ich  das  Licht  der  Welt. 
Nach  den  vielen  Jahren  der  Schule  und  einem  Studium  der  Mathematik  und  Physik  gehe  ich 
seit  1989  als  Diplom-Mathematiker  dem  Beruf  eines  Programmierers  in  einem  groBen  Kon- 
zem  in  Dortmund  nach. 

Der  erste  Kontakt  mit  einem  Computer  ergab  sich  im  neunten  Schuljahr.  Auf  einem  Wang 
2200  mit  4  (vier)  Kilobyte  Hauptspeicher,  einer  Schreibmaschine  als  Ausgabemedium  und 
einem  eingebauten  Kassettenrecorder  als  Massenspeicher  wurde  eifrig  mit  der  ganzen  Klasse 
BASIC  gelemt.  Und,  wie  sollte  es  anders  sein,  gerade  dieser  Rechner  iibte  einen  so  starken 
Reiz  auf  mich  aus,  daB  ich  mich  nicht  mehr  davon  losen  konnte. 
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Dem  Wang  folgte  daheim  ein  vergleichsweise  komfortabler  Rechner:  ein  CBM  3032  mit  32 
KByte  RAM  und  zwei  Diskettenlaufwerken.  Auch  hier  hieB  die  Stammprogrammiersprache 
BASIC. 

1983  kamen  dann  mit  dem  Studium  andere  Programmiersprachen  hinzu  (Pascal,  ForTran  77, 
ForTran  200,  PL/I,  ...).  Die  Kenntnisse  konnten  jedoch  nicht  auf  den  heimischen  Rechner 
ubertragen  werden,  also  war  eine  Vertiefung  der  Kenntnisse  nicht  moglich. 

In  der  Erwachsenenbildung  war  ich  regelmaBig  als  Kursleiter  tatig.  Unterrichtet  wurde  fast 
ausschlieBlich  BASIC  auf  Apple  He-  Oder  Toshiba  1500-Rechnem.  Von  1989  an  bot  ich  nur 
noch  kleine  Kurse  an. 

Das  Jahr  1986  brachte  mir  endlich  einen  komfortablen,  preisgunstigen  Rechner:  den  Atari  ST! 
Nach  einer  kurzen  Eingewohnungsphase  -  die  Maus  war  bis  dahin  ein  unbekanntes  Peri- 
pheriegerat  gewesen  -  versuchte  ich,  meinen  ersten  ST  (einen  520  ST+)  erst  noch  in  BASIC 
zu  programmieren,  was  ich  aber  wegen  der  bekannten  Qualitaten  des  damaligen  BASIC 
schnell  auf  gab...  Ich  wechselte  zu  dem  CCD-Pascal-Compiler.  Der  alte  CBM  geriet  mit  der 
Begeisterung  fur  den  ST  schnell  in  Vergessenheit. 

Da  neben  dem  BASIC  noch  ein  LOGO  ausgeliefert  wurde,  ergab  sich  die  Gelegenheit,  auch 
noch  diese  Programmiersprache  zu  erlemen.  Doch  trotz  uberaus  interessanter  Details  konnte 
sich  LOGO  keinen  Platz  als  Leib-  und  Magenprogrammiersprache  ergattem.  Der  Interpreter 
war  doch  zu  wenig  leistungsfahig. 

Die  Jahre  gingen  ins  Land,  der  520  ST+  wich  einem  MEGA  ST2  mit  Harddisk,  und  diesen 
erganzt  mittlerweile  ein  TT030/6.  Pascal  muBte  Modula-2  weichen  und  Modula-2  wieder  C, 
so  daB  ich  heute  fast  nur  noch  in  C  programmiere  und  entwickle.  C  zeigte  sich  als  zuverlassig, 
mit  alien  Eigenschaften  einer  modemen  Programmiersprache  und  guter  Code-Erzeugung  aus- 
geriistet. 

Uber  die  Jahre  erschienen  auch  einige  Programme:  die  Mathematik-Bibliothek  MATHLIB 
bei  Creative  Computer  Design,  das  Disk-Utility  und  der  SIGNUM! -Manager  bei  Application 
Systems  Heidelberg  sowie  ein  paar  kleine  Utilities.  Weitere  Programme  -  zumeist  Utilities 
wie  DISKINFO  -  wurden  als  Sharewareprogramme  realisiert  und  auch  so  vertrieben.  Wenn 
der  ST  oder  der  TT  gerade  mal  nicht  zum  Programmieren  herhalten  miissen,  stehen  sie  fiir 
Textverarbeitungszwecke  Oder  ein  gutes  Spiel  bereit. 

An  dieser  Stelle  mochte  ich  mich  bei  alien  bedanken,  die  mich  unterstiitzt  haben  und  mir  das 
Hobby  und  den  Beruf,  der  in  die  gleiche  Richtung  geht  -  jedoch  keine  Atari  ST/TT- 
Programmierung,  sondem  eher  Anwendungsprogrammierung  unter  Betriebssystem  OS/2  und 
dem  GroBrechnerbetriebssystem  MVS  -,  ermoglicht  haben. 
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Ein  besonders  herzliches  Dankeschon  moehte  ich  auch  an  meine  geduldigeFrau  Heike  rich- 
ten,  die  mich  nur  allzu  oft  am  Rechner  vorfindet,  standig  fur  mich  Korrektur  liest  und  immer 
Verstandnis  fiir  meine  zeitraubende  Beschaftigung  zeigt, 

Julian  F.  Reschke 

Geboren  1965  in  Bremen,  war  ich  noch  gerade  rechtzeitig  dabei,  um  den  Beginn  der  Compu¬ 
ter-Revolution  im  Heimbereich  mitzuerleben.  Nachdem  programmierbare  Taschenrechner 
(wer  erinnert  sich  noch  an  das  HI-LO-Game  auf  dem  TI 57?)  ihren  ersten  Reiz  verloren  hatten, 
muBte  ein  “richtiger”  Computer  her.  Es  machten  aber  nicht  etwa  ein  Tandy,  ein  Apple  oder 
ei  n  AIM  das  Rennen,  sondem  es  war  ein  Sinclair  ZX8 1 ,  den  man  zum  Schleuderpreis  von  648 
Mark  mit  sage  und  schreibe  1 6  KByte  RAM  bekam.  Das  war  im  Herbst  1981.  Doch  schon  ein 
knappes  halbes  Jahr  spater  hatte  die  Computeszene  ihren  neuen  Star:  den  Atari  800.  Mit  256 
Farben,  vier  Tonkanalen,  einem  vemiinftigen  Betriebssystem  und-  natiirlich  -  phantastischen 
Spielen  (Ballblazer-Fans,  hort  Ihr  mich?)  war  der  Heimcomputer  von  heute  geboren,  DaB  er 
mit  48  KByte  RAM  und  einem  Diskettenlaufwerk  mit  90  KByte  Speicherkapazitat  die  unge- 
heure  Summe  von  3200  Mark  kostete,  konnte  mich  nur  kurz  aufhalten, 

Verschiedene  Programme  wurden  fertiggestellt  und  mit  unterschiedlichem  Erfolg  verkauft 
(“HIGHWAY  DUEL”,  “NADRAL”  und  “MEMO-BOX”).  Letztes  Projekt  war  das  “ATARI 
Profibuch”,  in  das  ich  meine  langjahrigen  Erfahrungen  mit  dieser  Rechnergeneration  ein- 
flieBen  lieB, 

Zum  passenden  Zeitpunkt  betrat  der  Atari  ST  die  Szene  -  nachdem  die  8-Bitter  von  Atari  aus- 
gelotet  waren,  gab  es  wieder  viel  zu  entdecken.  Wegen  meines  Studiums  der  Mathematik  und 
Informatik  an  der  Westfalischen  Wilhelms-Universitat  Munster  mufiten  die  Erkundungsreisen 
in  die  Tiefen  des  ST  jedoch  in  erster  Linie  in  den  Semesterferien  stattfinden.  Doch  im  Herbst 
1 987  war  es  dann  soweit-  mit  dem  “ATARI  ST  Profibuch”  erschien  gewissermaBen  der  Urahn 
des  nun  vorliegenden  Buchs. 

Seit  Januar  1988  erscheint  im  “ST-Magazin”  eine  monatliche  Kolumne,  in  der  ich  iibcr  die 
neuesten  Entwicklungen  bei  der  TOS-Programmierung  berichte.  Dort  werden  auch  Korrek- 
turen  und  Erganzungen  zu  diesem  Werk  zuerst  erscheinen. 

Neben  vielerlei  kleinen  Hilfsprogrammen  (wie  “BigScreen”,  siehe  Anhang)  entstanden  einige 
Libraries  (wie  die  “FlyDials”)  sowie  die  Festplattensoftware  “SCSI-Tool”  (Hard  &  Soft)  und 
etliche  Neuauflagen  des  “ATARI  ST  Profibuchs”.  Als  Haupt-Entwicklungssprache  findet 
ANSI-C  Verwendung  -  keine  andere  fiir  TOS  erhaltliche  Hochsprache  ist  vergleichbar  ausge- 
reift  und  verfugt  iiber  ebenso  umfangreiche  wie  standardisierte  Bibliotheken  -  sehr  wichtig 
bei  Softwareportierungen.  Assembler  zu  verstehen  bleibt  bei  der  Fehlersuche  dennoch  niitz- 
lich. 
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Mittlerweile  steht  ein  TT030/6  mit  GroBbildschirm  auf  dem  Tisch  -  Arbeitsgeschwindigkeit 
und  Bildschirmformat  sind  eine  Riesenerleichterung  gegeniiber  Mheren  Tagen. 

Ich  bedanke  mich  bei  alien  denen,  die  ich  durch  das  gemeinsame  Hobby  kennengelemt  habe 
und  die  mich  mit  ihrem  Know-how  unterstiitzt  haben.  Stellvertretend  ftir  viele  seien  da  nur 
Amd  BeiBner,  Stefan  Eissing  und  Gereon  Steffens  genannt.  Auch  alle  Kollegen  “vom  Fach” 
und  die  Atari-Mitarbeiter  in  Raunheim  (Normen  Kowalewski  und  seine  Vorganger)  und  Sun¬ 
nyvale  (Leonard  Tramiel,  Bill  Rehbock,  Allan  Pratt,  Ken  Badertscher  und  Mike  Fulton)  diir- 
fen  sich  angesprochen  fiihlen.  Ebenso  ein  Hallo  an  die  Redaktion  des  “ST-Magazins”,  die  sich 
Monat  fur  Monat  mit  meiner  “schweren  Kost”  beschaftigen  darf. 

SchlieSlich  noch  ein  GmB  an  meine  Freunde  und  Kommilitonen,  die  mich  oft  genug  vom  hei- 
mischen  Bildschirm  losgeeist  haben,  und  ebenso  an  die  Besatzung  der  Informatik  der  WWU, 
die  ungeduldig  auf  die  Ergebnisse  gewisser  objektorientierter  Forschungen  wartet. 
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Programmiersprachen 

Die  folgenden  Kapitel  dokumentieren  das  “Application  Programming  Interface”  (API)  von 
TOS.  Fur  fast  alle  Funktionen  ist  der  entsprechende  ANSI-C-Prototyp  (also  die  Funk- 
tionsdeklaration)  angegeben  -  meistens,  aber  nicht  immer  in  Ubereinstimmung  mit  den  mit 
“Turbo  C”  mitgelieferten  Bibliotheken.  Anderungen  haben  wir  genau  dann  vorgenommen, 
wenn  die  vorliegenden  Bindings  entweder  falsch  oder  zumindest  “ungliicklich”  abgefafit 
waren. 

Naturlich  ist  durch  die  Angabe  einer  C-Funktionsdeklaration  noch  lange  nicht  die  Parame- 
teriibergabe  geklart.  Daher  finden  Sie  bei  den  BIOS-,  XBIOS-  und  GEMDOS-Funktionen 
zusatzlich  die  genaue  Stackbelegung  und  bei  den  GEM-Funktionen  die  Belegung  der  einzel- 
nen  Ein-  und  Ausgabefelder. 

Damit  sollte  die  Dokumentation  auch  fur  Benutzer  anderer  Hochsprachen  oder  Assembler 
moglich  sein.  Eine  Kurzeinfiihrung  in  die  C-Syntax  und  die  benutzten  Datentypen,  die  natur¬ 
lich  nur  die  all  erwich  tigs  ten  Informationen  auffiihren  kann,  finden  Sie  im  Anhang.  Wir  kon- 
nen  jedem  professionellen  Entwickler  die  Benutzung  eines  ANSI-C-Systems  nur  ans  Herz  le- 
gen! 


Schichtenmodell 

TOS  ist  ziemlich  sauber  in  mehrere  Schichten  gegliedert.  Die  folgenden  Kapitel  sind  entspre- 
chend  dieserHierarchie  aufsteigend  sortiert.  EinigeFaustregeln  zur  sauberenProgrammierung 
lauten: 

1 .  Niemals  fur  eine  Aufgabe  Aufrufe  verschiedener  Betriebssystemschichten  vermischen. 
Beispiel:  In  einem  GEM-Programm  fragt  man  Maus  und  Tastatur  per  AES,  nicht  etwa 
per  BIOS,  ab.  Alles  andere  kann  zu  Konflikten  zwischen  den  verschiedenen  Schichten 
(hier:  Tastenpufferung)  fiihren. 

2.  Niemals  von  irgendwelchen  unsicheren  Annahmen  liber  interne  Zusammenhange  zwi¬ 
schen  den  einzelnen  Schichten  ausgehen.  Beispiel:  Ein  GEMDOS-Laufwerk  kann 
sowohl  auf  einem  BIOS-  als  auch  auf  einem  Meta-DOS-Gerat  liegen.  Die  Maus  hangt 
normalerweise  am  IKBD-Chip,  muB  es  aber  nicht  (exteme  Tastaturinterfaces,  neue 
Hardware  von  Atari), 


2 


ATARI  Profibuch 


3.  Immer  nach  Moglichkeit  die  hochste  Betriebssystemschicht  benutzen. 

Beispiel:  Ein  XControl-Modul  kann  die  Landerkennung  aus  dem  Betriebssystemheader 
extrahieren  -  besser  aber  ist  es,  dazu  die  entsprechende  XControl-Datenstruktur  zu 
bemiihen. 


Dokumentiert  Oder  nicht  dokumentiert? 

Wir  haben  uns  bemiiht,  immer  moglichst  prazise  das  wiederzugeben,  was  die  Origmaldokumen- 
tation  von  Atari  beschreibt,  Leider  war  das  nicht  immer  moglich: 

-  Manche  Funktionen  sind  in  der  Originaldokumentation  offensichtlich  falsch  beschrie- 
ben;  einige  Dinge  sind  in  verschiedenen  Originaltexten  widerspriichlich  dokumentiert. 

Manche  Funktionen  sind  dort  entweder  gar  nicht  oder  unvollstandig  beschrieben;  in  sol- 
chen  Fallen  haben  wir  unsere  eigenen  Erkenntnisse  wiedergegeben  und  diese  als  solche 
gekennzeichnet. 

Fur  die  Korrektheit  unserer  Beschreibungen  konnen  wir  nattirlich  keinerlei  Gewahr  iibemeh- 
men.  Femer  kann  ein  Buch  naturlich  niemals  genauso  aktuell  wie  die  offizielle  Dokumenta- 
tion  des  Herstellers  sein.  Jeder  professionelle  Softwareentwickler  sollte  sich  daher  auch  bei 
der  entsprechenden  Atari-Niederlassung  als  Entwickler  registrieren  lassen,  um  neben  diesem 
Buch  auch  die  Originaldokumentation  und  den  Entwicklersupport  in  Anspruch  nehmen  zu 
konnen. 

Kiinftige  Weiterentwicklungen  werden  entweder  in  ein  iiberarbeitetes  “Profibuch”  oder  einen 
Erganzungsband  Eingang  finden.  Stets  aktuelle  Informationen  zu  diesem  Thema  finden  Sie 
in  den  diversen  Fachzeitschriflen,  insbesondere  in  der  monatlichen  Kolumne  “Atarium”  im 
“ST-Magazin”. 


Teill 
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Kapitel  1:  BIOS  und  XBIOS 

Einleitung 

BIOS  und  XBIOS  sind  enge  Verwandte.  Sie  sind  in  der  gleichen  “Betriebssystemschicht” 
angeordnet  und  teilen  sich  sogar  denselben  TRAP-Dispatcher. 

Das  BIOS  (“Basic  Input/Output  System”)  ist  das  Bindeglied  zwischen  GEMDOS  und 
Hardware  (im  “Hitchhiker’s  Guide  to  the  BIOS”  ist  das  entsprechende  Kapitel  nicht  umsonst 
“GEMDOS  BIOS  Calls”  betitelt).  Dazu  stellt  es  Funktionen  zur  zeichenorientierten  und 
blockorientierten  Kommunikation,  zur  Speicherverwaltung  und  fur  den  Zugriff  auf  System- 
vektoren  zu  Verfiigung.  Bis  auf  einige  wenige  Ausnahmen  (bei  der  Behandlung  der  Zeitfunk- 
tionen)  greift  GEMDOS  ausnahmslos  auf  BIOS-Funktionen  zu. 

Insgesamt  gilt  die  Faustregel:  das  BIOS  ist  fur  all  das  verantwortlich,  was  unterhalb  der  Ebene 
von  GEMDOS  und  GEM  stattfindet  und  nichts  mit  dem  XBIOS  zu  tun  hat  -  beispielsweise 
auch  die  Systeminitialisierung. 

Das  XBIOS  (“extended  BIOS”)  hingegen  enthalt  eine  groBe  Anzahl  hardwareabhangiger 
Erweiterungen-meist  vollstandig  unabhangig  von  anderen  Betriebssystemschichten.  Faustregel 
sollte  sein:  XBIOS-Funktionen  moglichst  nur  dann  benutzen,  wenn  es  keine  Funktion  einer 
“hoheren”  Betriebssystemschicht  gibt,  die  man  statt  dessen  benutzen  konnte. 

-  Viele  der  Funktionen  dienen  der  Konfiguration  von  Hardware  oder  allerunterster 
Betriebssystem-Schichten.  Gute  Beispiele  dafiir  sind  “CursconfO”  und  “SetprtO”.  Ein- 
stellungen  dieser  Art  werden  normalerweise  vom  Kontrollfeld  vorgenommen,  in  eige- 
nen  Programmen  sollte  man  imrner  nur  die  Einstellungen  abfragen. 

Funktionen  wie  “KbdvbaseO”  sind  eigentlich  nur  fiir  residente  Programme  interessant. 

-  Eine  Funktion,  die  man  in  Anwendungsprogrammen  braucht,  ist  “KeytblO”.  Anders  ist 
es  nicht  moglich,  landerunabhangig  Tastatur-Scancodes  auszuwerten. 

-  Die  Grafikfunktionen  sind  Paradebeispiele  fur  Funktionen,  die  man  nicht  in  Anwen¬ 
dungsprogrammen  einsetzen  sollte.  Grand:  Sie  sind  nur  fiir  die  ST-,  STE-  und  TT- 
Grafikhardware  definiert  und  funktionieren  im  allgemeinen  fiir  Grafikkarten  nicht  oder 
nureingeschrankt.Das  VDI-KonzepterlaubtprinzipiellGrafikkarten,derenBildspeicher 
fiir  die  CPU  iiberhaupt  nicht  zuganglich  ist.  Auch  die  Farbpaletten-Funktionen  des 
XBIOS  sind  nur  sehreingeschranktfiir“farbigere”Grafikkarteneinsetzbar.  Anwendungs- 
programme  sollten  daher  ausschliefilich  GEM-Funktionen  einsetzen. 
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Zeichenorientierte  Funktionen 

Welche  Kanale  gibt  es? 

Das  BIOS  kennt  von  Haus  aus  folgende  sechs  Ein-  und  Ausgabekanale: 


Kanal 

Name 

Belegung 

0 

PRT 

Parallele  Schnittstelle 

1 

AUX 

Serielle  Schnittstelle 

2 

CON 

Konsole  (Bildschirm  mit  VT52-Sequenzen) 

3 

MIDI 

MIDI-Schnittstelle 

4 

IKBD 

Intelligent  Keyboard  Processor 

5 

RAWCON 

Konsole  (ohne  Steuersequenzen) 

Auf  neueren  TOS-Versionen  konnen  iiber  die  XBIOS-Funktion  “BconmapO”  (siehe  unten) 
weitere  Kanale  installiert  werden.  Zur  Bedienung  dieser  Kanale  bietet  BIOS  vier  Ein-  und 
Ausgabefunktionen : 


Name 

Funktion 

Bconstat() 

Status  des  Eingabegerats  feststellen 

Bconin() 

Zeichen  einlesen 

Bconout() 

Zeichen  ausgeben 

Bcostat() 

Status  des  Ausgabegerats  feststellen 

Vorsicht:  fiir  die  Funktion  “BcostatO”  sind  die  Kanale  3  und  4  vertauscht. 


Installation  eigener  Treiber 

Seit  TOS  1 .02  benutzt  das  BIOS  eine  dokumentierte  Tabelle  mit  Zeigem  auf  die  einzelnen 
Funktionen.  Insgesamt  gibt  es  Vektoren  fiir  acht  Kanale,  doch  nur  sechs  von  ilinen  konnen 
benutzt  werden: 


Adresse 

Name 

Belegung 

$5  IE 

xconstat 

Acht  Zeiger  auf  Eingabestatus-Routinen 

$53E 

xconin 

Acht  Zeiger  auf  Eingabe-Routinen 

$55E 

xcostat 

Acht  Zeiger  auf  Ausgabestatus-Routinen 

$57E 

xconout 

Acht  Zeiger  auf  Ausgabe-Routinen 

BIOS  und  XBIOS 
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Wer  eigene  Routinen  installieren  mochte,  sollte  folgendes  beachten: 

Die  Funktionen  werden  mit  den  gleichen  Parametem  wie  die  entsprechenden  BIOS-Funktio- 
nen  aufgerufen  (nur  BIOS-Funktionsnummer  und  Kanalnummer  fehlen).  Der  Retum-Wert 
wird  in  Register  DO  zuriickgeliefert.  Alle  Register  dlirfen  benutzt  werden,  da  der  BIOS- 
Dispatcher  selbst  fur  das  Retten  und  Wiederherstellen  der  “garantierten”  Register  sorgt. 

Ab  TOS  2.00  werden  die  Geratenummem  uber  5  (“RAWCON:”)  mittels  “BconmapO” 
verwaltet.  Daher  konnen  die  ffeien  Eintrage  in  den  Systemvektoren  -  wenn  iiberhaupt  -  nur 
unter  alteren  TOS-Versionen  benutzt  werden. 


Anmerkungen  zu  CON:  und  RAWCON: 

Der  VT52-EmuIator 

Beim  urspriinglichen  Entwurf  des  ST  hat  Atari  deutlich  in  Richtung  “Digital  Equipment” 
geschielt  und  einige  Anleihen  beim  verbreiteten  Terminal  “VT52”  genommen.  Davon  ist 
nicht  nur  die  Tastatur,  sondem  auch  die  fur  “CON:”  benutzte  Terminalemulation  betroffen. 

Der  grofie  Vorteil  liegt  darin,  daB  genau  diese  Steuersequenzen  auch  auf  vielen  anderen 
Systemen  benutzt  werden.  Gerade  beim  Anruf  von  Mailboxen  mit  Terminalemulation  macht 
sich  das  positiv  bemerkbar. 

Alle  Steuersequenzen  werden  durch  ESC  (also  den  ASCH-Wert  27)  eingeleitet.  Daher  nennt 
man  sie  auch  (genau  wiebei  Druckem)  tiblicherweiseEscape-Sequenzen.  Dem  ESC-Zeichen 
folgen  eines  Oder  auch  mehrere  Zeichen,  die  dann  die  eigentliche  Funktion  auslosen. 

Cursor  up  (VT52  ESC  A) 

Bewegt  den  Cursor  um  eine  Zeile  nach  oben.  War  der  Cursor  bereits  in  der  obersten  Zeile, 
passiert  nichts. 

Cursor  down  (VT52  ESC  B) 

Bewegt  den  Cursor  um  eine  Zeile  tiefer.  War  der  Cursor  bereits  in  der  untersten  Zeile,  passiert 
nichts. 

Cursor  forward  (VT52  ESC  C) 

Be  wegt  den  Cursor  um  eine  Position  nach  rechts,  hochstens  aberbis  zum  rechten  Bildschirmrand. 


Cursor  backward  (VT52  ESC  D) 

Bewegt  den  Cursor  um  eine  Spalte  nach  links,  hochstens  aber  bis  zum  linken  B  ildschirmrand. 
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Clear  screen  (and  home  cursor)  (VT52  ESC  E) 

Loscht  den  gesamten  Bildschirm  und  setzt  den  Cursor  in  die  linke  obere  Ecke. 

Home  cursor  (VT52  ESC  H) 

Setzt  den  Cursor  in  die  linke  obere  Ecke. 

Reverse  index  (VT52  ESC  I) 

Bewegt  den  Cursor  um  eine  Zeile  nach  oben.  War  der  Cursor  bereits  in  der  obersten  Zeile,  wird 
oben  eine  Leerzeile  eingefiigt  und  der  Rest  des  Bildschirms  um  eine  Zeile  nach  unten 
verschoben. 

Erase  to  end  of  page  (VT52  ESC  J) 

Loscht  ab  der  aktuellen  Cursorposition  (einschlieBlich)  den  gesamten  Bildschirm. 

Clear  to  end  of  line  (VT52  ESC  K) 

Loscht  ab  der  aktuellen  Cursorposition  bis  zum  Ende  der  Zeile. 

Insert  line  (VT52  ESC  L) 

Fiigt  an  der  aktuellen  Cursorposition  eine  leere  Zeile  ein.  Der  Cursor  wird  an  den  Anfang  dieser 
Zeile  gesetzt  und  der  Rest  des  Bildschirms  um  eine  Zeile  nach  unten  verschoben. 

Delete  line  (VT52  ESC  M) 

Loscht  die  aktuelle  Zeile  und  verschiebt  den  Rest  des  Bildschirms  um  eine  Zeile  nach  oben. 
Dabei  entsteht  am  unteren  Rand  eine  leere  Zeile.  Der  Cursor  bleibt  in  der  gleichen  Zeile  und 
wird  an  den  linken  Rand  bewegt. 

Position  cursor  (VT52  ESC  Y) 

Positioniert  den  Cursor  frei  auf  dem  Bildschirm.  Dazu  iibergibt  man  zusatzlich  die  gewunschte 
Y-  und  X-Position  (jeweils  um  32  erhoht). 

Set  foreground  color  (VT52  ESC  b) 

Setzt  die  Schriftfarbe.  Dazu  iibergibt  man  als  zusatzlichen  Wert  die  gewunschte  Farbnummer 
(Anzahl  der  Farben  vom  Bildschirmmodus  abhangig)  als  Byte  (von  dem  nur  die  unteren  vier 
Bits  ausgewertet  werden). 

Set  background  color  (VT52  ESC  c) 

Setzt  die  Hintergrundfarbe.  Dazu  iibergibt  man  als  zusatzlichen  Wert  die  gewunschte 
Farbnummer  (Anzahl  der  verfiigbaren  Farben  vom  Bildschirmmodus  abhangig). 

Erase  beginning  of  display  (VT52  ESC  d) 

Loscht  alle  Zeichen  zwischen  dem  Bildschirmanfang  und  der  Cursorposition. 
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Enable  cursor  (VT52  ESC  e) 

Macht  den  Cursor  sichtbar. 

Disable  cursor  (VT52  ESC  f) 

Macht  den  Cursor  unsichtbar. 

Save  cursor  position  (VTS2  ESC  j) 

Speichert  intern  die  momentane  Cursorposition. 

Restore  cursor  position  (VT52  ESC  k) 

Setzt  den  Cursor  wieder  auf  die  mittels  “Save  cursor”  gespeicherte  Position.  Die  dabei 
gesicherte  Position  wird  geloscht! 

Erase  entire  line  (VT52  ESC  l) 

Loscht  die  aktuelle  Zeile  und  setzt  den  Cursor  an  den  linken  Bildschirmrand. 

Erase  beginning  of  line  (VT52  ESC  o) 

Loscht  alle  Zeichen  zwischen  dem  Zeilenanfang  und  der  Cursorposition. 

Enter  reverse  video  mode  (VT52  ESC  p) 

Schaltet  fur  alle  folgenden  Bildschirmausgaben  auf  inverse  Schrift  (Vertauschen  von  Schrift- 
und  Hintergrundfarbe). 

Exit  reverse  video  mode  (VT52  ESC  q) 

Schaltet  wieder  auf  normale  Bildschirmdarstellung  um. 

Wrap  at  end  of  line  (VT52  ESC  v) 

In  diesem  Modus  wird  beim  Erreichen  des  Zeilenendes  automatisch  die  nachste  Zeile 
begonnen. 

Discard  at  end  of  line  (VT52  ESC  w) 

In  diesem  Modus  wird  erst  dann  eine  neue  Zeile  begonnen,  wenn  ein  “Carriage  Return”  (13) 
und  ein  “Line  Feed”  (10)  ausgegeben  werden. 

Intern  benutzt  der  VT52-Emulator  die  Systemvariablen  “conterm”  (diverse  Einstellungen), 
“con_state”  (wird  bei  der  Umschaltung  zwischen  “normalen”  Zeichen  und  Steuersequenzen 
benutzt)  und  “sav_row”  (zum  Speichern  der  Cursorposition  bei  ESC  “j”). 

Laut  “Hitchhiker’s  Guide  to  the  BIOS”  ist  allerdings  nur  die  erste  von  ihnen  offiziell 
dokumentiert! 
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Wie  groB  ist  der  Bildschirm? 

Von  einem  Programm,  das  VT52-Sequenzen  fiir  seinen  Bildschiimaufbau  benutzt,  erwartet 
man  zu  Recht,  daB  es  die  gesamte  verfiigbare  Flache  nutzt.  Doch  wie  stellt  man  fest,  wie  viele 
Zeichen  auf  den  Bildschirm  passen? 

In  der  geringen  Auflosung  des  ST  konnten  es  gerade  mal  25  *  40  sein,  wahrend  auf  dem  TT 
in  der  hohen  Auflosung  beeindruckende  60  *  1 60  Zeichen  Platz  finden.  Noch  schwieriger  wird 
es  bei  anderen  Grafikkarten  und  erst  recht  dann,  wenn  ausgefeilte  grafische  Obcrflachen  TOS- 
Programme  in  Fenstem  flexibler  GroBe  ablaufen  lassen. 

Leider  gibt  es  keine  Moglichkeit,  den  verfiigbaren  Platz  abzufragen,  ohne  die  Betriebssy  stem- 
schichten  BIOS,  XBIOS  und  GEMDOS  zu  verlassen.  Daher  sei  an  dieser  Stelle  folgender 
Vorschlag  gemacht:  falls  die  Environmentvariablen  ROWS  und  COLUMNS  existieren,  dann 
enthalten  sie  die  maximale  Zeilen-  bzw.  Spaltenzahl. 

Vorteile  dieses  Verfahrens: 

-  Es  werden  keine  undokumentierten  Betriebssystemeigenschaften  benotigt. 

-  Jede  tastaturorientierte  Shell  (und  an  deren  Anwenderkreis  wendet  sich  ja  dieser  Vor¬ 
schlag)  kann  Environmentvariablen  setzen. 

-  Das  Desktop  “Gemini”  bzw.  die  UNIX-Shell  “Mupfel”  nutzen  diese  Methode  seit 
geraumer  Zeit. 

Ausgaben  ohne  Terminalemulation 

Mit  “RAWCON:”  kann  man  alle  Zeichen  gewissennaBen  ungefiltert  auf  dem  Bildschirm 
ausgeben.  Vorteile  sinddahernichtnur  der  groBere  Zeichenvorrat(anstelle  der  Steuersequenzen), 
sondern  auch  eine  deutlich  hohere  Ausgabegeschwindigkeit  als  bei  “CON:”. 

BIOS-  und  VDI-Escapefunktionen 

Interessanterweise  benutzen  die  VDI-Escapefunktionen  des  ROM-Bildschirmtreibers  den 
gleichen  Code  und  die  gleichen  Variablen  wie  der  VT52-Emulator  des  BIOS. 

Dennoch  sollte  man  innerhalb  eines  Programms  keinesfalls  beide  Betriebssystemteile 
gemischt  aufrufen.  Der  Grund:  die  BIOS-Ausgaberoutinen  gehen  ab  TOS  1 .02  uber  Vektor- 
tabellen  und  konnen  damit  umgelenkt  werden.  Die  VT52~Escapefunktionen  hingegen  sind  ein 
Teil  des  VDI-Bildschirmtreibers  und  konnten  daher  durch  einen  anderen  Bildschirmtreiber 
ersetzt  worden  sein! 


BIOS  und  XBIOS 
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Benutzte  Systemvariablen 

Uber  “conterm”  kann  man  einige  Attribute  verstellen  (Tastenklick,  Tastenwiederholung, 
“Ping”  bei  Ausgabe  von  CTRL-G,  Riickliefern  von  Scancodes  bei  “BconinO”).  Ab  TOS  1 .06 
gibt  es  die  zwei  zusatzlichen  Vektoren  “bell_hook”  und  “kcl_hook”,  iiber  die  man  eigene 
Routinen  fur  das  “Ping”-Gerausch  und  den  Tastenklick  installieren  kann. 

Uber  den  Status  der  Umschalttasten  wird  in  einer  BlOS-internen  Variable  Buch  gefuhrt.  Ihre 
Adresse  ist  eigentlich  nur  fiir  Interruptroutinen  interessant  und  kann  mit  Hilfe  von  “_sysbase” 
ermittelt  werden.  Andere  Programme  sollten  statt  dessen  “Kbshift()”  verwenden. 


Anmerkungen  zu  PRT: 

Auswahl  parallel/seriell 

Die  BIOS -Routinen  zur  Druckerausgabe  geben  normalerweise  auf  der  parallelen  Schnittstelle 
aus.  “BconoutO”  istprinzipiell  darauf  vorbereitet,  die  Drucker-Voreinstellungen  des  XBIOS 
(“SetprtO”)  in  Hinsicht  auf  die  zu  benutzende  Schnittstelle  (parallel/seriell)  zu  beriicksichti- 
gen.  Leider  ist  die  Abfrage  in  alien  bekannten  TOS-Versionen  fehlerhaft,  so  daB  Anwendungs- 
programme  die  Einstellungen  selbstauswerten  sollten  (hinzu  kommt,  daB  “BcostatQ”  die  Ein- 
stellungen  vollig  ignoriert). 

Der  DIABI.O-Treiber 

Die  Atari-Laserdrucker  SLM  804  und  605  erfreuen  sich  aufgrund  der  hohen 
Ausgabegeschwindigkeit  und  des  giinstigen  Preises  groBer  Beliebtheit.  Zum  Lieferumfang 
gehort  der  DIABLO-Treiber,  der  sich  auf  BIOS-Ebene  installiert  und  alle  Ausgaben  auf 
“PRT:”  abfangt.  Eine  Liste  der  unterstiitzten  Escape-Sequenzen  findet  sich  im  Original- 
Handbuch,  so  daB  wir  aus  Platzgriinden  an  dieser  Stelle  auf  einen  Abdruck  verzichten. 


Anmerkungen  zu  AUX: 

Die  erweiterten  seriellen  Schnittstellen  des  TT  (und  Mega  STE)  haben  natiirlich  auch 
Softwareprobleme  aufgeworfen:  samtliche  Programme  gehen  davon  aus,  daB  BIOS-Kanal  1 
mit  der  seriellen  Schnittstelle  verbunden  ist.  Daneben  war  es  bislang  selbstverstilndlich,  daB 
man  die  vom  BIOS-Kanal  1  benutzte  Hardware  mit  “Rsconf()”  konfigurieren  kann.  Atari  hat 
das  Problem  auf  verschiedenen  Ebenen  gelost.  Zunachst  einmal  gibt  es  nun  mehr  als  die 
bisherigen  sechs  BIOS-Kanale.  Je  nach  verwendeter  Hardware  kennt  beispielsweise  das  TT- 
BIOS  die  folgenden  neuen  Gerate  (die  “erweiterten  Geratenummem”): 
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Kanal 

Belegung 

6 

ST-kompatible  serielle  Schnittstelle  (“Modem  1”) 

7 

SCO  Kanal  B  (“Modem  2”) 

8 

TTMFP-Schnittstelle  (“Seriell  1”) 

9 

SCC  Kanal  A  (“Seriell  2”) 

Nur  die  Belegung  von  Kanal  6  liegt  als  ST-kompatible  serielle  Schnittstelle  fest.  Alle  anderen 
sind  von  der  verwendeten  Hardware  abhangig  (wie  viele  es  sind,  kann  man  mit  “BconmapO” 
abfragen). 

Kanal  1  ist  nunmehr  ein  Platzhalter  fiir  “die”  serielle  Schnittstelle.  Mittels  “BconmapO”  kann 
man  ihm  irgendeine  der  erweiterten  Geratenummem  zuordnen. 

Dabei  wird  ubrigens  auch  dafiir  gesorgt,  daB  bei  der  Umschaltung  von  Geratenummer  1  die 
vier  dazugehorigen  BlOS-Systemvektoren  angepaBt  werden. 

Das  “SerieH”-Modul  des  erweiterten  Kontrollfelds  sorgt  fur  eine  entsprechende  Initialisierung. 
Programme,  die  von  den  erweiterten  Geratenummem  wissen,  konnen  natiirlich  auch  iiber  die 
BlOS-Zeichenausgaberoutinen  auf  die  neuen  Schnittstellen  zugreifen. 

Warura  “BconmapO”  nun  eine  XBIOS-  und  nicht  eine  BIOS-Funktion  ist?  Legitimerweise 
gehen  praktiseh  alle  existierenden  Programme  davon  aus,  daB  man  mit  “RsconfO”  spezielle 
Eigenschaften  von  BIOS-Kanal  1  verandem  kann. 

Das  XBIOS  sorgt  daher  nicht  nur  fiir  die  “Umlenkung”  von  Kanal  1  auf  die  passenden 
Routinen,  sondem  auch  fiir  die  Umschaltung  auf  eine  entsprechende  “Rsconf()”-Routine. 
Auch  fiir  die  Anpassung  der  “Iorec()”-Funktion  wird  gesorgt. 

“Bconmap”  verfiigt  dazu  iiber  eine  BCONMAP-Struktur,  die  entsprechende  Funktionszeiger 
fiir  die  einzelnen  Gerate  enthalt: 

typedef  struct 
{ 

WORD  (*Bconstat)  ();  /*  Funktionszeiger  */ 

LONG  (*Bconin)  (); 

LONG  (*Bcostat)  {); 

void  (*Bconout)  () ; 

ULONG  (*Rsconf )  () ; 

IOREC  *iorec; 

}  MAPTAB; 


/*  Zeiger  auf  IOREC-Struktur  */ 
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typedef  struct 
{ 

MAPTAB  *maptab;  /*  Zeiger  auf  Funktionstabelle  */ 

WORD  maptabsize;  /*  Anzahl  der  Eintrage  */ 

}  BCONMAP; 

“maptabsize”  gibt  an,  wie  viele  erweiterte  Kanale  bereits  installiert  sind.  Wenn  man  5  addiert, 
erhalt  man  die  groBte  erlaubte  Nummer  fiir  die  BlOS-Zeichenfunktionen  und  natiirlich  fiir 
“BconmapO”. 

“maptab”  zeigt  auf  ein  Feld  von  “maptabsize"  MAPTAB-Strukturen,  Jede  dieser  Strukturen 
enthalt  Zeiger  auf  die  entsprechenden  BlOS-Zeichenfunktionen,  eine  “Rsconf()”-Funktion 
und  den  IOREC  des  betreffenden  Gerats. 

Die  neue  Vielfalt  bei  den  seriellen  Schnittstellen  hat  natiirlich  einige  wichtige  Konsequenzen: 

-  Viele  der  mit  “Rsconf()”  moglichen  Einstellungen  sind  eng  mit  der  Hardware  des  MFP- 
Bausteins  verbunden.  Daher  muB  man  sich  damit  abfinden,  daB  viele  Einstellungen  nicht 
mehr  unbedingt  bei  jeder  Scbnittstelle  moglich  sind. 

-  Direkte  Folge:  Einstellungen  der  seriellen  Hardware  sollten  im  allgemeinen  spezialisier- 
ten  Konfigurationsprogrammen  wie  dem  Kontrollfeld  vorbehalten  bleiben  und  aus  den 
eigentlichen  Anwendungsprogrammen  entfemt  werden. 


Blockorientierte  Funktionen 

Einleitung 

AIs  blockorientiert  bezeichnet  man  gemeinhin  Gerate,  die  Daten  ausschlieBlich  in  groBeren 
Blocken  (meist  Sektoren  genannt)  ubertragen  konnen.  BIOS  kann  32  derartige  Gerate 
verwalten.  Dazu  stehen  folgende  Funktionen  zu  Verfiigung: 

Drvmap():  Liste  der  verfiigbaren  Gerate  abfragen 

Getbpb():  Informationen  iiber  das  Gerat  abfragen 

Mediach():  Medienwechselstatus  erfragen 


Rwabs(): 


Sektoren  lesen  Oder  schreiben 
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DrvmapQ:  Wie  viele  Gerate  gibt  es? 

Zur  Buchfiihrung  fiber  die  vorhandenen  Gerate  benutzt  BIOS  die  Systemvariable  “„drvbits”. 
Jedes  Bit  in  “_drvbits”  entspricht  einem  verfiigbaren  Gerat.  Wer  eigene  BIOS-Treiber 
installiert,  muB  also  das  passende  Bit  in  “_drvbits”  setzen,  urn  das  Gerat  anzumelden.  Wer  den 
Wert  nur  abfragen  will,  sollte  statt  dessen  die  BIOS-Funktion  “DrvmapO”  zu  Rate  ziehen 
(wenn  man  die  Wahl  hat,  sollte  man  immer  eine  Betriebssystemfunktion  der  Benutzung  einer 
Systemvariablen  vorziehen). 

Ein  gesetztes  Bit  bedeutet  natiirlich  noch  langst  nicht,  dafi  auch  Daten  gelesen  oder 
geschrieben  werden  konnen.  Die  Drive-Bits  geben  nur  dariiber  Auskunft,  fur  welche 
Geratenummem  ein  Treiber  installiert  ist.  Man  stelle  sich  vor,  es  ware  anders:  dann  miiBte  Bit 
0  in  dem  Moment  geldscht  werden,  in  dem  die  Diskette  aus  Laufwerk  A:  entfemt  wird  (das 
gleiche  gilt  natiirlich  auch  fiir  jedes  andere  wechselbare  Medium,  zum  Beispiel  fur  eine 
Wechselplatte). 

Und  noch  ein  wichtiger  Hinweis:  BIOS-Gerate  und  GEMDOS-Laufwerke  miissen  nicht  das 
gleiche  sein.  Das  erkennt  man  schon  daran,  daB  BIOS  zur  Zeit  doppelt  so  viele  Gerate  wie 
GEMDOS  erlaubt.  Bei  Benutzung  von  “Meta-DOS”  kann  es  auBerdem  vorkommen,  daB 
GEMDOS  Gerate  nicht  iiber  BIOS,  sondem  liber  einen  von  “Meta-DOS”  installierten  Treiber 
ansteuert.  Die  Liste  der  fiir  GEMDOS  verfiigbaren  Gerate  sollte  man  daher  besser  mit 
“Dsetdrv()”  abfragen! 


Getbpb():  Informationen  iiber  ein  Gerat  ermitteln 

“GetbpbO”  liefert  eine  Gerateinformationsstruktur  folgender  Form: 


typedef  struct 
{ 


WORD 

recsiz; 

/* 

WORD 

clsiz; 

/* 

WORD 

clsizb; 

/* 

WORD 

rdlen; 

/* 

WORD 

fsiz; 

/* 

WORD 

fatrec; 

/* 

WORD 

datrec; 

/* 

WORD 

numcl  ; 

/* 

WORD 

bflags; 

/* 

Bytes  pro  Sektor  */ 

Sektoren  pro  Cluster  (Einheit)  */ 

Bytes  pro  Cluster  */ 

Lange  d.  Wurzelverzeichnisses  in  Sektoren*/ 
Lange  des  File  Allocation  Table  (FAT)  */ 
Startsektor  der  zweiten  FAT  */ 

Sektornummer  des  ersten  freien  Clusters  */ 
Gesamtzahl  der  Cluster  auf  dem  Medium  */ 
Bitvektor,  zur  Zeit  nur  Bit  0  belegt: 

0  (12-Bit-FAT) ,  1  (16-Bit -FAT)  */ 


}  BPB; 
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Eigentlich  wiirde  man  erwarten,  daR  sich  BIOS  an  dieser  Stelle  nur  fur  die  Anzahl  der  Sektoren 
und  ihre  GroRe  in  Bytes  interessiert.  Wie  man  aber  sieht,  sind  schon  alle  fiir  das  GEMDOS- 
Dateisystem  interessanten  Informationen  eingetragen.  Wie  pafit  das  zur  sonst  so  einleuchten- 
den  Aufteilung  in  “hohere”  und  “niedrigere”  Betriebssystemschichten? 

Die  hier  zuriickgelieferten  Informationen  werden  bei  praktisch  alien  Medien  aus  dem 
Bootsektor  (Sektor  0)  ermittelt,  der  eben  auch  schon  Informationen  iiber  die  logischen 
Strukturen  enthdlt.  GEMDOS  selbst  braucht  sich  damit  nicht  in  die  Niederungen  von 
Bootsektoren  und  ahnlichem  Kram  herabzubewegen.  Weitere  Informationen  zur  BPB- 
Struktur  finden  Sie  konsequenterweise  in  der  Einfiihrung  zum  GEMDOS-Dateisystem. 

Bedeutet  dies,  daR  BIOS  nur  Gerate  mit  GEMDOS-Dateisystem  bedienen  kann?  Keinesfalls! 
Hauptsache  ist  nur,  daR  im  BPB  alle  Felder  mit  sinnvollen  Werten  besetzt  sind.  Die 
Gesamtzahl  der  Sektoren  kann  man  daraus  dann  selbst  berechnen  und  fortan  per  “Rwabs()” 
auf  das  Gerat  zugreifen: 

/*  Anzahl  der  verftigbaren  Sektoren  eines  BIOS-Gerats  feststellen. 
Return-Wert  ist  entweder  die  Anzahl  Oder  im  Fehlerfall  0  */ 

LONG  SecCount  (WORD  device) 

{ 

BPB  *B  =  Getbpb  (device) ; 
if  (!B)  /*  Fehler?  */ 

return  0L; 

else 

return  B->datrec  +  (LONG) B->numcl  *  B->clsiz; 

1 


Mediach():  Medienwechselstatus  erfragen 

Das  BIOS  kommt  auch  mit  wechselbaren  Medien  zurecht.  Dazu  gibt  es  einerseits  definierte 
Fehlermeldungen,  die  ein  Treiber  zuriickliefem  darf.  Andererseits  gibt  es  auch  die  Funktion 
“MediachO”,  mit  der  man  sich  explizit  iiber  den  Status  des  Mediums  informieren  kann. 

Da  aus  technischen  Griinden  nicht  bei  alien  Geratetypen  eine  sichere  Auskunft  moglich  ist, 
gibt  es  auch  fiir  “kann  sein”  einen  definierten  Retum-Wert. 

Vorsicht  mit  defekten  Diskettenlaufwerken  oder  nicht  einwandfrei  funktionierenden 
Wechselplattentreibern:  GEMDOS  ist  absolut  darauf  angewiesen,  daR  die  Medienwechsel- 
erkennung  funktioniert.  Anderenfalls  ist  es  sehr  wahrscheinlich,  daR  firuher  oder  spater 
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Verwaltungsinformationen  (FAT,  Verzeichnisse)  auf  das  falsche  Medium  geschrieben 
werden! 


Rwabs():  Sektoren  lesen  und  schreiben 

Uber  diese  Funktion  werden  alle  Lese-  und  Schreibzugriffe  abgewickelt.  Fiir  zum  AHDI  3.0 
kompatible  Festplattentreiber  wurde  die  Funktionsdefinition  in  Hinsicht  auf  Retries  (Wieder- 
holungen  im  Fehlerfall)  und  auf  den  direkten  Plattenzugriff  erweitert. 


Installation  eigener  Treiber 

Die  Installation  eigener  BIOS -Treiber  ist  sehr  einfach,  da  es  fiir  die  drei  Ietztgenannten 
Funktionen  Systemvektoren  gibt.  Ein  neuer  Treiber  muB  also  nur  einen  entsprechenden 
Eintrag  in  der  Systemvariable  “_drvbits”  vornehmen  und  sich  in  die  Vektoren  “hdv_rw”, 
“hdv_mediach”  und  “hdv_bpb”  einklinken.  Da  man  sich  die  Vektoren  ja  unter  Umstanden  mit 
anderen  Treibem  teilt,  sollten  dabei  folgende  Regeln  beachtet  werden: 

1.  Es  sollte  das  XBRA-Verfahren  fiir  vektorverbiegende  Programme  benutzt  werden, 
damit  andere  Treiber  konrekt  weiterfunktionieren  (und  sich  gegebenenfalls  wieder  ent- 
femen  konnen). 

2.  Alle  Funktionen  erhalten  die  BIOS-Laufwerksnummer  als  Parameter,  und  jeder  Treiber 
sollte  hollisch  genau  darauf  aufpassen,  daB  er  sich  nicht  im  falschen  Moment  angespro- 
chen  fiihlt. 


Treiber  fiir  Diskettenlaufwerke 

Einleitung 

Nach  Systemstart  kennt  das  BIOS  zunachst  nur  Funktionen  fiir  die  Diskettenlaufwerke, 
Wahrend  des  Bootvorgangs  wird  versucht,  beide  Laufwerke  anzusprechen.  Das  Ergebnis  - 
die  Anzahl  der  angeschlossenen  Laufwerke  -  kann  man  in  der  Systemvariable  “_nflops” 
finden  (intern  wird  dazu  iiber  “hdvjnit”  und  “hdv_boot”  gesprungen).  Wenn  Laufwerke 
gefunden  wurden,  tragt  BIOS  die  Drive-Bits  fiir  Gerat  0  und  Gerat  1  ein  -  ungeachtet  der 
tatsachlichen  Zahl  von  Diskettenlaufwerken.  Ist  nur  ein  Laufwerk  angeschlossen,  dann  wird 
das  zweite  Gerat  per  Software  “emuliert”  (wer  kennt  die  Meldung  “Bitte  Diskette  B:  in 
Laufwerk  A  einlegen”  nicht?). 
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Fiir  seine  Lese-  und  Schreibzugriffe  bedient  sich  der  BIOS-Diskettentreiber  der  XBIOS- 
Funktionen  “Floprd()”,  “FlopwrO”  und  gegebenenfalls  “FlopverO"  (und  zwar  dann,  wenn  die 
Systemvariable  “_fverify”  es  so  will). 


Der  Bootsektor 

Wie  man  weiB,  gibt  es  eine  groBe  Zahl  von  moglichen  Diskettenformaten.  Grand  sind  nicht 
nur  die  unterschiedlichen  technischen  Voraussetzungen  (einseitig  oder  doppelseitig,  40  oder 
80  Spuren,  5  1/4  oder  3  1/2  Zoll,  normale  oder  hohe  Schreibdichte),  sondem  auch  die 
vielfaltigen  Versuche  der  ST-Besitzer,  ihren  Diskettenlaufwerken  auch  noch  das  letzte  Byte 
zu  entlocken  (was  vor  dem  Siegeszug  der  Festplatten  auch  wirlich  ein  wichtiges  Thema  war). 

ZumGliickerweistsichdasBIOSmdieserHinsichtalssehrflexibel.NachjedemMedienwechsel 
inspiziert  es  den  Bootsektor  der  eingelegten  Diskette.  Dieser  sollte  folgende  Daten  enthalten: 


Offset 

Name 

Belegung 

$00 

BRA.S 

CPU-Sprungbefehl  zur  Bootroutine 

$02 

FILLER 

6  Fiillbytes 

$08 

SERIAL 

3  Bytes  Seriennummer 

SOB 

BPS 

Bytes  pro  Sektor 

$0D 

SPC 

Sektoren  pro  Cluster 

$0E 

RES 

Reservierte  Sektoren  am  Anfang  des  Mediums 

$10 

NFATS 

Anzahl  der  File  Allocations  Tables 

$11 

NDTRS 

Anzahl  der  Eintrage  im  Wurzelverzeichnis 

$13 

NSECTS 

Gesamtzahl  der  Sektoren 

$15 

MEDIA 

“Media”-Byte 

$16 

SPF 

FAT-GroBe  in  Sektoren 

$18 

SPT 

Track-GroBe  in  Sektoren 

$1A 

NSIDES 

Seiten  pro  Medium 

$1C 

NHID 

Versteckte  Sektoren 

Da  Sinn  und  Zweck  des  GEMDOS-Dateisystems  ist,  MS-DOS-Disketten  lesen  und  beschrei- 
ben  zu  konnen,  liegen  alle  16  Bit  groBen  Werte  im  Intel-Format  (also  High-  und  Low-Byte 
vertauscht!)  vor! 


Die  Bedeutung  der  Felder  im  einzelnen: 

BRA.S  Dieses  Feld  ist  nur  bei  auto-bootenden  Disketten  interessant  und  enthalt  dann 
einen  Branch-Befehl  zur  eigentlichen  Bootroutine. 
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FILLER  Sechs  Bytes,  die  beliebig  vergeben  und  fiir  eigene  Zwecke  benutzt  werden  diir- 

fen. 

SERIAL  Eine  24  Bit  groBe  Seriennummer.  Diese  Seriennummer  wird  bei  einem  “unsi- 
cheren”  Medienwechselstatus  begutachtet  und  sollte  nach  Moglichkeit  fur  jede 
benutzte  Diskette  verschieden  sein  (siehe  auch  “ProtobtO”). 

BPS  SektorgroBe  in  Bytes. 

SPC  Sektoren  pro  GEMDOS -Cluster. 

RES  Anzahl  der  reservierten  Sektoren  (meist  1 ,  weil  der  Bootsektor  nur  einen  Sektor 

“verbraucht”). 

NFATS  Anzahl  der  File  Allocation  Tables  (unter  GEMDOS  immer  2). 

NDIRS  Anzahl  der  Eintrage  im  Wurzelverzeichnis  (im  Gegensatz  zu  Unterverzeichnis- 

sen  ist  die  GroBe  bei  einem  Wurzelverzeichnis  ein  fester  Wert). 

NSECTS  Gesamtzahl  der  Sektoren  (inklusive  der  reservierten,  also  des  Bootsektors). 

MEDIA  “Media”-Byte.  Dieses  Byte  wird  vom  BIOS  nicht  ausgewertet,  da  sich  alle 
interessanten  Informationen  besser  auf  andere  Weise  ermitteln  lassen.  Anders 
unter  MS-DOS  (dazu  gleich  mehr). 

SPF  FAT-GroBe  in  Sektoren. 

SPT  Anzahl  der  Sektoren  pro  Spur. 

NSIDES  Anzahl  der  Seiten  (bei  Disketten  normalerweise  1  oder  2,  wer  hatte  etwas 
anderes  erwartet?). 

NHDD  Wird  vom  BIOS  ignoriert. 

Das  XBIOS  bietet  iibrigens  zum  Erzeugen  “frischer”  Bootsektoren  die  Funktion  “ProtobtO” 

an. 

Bootsektoren  bei  MS-DOS-Disketten 

Leider  ist  es  mit  der  MS-DOS-Kompatibilitat  nicht  ganz  so  einfach,  wie  man  es  sich  wiinschen 

wiirde. 
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Das  hat  verschiedene  Ursachen.  Zuerst  eintnal  hat  ein  MS-DOS-Bootsektor  eben  nur  fast  das 
gleiche  Format: 


Offset 

Belegung 

$00 

CPU-Sprungbefehl  zur  Bootroutine 

$03 

Acht  Zeichen  langer  Diskettenname 

Der  Sprungbefehl  ist  also  ein  Byte  langer  und  natiirlich  in  der  Maschinensprache  der  Intel- 
Chips  gehalten.  Leider  erwarten  die  meisten  PC-Kompatiblen  an  dieser  Stelle  tatsachlich  eine 
Intel-Befehlssequenz  und  weigem  sich  ansonsten  beharriich,  die  Diskette  zu  verarbeiten. 
Daher  sollte  man  die  ersten  drei  Bytes  stets  mit  den  Zahlen  $E9  $00  $4E  fiillen.  Folge:  MS- 
DOS-kompatible  Disketten  sind  auf  dem  Atari  nicht  bootbar. 

Nachstes  Problem:  da,  wo  das  Atari-BIOS  eine  zufallige  Seriennummer  erwartet,  steht  bei 
MS-DOS-Disketten  ein  “Diskettenname”  (etwa:  “MS-DOS  3.2”).  Die  Folge:  wenn  man 
mehrere  gleich  formatierte  Disketten  abwechselnd  benutzt,  funktioniert  die  Medienwechsel- 
erkennung  nicht  so,  wie  man  es  sich  wiinschen  wiirde. 

Kommen  wir  zum  “Media”-Byte.  Auch  dieses  Byte  entstammt  den  Urspriingen  von  MS-DOS 
und  dient  dort  dazu,  die  verschiedenen  Diskettentypen  auseinanderzuhalten.  DaB  dabei  langst 
nicht  die  gleiche  Vielfalt  wie  iiber  die  anderen  Felder  des  Bootsektors  zu  ereichen  ist,  diirfte 
klar  sein.  Dennoch  bestehen  viele  MS-DOS-Versionen  darauf,  daB  dieses  Feld  einen  “verntinf- 
tigen”  Wert  hat  (diese  Liste  erhebt  weder  Anspruch  auf  Vollstandigkeit  noch  auf  absolute 
Korrektheit): 


Wert  Bedeutung 


$F8 

$F9 

$FC 

$FD 

$FE 

$FF 


Festplatte  oder  einseitige  Diskette  mit  80  Spuren  zu  9  Sektoren  (360K) 

Doppelseitige  Diskette,  80  Spuren  zu  9  oder  mehr  Sektoren  (High-Density) 

Einseitige  Diskette,  40  Spuren  zu  9  Sektoren 

Doppelseitige  Diskette,  40  Spuren  zu  9  Sektoren 

Einseitige  Diskette,  40  Spuren  zu  8  Sektoren 

Doppelseitige  Diskette,  40  Spuren  zu  8  Sektoren 


Wer  meint,  nun  ware  MS-DOS  zufrieden,  der  irrt.  Zusatzlich  muB  man  noch  die  ersten  beiden 
(unbenutzten)  Eintrage  beider  FATs  mit  einer  Kopie  der  Media-Bytes  und  folgenden  $FFs 
fiillen  (wozu  auch  immer  das  gut  sein  soil).  Fest  steht,  daB  das  Desktop  ab  GEM  1 .4  auf 


den  Intel-Sprungbefehl  am  Anfang  des  Bootsektors  und 
die  Kopien  des  Media-Bytes  am  Beginn  der  FATs 
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achtet  und  solche  Disketten  erfahrungsgemaB  auf  PCs  erfolgreich  gelesen  und  beschrieben 
werden  konnen. 

SchluBbemerkung  zu  diesem  Thema:  das  BIOS  des  Atari  hat  normalerweise  gar  keme 
Probleme,  auf  PCs  formatierte  Disketten  zu  “verdauen”.  Im  Zweifelsfall  ist  also  die  sicherste 
Losung,  die  Diskette  dort  zu  formatieren,  wo  sie  spater  gelesen  werden  soil. 


Bootbare  Disketten 

Wozu  gibt  es  eigentlich  bootbare  Disketten?  Ware  es  nicht  viel  einfacher,  das  zu  startende 
Prograram  in  den  AUTO-Ordner  zu  kopieren? 

Die  ersten  ausgelieferten  STs  verfugten  nur  iiber  ein  64  KByte  groBes  Betriebssystem,  das 
gerade  einmal  zum  Laden  des  TOS  von  Diskette  reichte.  Diese  ROMs  batten  die  V ersionsnum- 
mer  0.00  und  wurden  von  Atari  alien  Emstes  “Das  Boot”  genannt.  Neben  einer  netten  Grafik- 
demo  enthielten  sie  die  BIOS-Funktionen  “RwabsO”  und  “GetbpbO”  und  die  XBIOS-Funk- 
tionen  “SsbrkO”  und  “FloprdO”  -gerade  eben  genug,  um  Sektoren  von  einer  Diskette  zu  lesen. 

Ohne  GEMDOS-Funktionen  kann  man  aber  nicht  auf  Dateien  zugreifen,  und  so  muB  die  dazu 
notige  Software  “gebootet”  werden. 

Andere  Anwendungen  fiir  bootbare  Disketten: 

-  Fremde  Betriebssysteme  wie  Minix,  die,  sind  sie  einmal  geladen,  die  gesamte  System- 
verwaltung  sowieso  selbst  tibemehmen. 

-  Videospiele,  die  ebensowenig  Betriebssystemroutinen  brauchen,  aber  moglichst 
unkompliziert  geladen  werden  sollen. 

-  Kleine  Hilfsprogramme,  die  moglichst  frilh  wahrend  der  Systeminitialisierung  gestartet 
werden  sollen  (bei  Anwendem  ohne  Festplatte  sehr  beliebt). 

Das  BIOS  wertet  den  Bootsektor  wahrend  der  Systeminitialisierung  aus  (und  springt  dazu 
durch  den  Vektor  “hdv_boot”).  Dazu  wird  er  in  einen  Puffer  geladen  und  dort  eine  Priifsumme 
iiber  die  256  16-Bit-Werte  berechnet.  Ist  das  Ergebnis  $1234,  dann  wird  zum  ersten  Byte  im 
Sektor  gesprungen.  Die  Adresse  des  Puffers  ist  nicht  dokumentiert,  und  so  muB  die  im 
Bootsektor  enthaltene  Routine  positionsunabhangig  programmiert  sein.  Fiir  die  Routine  im 
Bootsektor  gibt  es  nun  zwei  Moglichkeiten,  wie  sie  fortfahren  kann.  Einerseits  darf  sie  die 
Kontrolle  per  “rts”  an  das  BIOS  zuriickgeben,  das  dann  mit  dem  normalen  Startvorgang 
fortfahrt  (dann  darf  sie  allerdings  keine  Register  verandern).  Andererseits  kann  sie  die  Kon- 
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trolle  auch  ganz  selbst  iibemehmen  und  dann  beispielsweise  ein  vollig  anderes  Betriebssystem 
(oder  ein  Spiel)  laden. 

Ausfuhrbare  Bootsektoren  sind  iibrigens  nicht  nur  fur  Utilities  und  Betriebssysteme,  sondem 
auch  fur  Virenprogramme  interessant. 

Daher  sollte  man  niemals  mit  “fremden"  Disketten  im  Laufwerk  booten! 


Diskettenwechsel 

Eine  Beschreibung  des  Floppytreibers  im  BIOS  ware  natiirlich  unvollstandig,  wenn  das 
Thema  “Diskettenwechsel”  fehlen  wurde.  Im  Gegensatz  zu  anderen  Systemen  (wie  dem 
Macintosh)  bietet  die  Hardware  beim  Atari  keine  direkte  Methode,  Diskettenwechsel  zu 
registrieren.  Das  BIOS  iiberwacht  statt  dessen  im  Vertical  Blank  das  Schreibschutzsignal,  das 
bei  einem  Diskettenwechsel  kurz  unterbrochen  wird.  Das  hat  mehrere  Folgen: 

-  Bei  schreibgeschiitzten  Disketten  meldet  das  BIOS  immer  “vielleicht  gewechselt”.  Ab 
TOS  1 .04  wurde  wenigstens  eine  Plausibilitatspriifung  eingefiihrt,  die  die  Anzahl  der 
gemeldeten  Wechsel  reduziert  (dazu  merkt  sich  das  BIOS,  wann  der  letzte  Wechsel 
erfolgt  ist,  und  geht  dann  davon  aus,  dal)  innerhalb  eines  bestimmten  Zeitraums  ganz 
bestimmt  nicht  noch  ein  Diskettenwechsel  moglich  ist), 

-  FUr  unsichere  Falle  bendtigt  das  BIOS  die  Seriennummer  im  Bootsektor.  Wer  mehrere, 
gleichartig  formatierte  Disketten  mit  gleicher  Seriennummer  abwechselnd  benutzt,  muB 
also  mit  Fehlem  rechnen. 

-  Weitere  Probleme  sind  vorprogrammiert,  wenn  man  eine  Diskette  abwechselnd  in  zwei 
Rechnem  benutzt.  Szenario:  Diskette  wird  aus  Rechner  A  entnommen.  Auf  Rechner  B 
wird  eine  neue  Datei  auf  die  Diskette  geschrieben. 

AnschlieBend  wird  die  Diskette  wieder  in  das  Laufwerk  von  Rechner  A  eingelegt.  Das 
BIOS  hat  die  Unterbrechung  der  Schreibschutz-Leitung  entdeckt  und  meldet  einen 
mdglichen  Medienwechsel.  Daher  wird  die  Seriennummer  im  Bootsektor  iiberpriift  - 
und  fur  gleich  befunden!  Wenn  jetzt  Rechner  A  einen  Schreibzugriff  macht,  werden  mit 
einiger  Wahrscheinlichkeit  die  von  Rechner  B  veranderten  Verwaltungsinformationen 
wieder  mit  den  alten,  vom  GEMDOS  gepufferten  Werten  tiberschrieben. 

Abhilfe:  das  BIOS  zwingen,  die  Diskette  als  gewechselt  anzusehen  (wie  zum  Beispiel 
durch  Driicken  der  <Esc>-Taste  im  Desktop).  Die  dazu  notwendige  Funktion  ist  in  der 
Einfuhrung  zum  GEMDOS  beschrieben. 
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Formatieren  von  Disketten 

Folgende  Schritte  sind  notwendig,  urn  eine  “frisehe”  Diskette  zu  erzeugen: 

1.  Alle  Spuren  beider  Seiten  mit  “FlopfmtO”  formatieren.  Wenn  in  den  ersten  Sektoren 
Fehler  auftreten,  dann  ist  die  Diskette  unbrauchbar  (dieser  Platz  wird  fur  die 
Verwaltungsinformationen  benotigt). 

Andere  Defektsteilen  konnen  theoretisch  spater  in  der  FAT  eingetragen  werden.  Bei  den 
heutigen  Diskettenpreisen  lohnt  sich  das  aber  wegen  der  zu  erwartenden  verminderten 
Datensicherheit  wohl  nicht. 

2.  Der  von  Bootsektor,  FATs  und  Wurzelverzeichnis  belegte  Platz  mull  geloscht  werden. 
Normalerweise  sollte  es  reichen,  dazu  die  ersten  zwei  Spuren  mit  “FlopwrQ”  zu  loschen 
(also  mit  Nullen  zu  beschreiben). 

3.  Mit  der  BIOS-Funktion  “ProtobtO”  wird  ein  geeigneter  Bootsektor  erzeugt.  Filr  MS- 
DOS-kompatible  Disketten  miissen  eventuell  noch  der  Anfang  des  Bootsektors  (im 
Speicher)  und  die  Anfange  der  beiden  FATs  (auf  der  Diskette)  modifiziert  werden. 

4.  Der  Bootsektor  wird  mittels  “FlopwrO”  in  Sektor  1  auf  Spur  0,  Seite  9  geschrieben. 


Softwareunterstiitzung  fur  “High-Density” 

Fur  die  Erkennung  “High-Density”-fahiger  Floppyhardware  und  entsprechender 
Betriebssystemroutinen  kann  der  “  FDC”-Cookie  benutzt  werden.  Ihm  kann  man  entnehmen, 
was  die  hochste  vom  System  unterstiitzte  Schreibdichte  ist. 

Zur  Zeit  sind  (zusatzlich  zur  Standardhardware)  nur  Werte  fiir  “High-Density”  ( 1 )  und  “Extra- 
High-Density”  (2)  dokumentiert. 

Unterschiede  ergeben  sich  dadurch  eigentlich  nur  fiir  die  XBIOS-Funktionen  “FIoprd()’\ 
“FlopwrQ”,  “FlopftntQ”,  “FlopverQ”  und  “ProtobtO”.  Indirekt  sind  damit  natiirlich  auch  die 
BIOS-Routinen  “Rwabs()”,  “GetbpbO”  und  “MediachO”  betroffen. 

Fiir  die  vier  “Fiop...()”-Aufrufe  ergeben  sich  nur  in  Hinsicht  auf  die  maximal  erlaubte 
Sektorzahl  Unterschiede  (bei  hoheren  Sektorzahlen  wird  entsprechend  das  richtige  Format 
gewahlt).  “ProtobtO”  wird  um  neue  Opcodes  fiir  Bootsektoren  entsprechender  Diskettentypen 
erweitert. 
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Treiber  fiir  Festplatten 


Einleitung 

Prinzipiell  konnte  das  BIOS  Festplatten  wie  ganz  normale  Diskettenlaufwerke  behandeln. 
Aus  verschiedenen  Griinden  geht  es  allerdings  anders  vor: 

-  Zur  Markteinfiihrung  des  ST  war  der  Platz  in  den  1 92  KByte  groflen  ROMs  ausgespro- 
chen  wertvoll.  Da  es  1985  sowieso  noch  keine  Festplatten  fiir  den  ST  zu  kaufen  gab,  hat 
man  dem  BIOS  gerade  eben  das  Notigste  verpaBt,  um  den  Treiber  wenigstens  von  einer 
Platte booten  zu  konnen  (es  dauerte  allerdings  bis  1 987 ,  bis  die  Atari-Festplattensoftware 
dies  auch  ausnutzen  konnte). 

-  Auf  Festplatten  paBt  erheblich  mehr  als  auf  eine  Diskette.  Schon  die  ersten  ST~ 
Festplatten  mit  20  MB  Speicherkapazitat  (iberschritten  die  damals  fiir  GEMDOS 
maximale  MediengroBe.  DaB  die  PlattengroBen  weiterwachsen  wiirden,  war  leicht 
vorauszusehen. 

Daherenthalten  TOS-Versionen  vor  2.00  keinen  eigenen  Festplattentreiber,  sondem  nur  eine 
Routine  zum  Lesen  und  Ausfiihren  des  Rootsektors  (Sektor  0)  der  Platte.  TOS-Versionen  ab 
2.00  konnen  iiber  die  XBIOS-Funktionen  “DMAread()”  und  “DMAwriteO”  auf  Festplatten 
zugreifen,  die  fertige  Einbindung  als  Treiber  gibt  es  aber  auch  hier  nicht.  Da  diese  Routinen 
allerdings  nicht  geschwindigkeitsoptimiert  sind,  greifen  die  allermeisten  Festplattentreiber 
(auch  die  von  Atari)  direkt  auf  die  Hardware  zu. 

Die  GEMDOS -spezifischen  Kapazitatsgrenzen  werden  folgendermaBen  umgangen:  der 
verfiigbare  Speicherplatz  des  pkysikalischen  Mediums  wird  auf  mehrere  logische  Laufwerke 
verteilt.  Diese  logischen  Laufwerke  werden  gemeinhin  Partitionen  genannt  und  haben  eine 
fiir  GEMDOS  akzeptable  MaximalgroBe.  Einige  Vorteile  dieses  Partitionierung  genannten 
Verfahrens: 

-  Kleinere  Medien  bedeuten  fiir  das  Dateisystem  weniger  Arbeit  und  mehr  Geschwindig- 
keit  (wegen  des  geringeren  Verwaltungsaufwands). 

Mehr  Ubersicht  -  speziell  in  Verbindung  mit  Programmen,  die  die  Starken  eines 
hierarchischen  Dateisystems  schlecht  ausnutzen  (gemeint  ist  das  alte  GEM -Desktop,  das 
nur  Laufwerks-,  aber  keine  Ordnersymbole  auf  dem  Desktophintergrund  ablegen  kann). 

-  Nicht  jede  der  Partionen  muB  auch  tatsachlich  ein  GEMDOS-Dateisystem  enthalten. 
Damit  ist  es  moglich,  auf  einer  Festplatte  mit  verschiedenen  Betriebssystemen  (Minix, 
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Macintosh-Emulation)  zu  arbeiten.  Und  mit  Meta-DOS  ware  es  sogar  denkbar,  fremde 
Dateisysteme  fur  GEMDOS  zuganglich  zu  machen. 

-  Prinzipbedingt  ftlhren  “Unfalle”  im  Dateisystem  meist  nur  zum  Dateiverlust  auf  einer 
Partition. 

-  Viele  Festplattentreiber  bieten  die  Moglichkeit,  einzelne  Partitionen  gezielt  gegen 
Schreibzugriffe  zu  schiitzen,  was  beim  Testen  neuer  Software  gegen  unliebsame  ttber- 
raschungen  schiitzen  kann. 

Die  Einteilung  in  mehrere  Partitionen  ist  ubrigens  keine  Erfmdung  von  Atari.  Auch  unter  MS- 
DOS  und  unter  Unix  (wenn  auch  dort  aus  anderen  GrUnden)  gibt  es  Partitionen. 


Bootvorgang 

Das  BIOS  untersucht  nacheinander  die  Rootsektoren  der  angeschlossenen  Festplatten,  und 
zwar  beginnend  mit  der  niedrigsten  Geratenummer  (0).  Beim  TT  werden  erst  die  acht 
moglichen  SCSI-Gerate  und  dann  erst  die  ACSI-Gerate  begutachtet. 

Je  nach  TOS-Version  werden  dabei  unterschiedliche  Strategien  benutzt: 

-  Bis  einschliefilich  TOS  1.02  wird  pro  Gerat  nur  ein  Leseversuch  gestartet. 

-  In  TOS  1 .04  wird  bei  Fehlern  ein  zweiter  Versuch  gemacht  -  vorausgesetzt  der  Fehler 
war  kein  Time-Out  (zu  deutsch:  Gerat  nicht  vorhanden). 

-  TOS  1 .06  und  TOS  1 .62  benutzen  beim  Kaltstart  groBzugige  Warteschleifen,  so  daB  mit 
vielen  Platten  das  gleichzeitige  Einschalten  von  Rechner  und  Platte  moglich  ist. 

-  Ab  TOS  2.05  (bzw.  TOS  3.0 1 )  wird  beim  Kaltstart  vor  dem  ersten  Lesezugriff  eine  groB- 
ziigige  Pause  von  90  Sekunden  eingelegt.  Damit  soli  den  im  Mega  STE  bzw.  TT  einge- 
bauten  Platten  Gelegenheit  gegeben  werden,  sich  zu  initialisieren  (wie  sollte  man  bei 
diesen  Geraten  auch  Platte  und  Rechner  getrennt  einschalten?). 

Kann  ein  Sektor  gelesen  werden,  und  hat  die  Priifsumme  (analog  zum  Booten  von  Disketten) 
den  Wert  $1234,  dann  wird  zum  ersten  Byte  des  gelesenen  Sektors  gesprungen.  Offizielle 
Unterlagen  zu  den  Parametem  dieser  Routine  gibt  es  leider  nicht.  Eine  Analyse  des  vom  AHDI 
(“Atari  Hard  Disk  Interface”)  4.0  benutzten  Rootsektors  ergab  folgende  Registerbelegung: 

D7  Bits  5..7  enthalten  die  Nummer  des  ACSI-Gerats,  das  gerade  getestet  wird. 
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D4  Bits  0..2  enthalten  die  Nummer  des  SCSI-Gerats,  das  gerade  getestet  wird. 

D3  Falls  D3  die  Long-Konstante  “DM  Ar”  enthalt,  gilt  die  Information  aus  D4  (und  man  daif 
die  XBIOS-Funktion  “DMAreadO”  aufrufen),  ansonsten  die  aus  D7. 

Der  im  Rootsektor  enthaltene  Programmcode  kann  nun  den  eigentlichen  Treiber  nachladen, 
die  BlOS-Vektoren  und  “_drvbits”  passend  initialisieren  und  dann  ins  BIOS  zurtickkehren. 
Alte  Versionen  des  AHDI  (vor  3.0)  haben  die  weitere  Systeminitialisierung  (Laden  der 
Programme  im  AUTO-Ordner,  Starten  von  GEM  und  Desktop)  allerdings  selbst  iibemom- 
men. 

Wer  es  noeh  immer  nicht  gemerkt  hat:  den  Festplattentreiber  in  den  AUTO-Ordner  einer 
Festplatte  zu  kopieren  ist  weder  sinnvoll  noch  klug!  Um  die  Programme  im  AUTO-Ordner 
iiberhaupt  laden  zu  konnen,  muB  sowieso  schon  ein  Festplattentreiber  initialisiert  sein! 
Normalerweise  iibemimmt  der  Rootsektor  die  Aufgabe,  die  Treiberdatei  (beim  AHDI: 
“SHDRIVER.SYS”)  im  Wurzelverzeichnis  der  Bootpartition  zu  finden  und  zu  laden. 


Format  des  Rootsektors 

Die  Bezeichnung  Bootsektor  bezieht  sich  immer  auf  den  ersten  Sektor  eines  logisehen 
Laufwerks.  Der  Rootsektor  bezeichnet  den  physikalisch  ersten  Sektor  des  Mediums.  Da  bei 
einer  Diskette  kein  Unterschied  zwischen  logischem  und  physikalischem  Laufwerk  gemacht 
wird,  liegt  der  Bootsektor  einer  Diskette  in  Sektor  0. 

Anders  bei  Festplatten,  die  in  mehrere  logische  Laufwerke  unterteilt  sind:  jede  Partition  einer 
Festplatte  hat  einen  Bootsektor  (BlOS-Sektomummer  0),  die  gesamte  Festplatte  aber  nur 
einen  Rootsektor. 

Wie  wir  bereits  gesehen  haben,  macht  das  BIOS  keinerlei  Annahmen  dariiber,  was  in  einem 
Rootsektor  steht:  wenn  die  Priifsumme  $1234  ist,  wird  er  ausgefuhrt,  sonst  nicht.  Prinzipiell 
bleibt  es  damit  den  verschiedenen  Festplattentreibem  uberlassen,  ob  und  wie  sie  die 
Unterteilung  auf  verschiedene  Partitionen  vomehmen. 

Praktikabel  ware  das  allerdings  nicht: 

-  Gelegentlich  mochte  man  neue  oder  andere  Treiber  installieren.  Dann  ware  es  mehr  als 
unbequem,  miiBte  man  die  gesamte  Platte  neu  einrichten. 

-  Alternative  Betriebssysteme  mtlssen  direkt  auf  den  Rootsektor  zugrejfen,  um  die  fur  sie 
vorgesehenen  Partitionen  finden  zu  konnen. 
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-  Wechselplattenbesitzer  mochten  ihr  Medium  auch  auf  Rechnem  mit  anderen  Festplatten- 

treibera  ansprechen  konnen. 

Zum  Gliick  hat  Atari  das  vom  eigenen  Festplattentreiber  unterstiitzte  Format  ausftihrlich 
dokumentiert,  und  so  spricht  alles  dafiir,  dazu  kompatibel  zu  bleiben: 


Offset 

Name 

Belegung 

$1C2 

hd_siz 

Gesamtzahl  der  5 12-Byte-Sektoren  als  LONG-Wert 

$IC6 

pOJig 

Informationen  iiber  Partition  0 

$1C7 

pOJd 

$1CA 

pO_st 

$1CE 

pO_siz 

$1D2 

pljlg 

Informationen  iiber  Partition  1 

$1D3 

pl_id 

S1D6 

pl_st 

$1DA 

pl_siz 

SIDE 

P2_flg 

Informationen  iiber  Partition  2 

$1DF 

p2_id 

$1E2 

p2_st 

$1E6 

p2_siz 

$1EA 

p3_flg 

Informationen  iiber  Partition  3 

$1EB 

p3„id 

$1EE 

p3.st 

$1F2 

p3  siz 

$1F6 

bsl_st 

Anfang  der  “Bad  Sector  List”  (LONG-Wert) 

S1FA 

bsl_cnt 

Lange  der  “Bad  Sector  List”  (LONG-Wert) 

$1FE 

Platzhalter  zur  Errechnung  der  Priifsumme 

Atari  unterscheidet  zwischen  Standardpartitionen  und  Ei-weiterungspardtionen  (“extended 
partitions”). 

Standardpartitionen  enthalten  nonnalerweise  ein  “logisches”  Laufwerk,  wahrend  Erweiterungs- 
partitionen  dazu  dienen,  mehr  als  die  vier  im  Rootsektor  vorgesehenen  Partitionen  auf  der 
Festplatte  unterzubringen.  Von  den  vier  Partitionseintragen  darf  nur  einer  der  letzten  drei  fur 
eine  Erweiterungspartition  benutzt  werden.  Fur  jede  Partition  steht  eine  zwolf  Bytes  groBe 
Informationsstruktur  zu  Verfligung  (das  Fragezeichen  steht  jeweils  ftir  die  Partitionsnummer) : 

P?Jlg  (ein  Byte) 

Dieses  Feld  enthalt  Flags,  die  iiber  einige  Eigenschaften  der  Partition  Auskunft  geben: 
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Bit  0:  Partition  existiert  (1 )  oder  existiert  nicht  (0).  Anhand  dieses  Bits  kann  man  also 

feststellen,  ob  die  betreffende  Informationsstruktur  iiberhaupt  sinnvolle  Daten 
enthalt. 

Bit  1  ..6:  reserviert  (auf  Null  setzen) 

Bit  7:  Partition  ist  bootbar  (1)  oder  nicht  bootbar  (0).  Der  Atari-Festplattentreiber 

bootet  von  der  ersten  als  bootbar  gekennzeichneten  Partition. 

p?_id  (drei  Bytes) 

Hier  miissen  drei  Zeichen  stehen,  die  den  Typ  der  betreffenden  Partition  festlegen 
(Partitionskennung) : 

“GEM”;  Standard-GEMDOS-Partition  (kleiner  als  16  Megabyte) 

“BGM”:  GroBe  GEMDOS-Partition  (“big  GEMDOS  partition”) 

“XGM”:  Erweiterungspartition 

Andere  Eintrage  werden  von  zum  AHDI  3.0  kompatiblen  Treibem  ignoriert  und  konnen  zur 
Kennzeichnung  von  Partitionen  fiir  andere  Betriebssysteme  benutzt  werden. 

p?_st  (LONG) 

Nummer  des  ersten  Sektors  der  Partition,  gerechnet  ab  Sektor  0. 
p?_siz  (LONG) 

GroBe  der  Partition  in  5 1 2-Byte-Sektoren  (die  AHDI-Spezifikation  sieht  also  Festplatten  mit 
groBeren  Sektoren  nicht  vor). 


Partitionstypen 

Eine  Standard-GEMDOS-Partition  (Partitionskennung  “GEM”)  enthalt  als  ersten  Sektor 
einen  Bootsektor,  wie  man  ihn  schon  von  Disketten  her  kennt. 

Da  eine  Festplattenpartition  und  eine  Diskette  aber  eben  doch  nicht  ganz  vergleichbar  sind, 
sind  einige  Anmerkungen  zu  den  einzelnen  Feldem  notwendig: 

BRA.S  Wie  schon  erwahnt,  ist  der  Programmcode  zum  Booten  bei  Festplatten  im 
Rootsektor  abgelegt.  Normalerweise  ist  also  der  Bootsektor  einer  Partition  fiir 
andere  Zwecke  frei.  Viele  Festplattentreiber  nutzen  den  freien  Platz,  um  hier 
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den  restlichen  zum  Nachladen  der  Treiberdatei  notwendigen  Programmcode 
abzulegen. 

BPS  SektorgroBe  in  Bytes  (bei  Standardpartitionen  immer  512  Bytes) 

SPT  bei  Festplatten  unbenutzt 

NSIDES  bei  Festplatten  unbenutzt 

Frage'.  Wie  erkennt  der  Festplattentreiber,  ob  das  Medium  eine  I2-Bit-FAT  oder  eine  16-Bit- 
FAT  hat?  Garnicht!  Auf  dem  Atari  haben  Festplattenpartitionen  immer  nur  I6-Bit-FATs  (mit 
zwolf  Bits  kame  man  auch  nicht  weit).  Anders  bei  MS-DOS:  dort  sind  sowohl  12-Bit-FATs 
als  auch  32-Bit-FATs  moglich. 

Da  altere  GEMDOS-Versionen  nur  32766  Cluster  pro  Laufwerk  verwalten  konnen  und  die 
SektorgroBe  auf  512  Bytes  beschrankt  ist,  konnen  solche  Standardpartitionen  nie  groBer  als 
16  MByte  werden. 

Grofle  GEMDOS-Partitionen  (Partitionskennung  “BGM”)  wurden  mit  AHDI  3.0  eingefiihrt, 
um  die  eben  genannte  GroBenbeschrankung  zu  umgehen.  Die  maximale  Kapazitat  einer 
Partition  berechnet  sich  als  das  Produkt  von  maximaler  Clusterzahl,  der  Anzahl  von  Sektoren 
pro  Cluster  und  der  GroBe  der  Sektoren.  Fur  die  ersten  beiden  Werte  zeigt  sich  GEMDOS  leider 
iiberhaupt  nicht  kompromiBbereit,  und  so  muBte  Atari  auf  groBere  Sektoren  ausweichen. 

Da  man  sich  allerdings  meistens  nicht  aussuchen  kann,  wie  groB  die  Sektoren  auf  der  Festplatte 
sein  sollen  (fast  immer  sind  es  512  Bytes),  tauscht  der  Festplattentreiber  dem  BIOS  einfach 
die  grofieren  Sektoren  vor.  Dazu  faBt  er  einfach  immer  mehrere  physikalische  Sektoren  zu 
einem  logischen  Sektor  zusammen. 

Bei  BGM-Partitionen  ist  der  Bootsektor  also  wie  folgt  geandert: 

BPS  SektorgroBe  in  Bytes  (512,  1024,  2048, 4096  oder  8192  Bytes) 

Bei  “groBen”  Sektoren  wird  der  “Rest”  des  Bootsektors  (also  alles  bis  auf  die  ersten  512  Bytes) 
mit  Nullen  aufgefiillt  und  hat  weiter  keine  Bedeutung. 

Damit  ist  es  allerdings  noch  nicht  getan:  auch  GEMDOS  muB  dariiber  informiert  werden,  wie 
groB  ein  Sektor  maximal  werden  kann  -  schlieBlich  hat  es  dafiir  eigene  Pufferlisten,  die 
entsprechend  modifiziert  sein  wollen  (mehr  dazu  in  der  Einleitung  zum  GEMDOS  unter 
“GEMDOS-Puffer”).  Eigene  Versuche  ergaben  iibrigens,  daB  GEMDOS  8192  Bytes  grofie 
Sektoren  gar  nicht  gem  mag  (ausprobieren!). 
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Fur  die  veranderte  Partitionskennung  (“BGM”  anstelle  von  “GEM”)  gibt  es  eigentlich  keinen 
echten  Bedarf:  alle  notigen  Informationen  lassen  sich  schlieBlich  aus  dem  Bootsektor  heraus- 
lesen.  Genauso  verfahrt  auch  AHDI  3.0:  fur  ihn  ist  es  vollig  egal,  ob  die  Partitionskennung 
“GEM”  Oder  “BGM”  ist. 

Doch  was  wtirde  passieren,  lieBe  man  einen  “alten”  Treiber  auf  die  Festplatte  los?  Richtig: 
er  wiirde  wahrscheinlich  die  angegebene  SektorgroBe  ignorieren  und  einen  ungenieBbaren 
Datensalat  fabrizieren. 

Daher  sollte  man  die  Partitionskennungen  wie  folgt  interpretieren: 

“GEM”:  fiir  alle  Festplattentreiber  nutzbar 

“BGM”:  Festplattentreiber  muB  mit  grSBeren  logischen  Sektoren  zurechtkommen  (also 

kompatibel  zu  AHDI  3.0  sein) 

Eine  weitere  Einschrankung  alterer  Festplattentreiber  war,  daB  sie  nur  maximal  vier  Partitionen 
unterstiitzen  konnten.  Kombiniert  mit  der  GroBenbeschrankung  der  einzelnen  Partitionen  war 
damit  schon  bei  etwa  64  MByte  groBen  Festplatten  SchluB.  Das  war  auch  1987  schon  eine 
Einschrankung. 

An  dieser  Stelle  kommen  die  Erweiterungspartitionen  ins  Spiel.  Bevor  ich  zur  Struktur  dieses 
Partitionstyps  komme,  kann  ich  mir  eine  Bemerkung  nicht  verkneifen:  Selbst  nach  dem 
Schreiben  eines  AHDI-3-kompatiblen  Festplattenpartitionierers  (“SCSI-Tool”)  verstehe  ich 
noch  immer  nicht,  warum  das  Format  gerade  so  aussieht,  wie  es  aussieht. 

Der  Grundgedanke  lauft  darauf  hinaus,  daB  alle  zusatzlichen  Partitionen  in  Form  einer 
verketteten  Liste  organisiert  werden.  Damit  erlaubt  das  Format  prinzipiell  beliebig  viele 
Partitionen. 

Eine  Erweiterungspartition  ist  eine  Partition,  die  aus  mehreren  Teilpartitionen  bestehen  kann. 
Jede  dieser  Teilpartitionen  besteht  aus  einem  Hilfs-Rootsektor  und  einer  Standardpartition 
(wie  sie  oben  beschrieben  ist).  Das  Format  eines  Hilfs-Rootsektors  ahnelt  stark  dem  eines 
normalen  Rootsektors.  Einschrankungen  sind: 

-  Die  Felder  “hd_siz”,  “bsl_st”  und  “bsl_cnt”  sind  nicht  benutzt. 

-  Maximal  zwei  der  Partitionsinformationsstrukturen  diirfen  benutzt  sein  (und  miissen 
direkt  aufeinander  folgen).  Die  anderen  beiden  Eintrage  miissen  mit  Nullen  gefiillt  sein. 

Die  erste  der  beiden  benutzten  Informationsstrukturen  muB  fiir  eine  Standardpartition  stehen. 
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Dabei  gelten  fur  einige  der  Felder  leicht  modifizierte  Bedeutungen: 

p?_flg:  Nur  Bit  0 1st  benutzt  (und  muB  gesetzt  sein),  bootbare  Partitionen  konnen  nur 

im  “echten”  Rootsektor  installiert  werden.  Alle  weiteren  Bits  sind  reserviert. 

p?_id:  Hier  darf  nicht  “XGM”  steben. 

p?_st:  Startsektor  der  Partition  reiativ  zu  diesem  Hilfs-Rootsektor. 

Der  folgende  Eintrag  daif  leer  sein  (dann  ist  das  Ende  der  verketteten  Liste  erreicht). 
Anderenfalls  muB  er  einen  Verweis  auf  den  nachsten  Hilfs-Rootsektor  enthalten.  Die 
einzelnen  Felder  sehen  dann  so  aus: 

p?_flg:  Nur  Bit  0  ist  benutzt  (und  muB  gesetzt  sein).  Alle  weiteren  Bits  sind  reserviert. 

p?  id:  MuB  “XGM”  enthalten. 

p?_st:  Startsektor  der  nachsten  Teilpartition  reiativ  zurn  ersten  Sektor  der  Erweite- 

rungspartition  (!). 

p?_siz:  GroBe  der  nachsten  Teilpartition  (normalerweise  PartitionsgroBe  plus  ein  Sek¬ 

tor  fiir  den  Hilfs-Rootsektor). 

Tip\  Wer  AHDI-3-kompatible  Software  schreiben  will,  sollte  eine  Weile  mit  dem  Festplatten- 
partitionierer  “HDX”  experimentieren  und  sich  die  erzeugten  Rootsektoren  genau  ansehen! 


Bad  sector  list 

Festplatten  tendieren  schon  wegen  ihrer  GroBe  dazu,  die  eine  oder  andere  defekte  Stelle 
aufzuweisen.  Das  gilt  sogar  fur  fabrikneue  Platten. 

Harddisks  nach  dem  ST506-Standard  werden  von  auBen  durch  Angabe  von  physikalischen 
Positionen  auf  der  Platte  gesteuert-  also  Zylinder,  Kopf,  Spur  etc.  (ganz  ahnlich  wie  bei  einem 
Diskettenlaufwerk).  Die  Hersteller  solcher  Platten  liefem  in  der  Regel  eine  Liste  der  Defekt- 
stellen  mit.  In  den  Atari-Festplatten  SH  204,  SH  205,  Megafile  20,  Megafile  30  und  Megafile 
60  ist  das  ST506-Laufwerk  allerdings  indirekt  iiber  ein  spezielles  Controllerboard  angeschlos- 
sen,  so  daB  man  sich  nicht  um  die  Geometrie  der  Platte  zu  ktimmem  braucht  und  direkt  mit 
fortlaufend  numerierten  Sektoren  arbeiten  kann. 

Der  von  Atari  eingesetzte  Controller  erlaubt  es  prinzipiell,  defekte  Sektoren  “auszumappen”. 
Das  heiBt,  daB  der  Controller  intern  eine  Liste  der  defekten  Stellen  kennt  und  bei  der  Nume- 
rierung  der  Sektomummem  selbsttatig  ausfiltert. 
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Damit  konnte  man  die  Verwaltung  der  defekten  Stellen  eigentlich  auf  die  Hardware  abwalzen. 
Ob  dies  auch  tatsachlich  funktioniert,  wird  wohl  vorlaufig  ungeldart  bleiben,  da  die  Atari- 
Festplattensoftware  von  dieser  Moglichkeit  sowieso  keinen  Gebrauch  macht  und  mittlerweile 
SCSI-Platten  nicht  nur  im  Mega  STE  und  im  TT  weite  Verbreitung  gefunden  haben. 

SCSI-Platten  haben  es  namlich  beixn  Defektmanagement  sehr  viel  einfacher.  Der  Hersteller 
testet  die  Platte  und  sorgt  auf  Controller-Ebene  ffir  das  Ausmappen  der  Sektoren.  De  facto 
erhalt  der  Kunde  also  eine  hundertprozentig  fehlerfreie  Platte. 

Auch  wenn  neue  Defekte  auftreten,  steht  der  SCSI-Controller  hilfreich  zur  Seite.  Die  neuen 
Fehlerstellen  werden  einfach  in  die  Defektliste  aufgenommen  -  und  schon  sind  sie  “ver- 
schwunden”.  Manche  Plattentypen  haben  sogar  eigens  dafiir  vorgesehene  Reservesektoren 
und  -spuren;  einige  gehen  sogar  so  weit,  das  Aus-  und  Um-Mappen  bei  Bedarf  im  laufenden 
Betrieb  vorzunehmen. 

Leider  nutzt  Ataris  “HDX”  diese  Moglichkeit  nicht  aus,  obwohl  das  bei  den  in  der  Megafile 
44  und  den  im  Mega  STE  und  TT  integrierten  Festplatten  moglich  ware.  Anders  steht  es  bei 
Festplattentools,  die  von  Fremdherstellem  geliefert  werden  (zum  Beispiel  das  schon  oben 
erwahnte  “SCSI-Tool”  von  Hard  &.  Soft). 

“HDX”  geht  einen  anderen  Weg:  in  der  “Bad  Sector  List”  -  einem  speziell  dafiir  vorgesehe- 
nem  Bereich  auf  der  Platte  -  werden  getrennte  Listen  fttr  “Hersteller”-Defekte  und  neu  aufge- 
tretene  Defekte  geffihrt.  Beim  Umpartitionieren  der  Platten  werden  die  defekten  Sektoren 
dann  auf  Ebene  der  FAT  (also  auf  Dateisystem-Ebene)  unschadlich  gemacht. 

Wer  ein  Festplatten-Utility  schreiben  will,  das  diese  “Bad  Sector  List”  unterstiitzt,  sollte  sich 
beim  Atari-Entwickler-Support  die  “  AHDI  Release  Notes”  besorgen.  Wem  es  nur  nur  darauf 
ankommt,  die  Platte  so  zu  partitionieren,  daB  sie  mit  “HDX”  weiterbearbeitet  werden  kann: 
als  Lange  der  “Bad  Sector  List”  den  Wert  1  eintragen,  den  betreffenden  Sektor  vollstandig  mit 
Nullen  fiillen,  und  in  das  vierte  Byte  den  Wert  $  A5  eintragen  (eine  leere  “Bad  sector  list”  wird 
von  “HDX”  nicht  akzeptiert)! 


Andere  Plattenformate 

Das  hier  angegebene  AHDI-3 -Format  ist  erst  1 989  von  Atari  eingefiihrt  worden.  Vorher  gab 
es  weder  Erweiterungspartitionen  noch  groBere  Sektoren. 


Daneben  wurden  auch  noch  weitere  Felder  im  Rootsektor  benutzt,  um  Informationen  iiber  die 
Plattengeometrie  (Zylinder,  Kopfe,  Spuren)  bereitzustellen.  Diese  Felder  sind  nicht  offiziell 
dokumentiert  und  zu  allem  UberfluB  ohnehin  zu  nichts  zu  gebrauchen: 
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-  Durch  die  Fehlerkorrekturfahigkeiten  modemer  SCSI-Platten  ist  es  sowieso  nicht  mehr 
moglich,  von  logischen  Sektomummem  auf  spezielle  Positionen  auf  dem  Medium  zu 
schliefien, 

-  Viele  SCSI-Platten  benutzen  eine  variable  Zahl  von  Sektoren  pro  Spur,  um  die  auBeren 
Spuren  der  Platte  besser  nutzen  zu  konnen, 

-  Die  beschriebenen  Felder  belegen  wertvollen  Platz  im  Rootsektor,  der  unter  Umstanden 
fiir  Programmcode  benotigt  wird. 

Daher  sollte  man  sich  auf  keinen  Fall  darauf  verlassen,  an  diesen  Stellen  des  Rootsektors 
sinnvolle  Daten  vorzufinden. 

Beim  alten  Atari-Format  war  die  maximale  PlattengroBe  auf  64  MByte  festgelegt.  Kein 
Wunder,  daS  viele  Hersteller  andere  Formate  ersonnen  haben,  um  mehr  Partidonen  auf  einer 
Platte  unterbringen  zu  konnen. 

Das  heute  von  Atari  benutzte  Format  hat  allerdings  zwei  wichtige  Vorteile: 

-  Es  ist  vollstandig  zum  alten  Format  kompatibel  -  selbst  dann,  wenn  man  versehentlich 
einen  alten  Treiber  startet. 

-  Es  werden  keine  neuen  Eintrage  im  Rootsektor  “verbraucht”, 

Der  Rootsektor  von  MS-DOS-Festplatten  sieht  deutlich  anders  aus.  Dies  konnte  einem  ziem- 
lich  egal  sein,  gabe  es  nicht  Wechselplatten.  AHDI  enthalt  tatsachlich  Code,  der  die  Benut- 
zung  von  unter  MS-DOS  partidonierten  Syquest-Wechselmedien  erlaubt. 

Das  allerdings  mit  folgenden  Binschrankungen: 

-  Dieses  “Feature”  ist  nicht  offiziell  dokumentiert  —  meist  ein  Zeichen  dafrir,  daB  es  noch 
ungeloste  Probleme  gibt. 

-  Genau  diese  Probleme  konnten  damit  zu  tun  haben,  daB  MS-DOS-Wechselplatten  oft 
Cluster  zu  vier  Sektoren  verwenden  -  was  GEMDOS  laut  Dokumentation  gar  nicht  mag. 


Die  PUNINFO-Struktur 

Zum  AHDI  3.0  kompatible  Festplattentreiber  installieren  eine  Struktur,  die  viel  Wissenswer- 
tes  iiber  den  Treiber  und  die  Platte  enthalt: 
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typedef  struct 
{ 

WORD 
BYTE 
LONG 
LONG 
LONG 
UWORD 
DWORD 
LONG 

}  PUN_INFO; 

Zunachst  fallt  auf,  daB  die  Felder  innerhalb  der  Struktur  nur  Platz  fiir  16  Eintrage  haben 
(obwohl  das  BIOS  maximal  32  Gerate  unterstiitzt).  Dadurch  kann  man  AHDI-3-kompatibel 
nur  maximal  16  Gerdtenummem  verwalten. 

“puns”  gibt  an,  fiir  wie  viele  Gerate  sich  der  Festplattentreiber  zustandig  fiihlt.  In  der  “pun”- 
Tabelle  befinden  sich  nahere  Informationen  zu  den  BIOS-Geraten  0  bis  15: 

Bit  0..2:  Geratenummer  der  Festplatte. 

Bit  3 :  Bei  gesetztem  Bit  handelt  es  sich  um  ein  Gerat  an  der  SCSI-  Schnittstelle  (sonst: 

ACSI).  Dieses  Bit  ist  zwar  noch  nicht  offiziell  dokumentiert,  kann  aber  wohl 
ohne  Vorbehalt  benutzt  werden. 

Bit  4..6:  Reserviert. 

Bit  7 :  Wenn  dieses  Bit  gesetzt  ist,  dann  wird  das  BIOS-Gerat  nicht  vom  Plattentreiber 

verwaltet  (gilt  beispielsweise  fiir  die  beiden  Diskettenlaufwerke  auf  den 
Geratenummem  0  und  1). 

“part„start”  enthalt  fiir  jede  (unterstUtzte)  Geratenummer  die  Nummer  des  Startsektors  auf  der 
betreffenden  Festplatte.  “P„cookie”  ist  ein  Magic-Wert,  mit  dem  man  sich  vergewissem  soll- 
te,  ob  man  tatsdchlich  eine  gtiltige  PUN_INFO-Struktur  vor  sich  hat. 

Gleiches  gilt  fiir  “P_cookptr”  (der  auf  das  vorherige  Strukturelement  zeigen  sollte)  und  die 
Versionsnummer  in  “P_version”. 

Naheres  zu  “P_max_sector”  finden  Sie  in  der  GEMDOS-Einleitung  (Thema:  GEMDOS- 
Puffer).  Einige  Felder  dieser  Struktur  sind  erst  dann  ausgefiillt,  wenn  ein  “Getbpb()”-Aufmf 
fiir  das  Laufwerk  stattgefunden  hat. 


puns; 
pun [16] ; 
part_start [16] , 
P_cookie; 
*P_cookptr; 
P_version; 
P_max_sector  ; 
reserved [16]  ; 


/*  Anzahl  der  Gerate  */ 

/*  diverse  Flags  */ 

/*  Partitionsanfange  */ 
muB  "AHDI"  sein  */ 
zeigt  auf  vorheriges  Element  */ 
/*  0x0300  Oder  groiier  */ 

/*  maximale  SektorgrdBe  */ 


/* 

/* 
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Einen  Zeiger  auf  diese  Struktur  erhalt  man  iiber  die  Systemvariable  “pun_ptr”: 

/*  Zeiger  auf  PUN_INFO-Struktur  ermitteln. 

Liefert  entweder  den  Zeiger  Oder  im  Fehlerfall  0  zuriiek  */ 

PUN_INFO  *getpun  (void) 

{ 

PUN_INFO  *P; 

LONG  oldstack; 

oldstack  =  Super  (OL) ; 

P  =  * ( (PUN_INFO  **) (0x516L) ) ; 

Super  ( (void  *)  oldstack) ; 

if  (P)  /*  iiberhaupt  gesetzt?  */ 

if  (P->P_cookie  ==  0x41484449L)  /*  Cookie  gesetzt?  */ 
if  (P->P_cookptr  ==  & (P~>P_cookie) ) 
if  (P->P_version  >=  0x300) 
return  P; 

return  0L; 

} 


Unterstiitzung  von  Wechselplatten 

Wechselplatten  machen  den  Festplattentreibem  auf  vielfaltige  Art  und  Weise  das  Leben 
schwerer: 

1.  Die  Medien  konnen  gewechselt  werden. 

2.  Nicht  jedes  Medium  muB  die  gleiche  Anzahl  von  Partitionen  besitzen. 

3 .  Unter  Umstanden  will  man  spater  ein  Medium  mit  groBeren  Sektoren  als  vorher  anmel- 
den. 

Problem  1  laBt  sichrelativ  leichtiosen,  da  das  BIOS  sowieso  schon  den  Begriff  “Mediachange” 
kennt  und  die  Erkennung  eines  SCSI-Medienwechsels  vergleichsweise  einfach  ist. 

Problem  2  hat  zwei  Seiten.  Einerseits  kann  es  passieren,  daB  das  neu  eingelegte  Medium 
wen/gerPartitionenhatals  das  beim  Booten  eingelegte.  Waspassiertnun  mit  der  freigewordenen 
Laufwerksnummer? 


BIOS  undXBIOS 


35 


Nichts,  genausowenig  wie  bei  einem  Diskettenlaufwerk  ohne  Diskette:  “Getbpb()”  liefert, 
ebenso  wie  “MediacbQ”  und  “RwabsQ”,  auf  Anfrage  eine  Fehlermeldung  (0). 

Der  umgekehrte  Fall  ist  schwieriger:  was  passiert,  wenn  das  neu  eingelegte  Medium  mehr 
Partitionen  hat  als  das  vorherige?  Atari  ist  auf  eine  Verlegenheitslosung  ausgewichen:  man 
meldet  dem  Treiber  bei  der  Installation,  wie  viele  Laufwerkskennungen  er  bei  einer  Wechsel- 
platte  freihalten  soil  (wer  hat  erne  bessere  Losung?).  Die  zusatzlichen  Laufwerkskennungen 
sind  dann  in  den  “_drvbits”  angemeldet,  konnen  aber  erst  nach  Einlegen  eines  passenden 
Mediums  angesprochen  werden  (ahnlich  wie  bei  nicht  eingelegten  Disketten). 

Dazu  -  und  das  ist  weniger  elegant  -  muB  man  an  der  Treiberdatei  herumpatchen  (das  Format 
ist  im  Anhang  beschrieben).  Andere  Festplattentools  (wie  zum  Beispiel  das  mittlerweile  viel- 
zitierte  “SCSI-Tool”)  machen  es  dem  Anwender  mittels  Dialogbox  und  Mausbedienung 
einfacher. 

Bei  Problem  3  ist  es  ahnlich:  da  GEMDOS  die  maximale  SektorgroBe  fur  seine  Pufferlisten 
kennen  muB,  ist  eine  nachtragliche  Anderung  schwierig.  Einfacher  ist  es,  dem  Treiber  von 
vornherein  die  maximal  notige  SektorgroBe  mitzuteilen.  Auch  dieser  Wert  kann  beim  AHDI 
in  derTreiberdatei  eingetragen  werden  (und  wie  immer  gehtes  bei  “SCSI-Tool”  komfortabler). 
Weitere  Informationen  zu  diesem  Thema  bei  der  Erorterung  der  GEMDOS  -Pufferlisten  in  der 
GEMDOS-Ein  fiihrung. 


Welche  Partition  bekommt  welche  Geratenummer? 

Oft  ist  es  nicht  ganz  einfach  zu  verstehen,  warm  ein  Treiber  die  Partitionen  welcher  Platte  unter 
welchen  Laufwerksnamen  anbietet:  AHDI  ist  relativ  clever  und  sucht  selbsttatig  auch  auf 
mehreren  angeschlossenen  Platten  nach  anzusteuemden  Partitionen. 

Dazu  sucht  er,  immer  beginnend  bei  Geratenummer  0,  nach  Festplatten  (beim  TT  werden 
zuerst  die  SCSI-  und  dann  die  ACSI-Gerate  untersucht).  Die  Suche  bricht  ab,  wenn  eine 
Geratenummer  nicht  belegt  ist. 

Das  heiBt:  Festplatten  miissen,  immer  mit  0  anfangend,  aufsteigende  Geratenummem  aufwei- 
sen,  Liicken  sind  nicht  erlaubt.  Damit  ist  es  moglich,  daB  der  Treiber  zwar  korrekt  von  einer 
unter  ACSI-Nummer  1  laufenden  Platte  gebootet  wird,  dann  aber  keine  Partitionen  findet 
(weil  die  Suche  mit  Gerat  0  startet  und  auf  dieser  Nummer  keine  Platte  reagiert). 

Andere  Festplattentreiber  sind  da  flexibler.  Oft  sind  nicht  nur  Liicken,  sondem  auch  Ver- 
tauschungen  in  der  Geratereihenfolge  erlaubt.  Damit  kann  man  beispielsweise  Partitionen  auf 
Gerat  1  niedrigere  BIOS-Geratenummem  zuordnen  als  denen  auf  Gerdt  0. 
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Meta-DOS 

“Meta-DOS”  erweitertXBIOS  um  ein  Treiberkonzept  fur  blockorientierte  Gerate.  Daffir  hat 
Atari  die  Funktionsnummem  48  bis  63  reserviert. 

Meta-DOS  erlaubt  die  Installation  von  Treibern  fur  26  blockorientierte  Gerate.  Ihre  Funktio- 
nen  werden  fiber  neue  XBIOS-Aufrufe  (insbesondere  zum  Offnen  und  SchlieBen  der  Gerate 
und  zum  Lesen  und  Schreiben  von  Blocken)  bereitgestellt. 

Die  Kommunikation  von  GEMDOS  wird  durch  spezielle  logische  Geratetreiber  hergestellt 
(mehr  dazu  in  der  Einfuhrung  zum  GEMDOS). 

Meta-DOS  ist  eine  Betriebssystemerweiterung,  die  sich  noch  in  Entwicklung  befmdet.  Zur 
Zeit  sind  folgende  Treiber  verfugbar: 

-  ein  physikalischer  Treiber  fur  die  CD-ROM-Laufwerke  CDAR  504/505 

-  logische  Treiber  fur  die  beiden  in  Verbindung  mit  CD-ROMs  gebrauchlichen  Formate 
(“High  Siena”  und  ISO). 

In  der  Funktionsreferenz  finden  Sie  die  Dokumentation  zu  “Metaink()”.  Weitere  Informatio- 
nen  finden  Sie  in  den  Meta-DOS-Entwickierunterlagen. 


Speicherverwaltung 

Bei  der  Speicherverwaltung  hat  das  BIOS  wenig  zu  tun.  Es  hat  lediglich  die  Aufgabe,  beim 
Systemstart  den  vorhandenen  Arbeitsspeicher  zu  finden  und  zu  initialisieren.  Uber  die 
Funktion  “GetmpbO”  wird  GEMDOS  die  Moglichkeit  gegeben,  eine  erste  TPA  (mehr  dazu 
im  GEMDOS-Kapitel)  anzulegen. 


BIOS-  und  XBIOS-Bindings 

BIOS  und  XBIOS  nehmen  ihre  Parameter  auf  dem  Stack  entgegen.  Dabei  wird  das  letzte 
Argument  aus  der  Parameterliste  als  erstes  auf  den  Stack  gelegt.  SchlieBlich  wird  mit  Hilfe 
der  Anweisung  “TRAP  #13”  der  BIOS-Trap-Dispatcher  bzw.  mit  “TRAP  #14"  der  XBIOS- 
Dispatcher  aktiviert. 

Funktionsergebnisse  liefem  BIOS  und  XBIOS  im  Prozessomegister  DO  zurfick.  Nur  die 
Register  D3-D7  und  A3-A7  werden  gerettet.  Alle  anderen  konnen  durch  den  Aufruf  verandert 
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werden!  Das  Verhalten  fur  illegale  Funktionsnummem  ist  bis  auf  einige  wenige  Ausnahmen 
(“BlitmodeO”  und  “BconmapO”)  nicht  definiert. 

BIOS  und  XBIOS  sind  bis  zu  einem  gewissen  MaB  re-entrant.Damit  sind  auch  Aufmfe  aus 
Interrupts  oder  von  innerhalb  von  BIOS  oder  XBIOS  moglich.  Dabei  sind  allerdings  einige 
wichtige  Einschrankungen  zu  beachten: 

DerTRAP-DispatcherbenutzteinenfestenSpeicherbereich,umRegisterinhalte,Statusregister 
und  Riicksprungadressen  zu  retten.  Dieser  Bereich  bietet  laut  Atari  nur  fur  maximal  drei 
Rekursionsstufen  Platz.  Ais  Zeiger  auf  diesen  Speicherbereich  dient  die  Systemvariable 
“savptr”, 

Ein  anderes  Problem  resultiert  daraus,  dal)  ein  Interrupt  just  zu  dem  Zeitpunkt  auftreten  kann, 
in  dem  der  Dispatcher  Register  speichert  oder  wiederherstellt.  Eigen tlich  sollte  der  Dispatcher 
wahrend  dieses  Vorgangs  alle  Interrupts  sperren  -  doch  tut  er  es  leider  nicht. 

Fur  BIOS-  oder  XBIOS-Aufrufe  aus  einem  Interrupt  heraus  mul)  man  also  so  vorgehen: 

;  BIOS-  oder  XBIOS-Aufrufe  aus  dem  Interrupt 
;  Frei  nach:  The  Hitchhiker's  Guide  to  the  BIOS 

savptr  =  $4A2  ;  Zeiger  auf  Registerpuffer 

amount  =46  ;  soviel  Bytes  werden  verbraucht 

im_interrupt : 

sub.l  tamount,  savptr  ;  Platz  schaffen 

;  hier  diirfen  BIOS-  bzw.  XBIOS-Aufrufe  erfolgen 

add.l  #amount,  savptr  ;  . . .und  wieder  freigeben 

;  und  raus  aus  dem  Interrupt 
rte 

Wichtige  Einschrankung;  nur  ein  einziger  Interrupt-Handler  darf  gleichzeitig  so  verfahren! 


Fehlermeldimgen 

0:  E_OK  (“OK  (no  error)”) 

Funktion  erfolgreich  ausgefiihrt  (kein  Fehler  aufgetreten). 
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-I:  ERROR  (“Error”) 

Es  ist  ein  Fehler  aufgetreten,  der  nicht  genauer  spezifiziert  werden  kann. 

-2:  EDRVNR  (“Drive  not  ready”) 

Angesprochenes  Gerat  ist  nicht  angeschlossen,  nicht  funktionsbereit  Oder  reagiert  nicht 
innerhalb  der  gesetzten  Frist  (Timeout). 

-3:  EUNCMD  (“Unknown  command”) 

Dem  angesprochenen  Peripheriegerat  ist  das  gegebene  Kommando  unbekannt. 

-4:  E_CRC  (“CRC  error”) 

Beim  Lesen  eines  Sektors  ist  ein  Fehler  aufgetreten  (aufgetreten  bei  der  CRC-Uberpriifung). 
-5:  EBADRQ  (“Bad  request”) 

Das  Peripheriegerat  kann  das  Kommando  nicht  ausfuhren.  Befehlsparameter  und  Kontext 
prtifen! 

~6:  E_SEEK  (“Seek  error”) 

Der  angesprochene  Track  konnte  vom  Laufwerk  nicht  erreicht  werden. 

-7:  EMEDIA  (“Unknown  media”) 

Leseversuch  gescheitert,  da  das  Medium  keinen  korrekten  Bootsektor  besitzt. 

-8:  ESECNF  (“Sector  not  found”) 

Der  betreffende  Sektor  wurde  nicht  gefunden. 

-9:  EPAPER  (“Out  of  paper”) 

Drucker  nicht  betriebsbereit. 

-10:  EWRITF  (“Write  fauit”) 

Fehler  bei  Schreiboperation  aufgetreten. 
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-11:  EREADF  (“Read  fault”) 

Fehler  bei  Leseoperation  aufgetreten. 

-12:  EGENRL  (“General  error”) 

Allgemeiner  Fehler  (Kommentar  im  “Hitchhiker’s  guide  to  the  BIOS”:  “Reserved  for  future 
catastrophes”). 

-13:  EWRPRO  (“Write  on  write-protected  media”) 

Es  wurde  versucht,  auf  ein  schreibgeschiitztes  Medium  zu  schreiben. 

-14:  E_CHNG  (“Media  change  detected”) 

Seit  der  letzten  Schreiboperation  wurde  das  Medium  gewechselt. 

-15:  EUNDEV  (“Unknown  device”) 

Das  angesprochene  Gerat  1st  dem  Betriebssystem  unbekannt. 

-16:  EBADSF  (“Bad  sectors  on  format”) 

Beim  Formatiervorgang  wurden  defekte  Sektoren  entdeckt. 

-17:  EOTHER  (“Insert  other  disk  request)” 

Eine  andere  Diskette  muB  eingeiegt  werden.  Tritt  nur  auf,  wenn  Laufwerk  B:  angesprocben 
wird,  ohne  angeschlossen  zu  sein.  In  diesem  Fall  wird  der  Benutzer  aufgefordert,  “Diskette 
B:”  in  das  erste  Laufwerk  einzulegen. 

-18:  EINSERT  (“Insert  disk”) 

Meta-DOS-Fehler:  Medium  einlegen! 

-19:  EDVNRSP  (“Device  not  responding”) 

Meta-DOS-Fehler:  Gerat  antwortet  nicht. 


40 


ATARI  Profibuch 


Der  OS-Header 

Der  OS-Header  ist  eine  Struktur,  die  viele  wichtige  Informationen  iiber  die  TOS-Version 
sowie  einige  Zeiger  auf  andere  Systemadressen  enthalt.  Je  nach  Betriebssystemversion  liegt 
er  am  Anfang  des  ROMs  oder  auch  im  RAM.  Seine  Adresse  kann  iiber  die  Systemvariable 
“_sysbase”  ermittelt  werden.  Und  so  sieht  er  aus: 

typedef  struct  _osheader 


UWORD 

os__entry; 

/* 

BRAnch-Instruktion  zum  RESET- 
Handler,  Offset  $00  */ 

UWORD 

os_version; 

/* 

TOS-Versionsnummer,  Offset  $02*/ 

void 

*reseth; 

/* 

Zeiger  auf  RESET-Handler, 

Offset  $04  */ 

struct 

osheader 

*os_beg; 

/* 

Basisadresse  Betriebssystem, 
Offset  $08  */ 

void 

*os  end; 

/* 

Erstes  nicht  vom  OS  benutztes 
Byte,  Offset  $0C  */ 

LONG 

os  rsvl; 

/* 

reserviert,  Offset  $10  */ 

GEM_MUPB 

*os_magic; 

/* 

Zeiger  auf  "GEM  memory  usage 
parameter  block".  Offset  $14  */ 

LONG 

os_date ; 

/* 

TOS-Herstellungsdatum  im  BCD- 
Format,  etwa  $02061986  fur 

6.  Februar  1986,  Offset  $18  */ 

UWORD 

os_conf; 

/* 

verschiedene  Konfigurationsbits, 
Offset  $1C  */ 

UWORD 

os  dosdate; 

/* 

TOS-Herstellungsdatum  im  GEMDOS- 
Format,  Offset  $1E  */ 

/*  die  folgenden  Felder  erst 

ab  TOS-Version  1.02  */ 

char 

**p_root; 

/* 

Basisadresse  des  GEMDOS-Pools, 
Offset  $20  */ 

BYTE 

**pkbshift; 

/* 

Zeiger  auf  BlOS-interne  Variable 
fur  den  aktuellen  Wert  von 
"Kbshift  0  ",  Offset  $24  */ 

BASEPAGE 

**p_run; 

/* 

Adresse  der  Variablen,  die  einen 
Zeiger  auf  den  aktuellen  GEMDOS- 
Prozeb  enthalt,  Offset  $28  */ 

char 

*p  rsv2; 

/* 

reserviert,  Offset  $2C  */ 

}  OSHEADER; 
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osjentry  ( Offset  0) 

Diese  beiden  Bytes  enthalten  ein  Sprungbefehl  zum  Anfang  der  Betriebssysteminitialisierung. 
os_version  (Offset  2) 

Dies  ist  die  TOS- Versionsnummer  (TOS  steht  tibrigens  entgegen  immer  wieder  verbreiteten, 
anders  lautenden  Geriichten  fiir  “The  Operating  System”) .  Folgende  Betriebssystemversionen 
waren  zum  Zeitpunkt  der  Drucklegung  bekannt: 

TOS  0.00  (os_version  enthalt  $0000)  war  das  BOOT-ROM,  das  mit  den  allerersten  STs 
ausgeliefert  wurde.  Es  war  nur  64  KByte  gro8  und  diente  in  erster  Linie  zum  Nachladen  des 
vollstandigen  TOS  von  Diskette.  Atari-interne  Bezeichnung:  “Das  Boot”. 

TOS  1 .00  (os_version:  $0100)  war  das  erste  “fertige”  TOS,  das  zunachst  auf  Diskette  (“RAM- 
TOS”)  und  ab  Februar  1986  auf  ROMs  ausgeliefert  wurde  (“ROM-TOS”). 

TOS  1 .02  (os_version :  $0 1 02)  enthalt  gegeniiber  der  Vorgangerversion  Routinen  zur  Nutzung 
des  Blitters  und  tragt  daher  den  Namen  “Blitter-TOS”.  Zuerst  wurde  es  im  Mega  ST  gesichtet, 
spater  dann  aber  standardmaBig  auch  in  alle  anderen  Rechner  eingebaut.  Ebenso  wie  TOS  1 .00 
enthalt  es  die  GEMDOS-Version  0.13,  die  sich  durch  besonders  grofie  Unzuverlassigkeit 
auszeichnet. 

Seit  1989  gibt  es  TOS  1 .04  (osjversion:  $0104).  Wegen  des  im  Farbmodus  mit  Regenbogen- 
farben  unterlegten  Atari-Symbols  im  Desktop  nennt  es  Atari  “Rainbow-TOS”.  TOS  1.04 
enthalt  ein  verbessertes  GEM  ( 1 .4)  und  ein  halbwegs  brauchbares  GEMDOS  (0. 1 5)  und  ist  die 
aktuellste  in  ST  und  Mega  ST  einsetzbare  Version  (wegen  der  Beschrankung  auf  192  KByte 
ROM). 

TOS  1.06  und  TOS  1.62  (os_version:  $0106  bzw.  $0162)  sind  die  in  den  Rechnem  der  STE- 
Serie  benutzten  TOS-Versionen.  TOS  1.06  ist  bis  auf  einige  Anpassungen  mit  TOS  1.04 
identisch.  Version  1.62  enthalt  die  verbesserte  GEMDOS-Version  0.17. 

TOS-Versionen  mit  einer  2  vor  dem  Dezimalpunkt  sind  fiir  Rechner  der  Mega-STE-Linie 
reserviert.  Die  bislang  erste  und  einzige  Version  ist  TOS  2.05  (os  j/ersion:  $0205). 

Betriebssystemversionen  fiir  den  TT/030  erkennt  man  an  der  3  vor  dem  Dezimalpunkt.Die 
ersten  ausgelieferten  TTs  enthielten  TOS  3.01  (osjversion:  $0301).  Seit  Anfang  1991  wird 
statt  dessen  das  um  einige  kleinere  Fehler  korrigierte  TOS  3.05  ausgeliefert. 

Originalton  Atari  zu  TOS-Versionsnummem  (Pexec-Cookbook):  “Using  the  OS  version 
number  to  determine  the  location  of  undocumented  variables  is  not  acceptable.  Y  ou  have  been 
warned.” 
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reseth  (Offset  4) 

Dieser  LONG-Wert  zeigt  auf  den  Beginn  des  Reset-Handlers. 
osjbeg  (Offset  8) 

Dies  1st  ein  Zeiger,  der  auf  die  Basisadresse  des  Betriebssystems  zeigt.  Dies  kann,  muB  aber 
nicht  die  gleiehe  Adresse  sein,  auf  die  auch  “_sysbase”  zeigt. 

os_end  (Offset  12) 

Zeigt  auf  das  Ende  des  fur  BIOS,  XBIOS  und  GEMDOS  benotigte  RAM. 
osjmagic  (Offset  20) 

Uber  diesen  Zeiger  erhalt  das  BIOS  Informationen  iiber  das  Vorhandensein  und  die  Speicher- 
bediirfnisse  von  GEM. 

“os_magic”  zeigt  auf  einen  “GEM  memory  usage  parameter  block”  folgender  Gestalt: 


typedef  struct 

{ 

LONG  qrr.  magic; 
void  *gm_end; 

void  *gm_init; 
}  GEM  MUPB; 


/*  muii  0x87654321  sein  */ 

/*  Ende  des  von  GEM  benotigten 
Speicherbereichs  */ 

/*  Startadresse  von  GEM  */ 


Diese  Werte  werden  vom  BIOS  bei  der  Sy  steminitialisierung  ausgewertet.  Wenn  “gm_magic” 
den  richtigen  Wert  hat,  wird  “gm_end”  als  “end_os”  und  “gm_init”  als  “exec_os”  eingesetzt. 

Anderenfalls  wird  fur  “end„os”  der  Wert  aus  “os_end”  und  fiir  “exec_os”  der  Reset-Handler 
eingesetzt. 

Zusammen  mit  der  XBIOS-Funktion  “PuntaesQ”  (loscht,  falls  im  RAM,  “gm_magic”)  und 
“_cmdload”  ist  es  damit  bei  einer  RAM-TOS-Version  moglich,  ohne  GEM  zu  booten. 

Dabei  werden  allerdings  nur  der  von  den  GEM-eigenen  Variablen,  nicht  aber  der  durch  den 
Programmcode  belegte  Speicherplatz  eingespart, 

os_date  (Offset  24) 

TOS-Herstellungsdatum  im  BCD-Format.  Einige  typische  Werte  fiir  deutschsprachige  TOS- 
Versionen: 
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Version 

os_date 

Datum 

1.00 

$02061986 

6.  Februar  1986 

1.02 

$04221987 

22.  April  1987 

1.04 

$04061989 

6.  April  1989 

1.06 

$07291989 

29.  Juli  1989 

2.05 

$12051990 

5.  Dezember  1990 

3.01 

$08291990 

29.  August  1990 

3.05 

$12051990 

5.  Dezember  1990 

os_conf  ( Offset  28) 

Das  unterste  Bit  enthalt  das  NTSC/P AL-Flag  (Bit  gesetzt:  PAL-Videosystem).  In  den  rest- 
lichen  Bits  befindet  sich  eine  Landerkennung,  die  dazu  dienen  kann,  in  kleineren  Program- 
men  automatisch  die  benutzte  Sprache  auszuwahlen: 


Land 

Kiirzel 

Nummer 

USA 

USA 

0 

Bundesrepublik  Deutschland 

FRG 

1 

Frankreich 

FRA 

2 

GroBbritannien 

UK 

3 

Spanien 

SPA 

4 

Italien 

ITA 

5 

Schweden 

SWE 

6 

Schweiz  (franzosisch) 

SWF 

7 

Schweiz  (deutsch) 

SWG 

8 

Tiirkei 

TUR 

9 

Finnland 

FIN 

10 

Norwegen 

NOR 

11 

Danemark 

DEN 

12 

Saudi-Arabien 

SAU 

13 

Niederlande 

HOL 

14 

Leider  gibt  es  einen  kleinen  Haken:  Um  einen  Fehler  in  sehr  alten  AHDI-Versionen  zu 
umgehen,  legt  TOS  ab  Version  1.02  einen  OS-Header  im  RAM  an  und  kopiert  dort 
“os_dosdate”  in  “os_conf Vor  dem  Start  der  AUTO-Ordner-Programme  wird  dann  wieder 
der  “richtige”  Wert  eingetragen. 

Nun  ist  es  aber  so,  daB  alte  AHDI-Versionen  die  restliche  Systeminitialisierung  selbst  iiber- 
nehmen  und  daher  nie  wieder  der  richtige  OSHEADER  installiert  wird.  Abhilfe:  Bei  Zugriffen 
auf  “os_conf  ’  immer  erst  einmal  indirekt  iiber  “os_beg”  gehen,  also  zum  Beispiel: 
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LONG  savessp  =  Super  (OL) ; 

OSHEADER  *0  =  * ( (OSHEADER  **) (0x4f2L) ) ; 

Super  ( (void  *)  savessp) ; 

O  =  0->os_beg;  /*  wegen  eines  Fehlers  in  einer  alten  AHDI- 
Version  */ 

So  kommt  man  mit  alien  TOS-  und  AHDI-Versionen  an  den  richtigen  Wert. 
os_dosdate  (Offset  30) 

Enthalt  die  gleiche  Information  wie  “os_date”  -  nur  im  GEMDOS  -Format.  Wird  bei  Rechnem 
ohne  Hardware-Uhr  als  Startwert  fiir  die  GEMDOS-Uhr  benutzt. 

p_root  ( Offset  32 ) 

Zeigt  auf  die  “Memory  free  list”  des  GEMDOS  (in  TOS  LOO  bei  Adresse  $56FA).  Wird  von 
“FOLDR100.PRG”  benutzt,  urn  den  GEMDOS-Pool  zu  erweitem. 

pkbshift  ( Offset  36) 

Zeigt  auf  eine  ein  Byte  groBe  Variable,  die  den  aktuellen  Zustand  der  Umschalttasten  (Shift, 
Control  etc.)  enthalt  (in  TOS  1 .00  bei  Adresse  $E1B).  Dies  ist  der  Wert,  der  von  der  BIOS- 
Funktion  “KbshiftO”  benutzt  werden. 

“pkbshift”  sollte  nur  dann  benutzt  werden,  wenn  der  Aufruf  der  BIOS-Funktion  nicht  moglich 
ist  -  beispielsweise  in  zeitkritischen  Interrupt-Routinen. 

p  run  (Offset  40) 

Zeigt  auf  einen  GEMDOS-intemen  Zeiger,  in  dem  die  Adresse  der  Basepage  des  aktuell 
ausgefiihrten  GEMDOS-Prozesses  steht.  Mehr  dazu  in  der  GEMDOS-Einleitung. 


Systeminitialisierung 

Fur  viele  Projekte  ist  es  interessant  zu  wissen,  was  genau  bei  der  Initialisierung  von  TOS  vor 
sich  geht.  Die  Thematik  wird  allerdings  dadurch  verkompliziert,  daB  es  erhebliche  Unterschie- 
de  zwischen  den  einzelnen  TOS-  und  Hardware-Versionen  gibt  und  die  aktuellste  offizielle 
Dokumentation  dazu  (“Hitchhiker’s  Guide  to  the  BIOS”)  noch  aus  dem  Jahre  1985  stammt. 

Im  Anfang  werden  Stack-Pointer  und  Programmzahler  mit  den  Werten  aus  den  Speicherzellen 
0  bis  7  geladen.  Diese  Adressen  enthalten  eine  Kopie  der  ersten  Bytes  des  ROMs.  Der  Wert 
des  Stack-Pointers  ist  dabei  eher  zufallig,  denn  es  handelt  sich  urn  die  ersten  vier  Bytes  der 
OSHEADER-Struktur  (also  os_entry  und  os_version). 
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Als  nachstes  werden  mittels  “move  #$2700,sr”  alle  Interrapts  gesperrt  und  eine  “reset”- 
Instruktion  ausgefiihrt.  Siedientdazu,  alle  angeschlossenen  Peripheriebausteinezu  initialisieren. 

Wenn  eine  Diagnose-Cartridge  eingelegt  ist  (dann  enthalt  Adresse  S00FA0000  den  Wert 
$FA52235F),  wird  A6  mit  einer  Riicksprungadresse  geladen  und  in  den  Code  der  Cartridge 
verzweigt  (Sprung  zu  Adresse  $0OFAOOO4). 

Nun  folgt  der  Test  auf  “Warmstart”.  Wenn  die  einzelnen  Validierungsregister  (“memvalid”, 
“memval2”  etc.)  die  richtigen  Werte  enthalten,  wird  von  einem  “Warmstart.”  ausgegangen. 
Das  hcifit  insbesondere,  daB  kein  neuer  Speiehertest  durchgefiihrt  wird. 

Als  nachstes  werden  die  im  Reset-Vektor  eingehangten  Funktionen  ausgefiihrt.  Dazu  wird 
“resvalid”  auf  den  korrekten  Wert  hin  uberprilft,  A6  mit  einer  Riicksprungadresse  geladen  und 
iiber  “resvector”  gesprungen.  Wie  man  hier  eigene  Funktionen  installieren  sollte,  wird  im 
AnschluB  an  diesen  Abschnitt  beschrieben. 

Es  folgt  die  Initialisierung  verschiedener  Hardwarebausteine  (PSG,  Shifter,  DMA-Sound). 
Wenn  es  sich  nicht  um  einen  Warmstart  handelt,  wird  anschlieBend  die  GroBe  des  verfiigbaren 
R  AMs  festgestellt,  der  gefundene  Speicher  geldscht,  und  die  V alidierungsregister  (“memvalid” 
etc.)  werden  initialisiert,  Weitere  Details  zum  Speiehertest  finden  Sie  im  Hardwareteil. 

Nun  wird  der  Beginn  des  Arbeitsspeichers  geloscht,  die  meisten  Systemvariablen  und  der 
Cookie  Jar  initialisiert,  der  Bildspeicher  am  Ende  des  freien  Arbeitsspeichers  installiert,  die 
Interrupt-Vektoren  gesetzt  und  schlieBlich  die  BIOS-Routinen  initialisiert. 

Cartridge-Software  mit  gesetztem  Bit  26  in  CA_INIT  wird  initialisiert  und  gestartet  (mehr  zur 
Behandlung  von  Cartridges  im  Hardwareteil).  AnschlieBend  wird  (je  nach  Monitortyp)  der 
entsprechende  Shifter-Modus  gesetzt,  der  Bildschimrinitialisiertundgcgebenenfalls  Cartridge- 
Software  mit  gesetztem  Bit  24  in  CAJNIT  aufgerufen. 

Der  Interrupt-Level  wird  auf  3  gesetzt,  daB  heiBt,  alle  Interrupts  bis  auf  den  Horizontal-Blank- 
Interrupt  werden  eingeschaltet.  Es  folgt  der  Aufruf  von  Cartridge-Software  mit  gesetztem  Bit 
25  in  CA_INIT.  GEMDOS  wird  initialisiert  (das  heiBt:  Standardkanale  werden  gesetzt,  interne 
Strukturen  werden  initialisiert,  Speicherverwaltung  wird  iibemommen  etc.). 

Cartridge-Software  mit  gesetztem  Bit  27  in  CAJNIT  wird  initialisiert  und  gestartet.  Nun  wird 
versucht,  von  der  Floppy  zu  booten.  Dazu  wird  durch  “hdv  Jnit”  und  “hdv_boot”  gesprungen. 

AnschlieBend  folgt  der  Bootversuch  von  Festplatte,  der  je  nach  Hardware  (ACSI  und/oder 
SCSI)  und  TOS  -  Version  recht  verschieden  aussehen  kann  (siehe  unter  “Treiber  fur  Festplatten, 
Bootvorgang”). 
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Was  jetzt  kommt,  ist  nicht  offiziell  dokumentiert  und  sollte,  wenn  iiberhaupt,  nur  vorsichtig 
in  kleinen  Utilities  benutzt  werden:  das  BIOS  durchsucht  den  gesamten  Speicher  nach  einem 
512-Byte-Block  (also  $400,  $600  etc.),  der  folgende  Eigenschaften  erfullt: 

-  Erster  LONG-Wert  ist  die  Konstante  $12123456. 

-  Im  zweiten  LONG  steht  ein  Zeiger  auf  die  betreffende  Speicherseite. 

-  Die  16-Bit-Priifsumme  aller  Worte  in  diesem  512-Byte-Block  ist  $5678. 

Wenn  alle  diese  Bedingungen  erfullt  sind,  dann  fiihrt  das  BIOS  einen  “jsr”  zu  Byte  8  der 
Speicherseite  durch.  Die  Suche  beginnt  unmittelbar  unter  “phystop”.  Zu  diesem  Zeitpunkt 
ist  allerdings  durch  die  GEMDOS-Initialisierung  bereits  aller  Speicher  oberhalb  von  $800 
geloscht,  so  dab  man  ohne  Tricks  nur  den  Speicherbereich  zwischen  $600  und  $7FF  benutzen 
konnte. 

Nun  werden  die  Programme  im  AUTO-Ordner  gestartet.  Dabei  ist  das  Wurzelverzeichnis  von 
“_bootdev”  das  aktuelle  Verzeichnis.  Die  einzelnen  Programmdateien  werden  also  mit 
“Fsfirst  (“\AUTO\* .PRG”, ...)”  gesucht. 

Zum  SchluB  wird  die  Default-Shell  gestartet:  wenn  “_cmdload”  nicht  0  ist,  wird  versucht, 
“COMMAND.PRG”  auszufuhren.  Anderenfalls  wird  mehr  schlecht  als  recht  ein  Default- 
Environment  zusammengezimmert  und  iiber  “exec_os”  GEM  gestartet. 

Falls  dieser  Schritt  schiefgeht  oder  die  Shell  terminiert  wird  (normalerweise  bei  GEM  nicht 
moglich),  geht  es  zuriick  zum  Reset. 


Der  Reset- Vektor 

Was  muB  man  tun,  um  eigene  Funktionen  in  den  Reset-Vektor  einklinken  zu  konnen? 

1.  “resvalid”  muB  auf  die  Konstante  $31415926  gesetzt  werden,  ansonsten  beachtet  das 
BIOS  “resvector”  gar  nicht  erst. 

2.  Der  Riickspmng  aus  der  Funktion  erfolgt  mit  “jmp  (A6)”,  denn  zu  diesem  Zeitpunkt  der 
Systeminialisierung  ist  noch  kein  Stack  installiert  (und  damit  “jsr”  und  “rts”  nicht 
moglich). 

3.  Damit  sich  mehrere  Programme  installieren  konnen,  muB  man  sich  nach  Abarbeitung 
der  Funktion  sauber  de-installieren. 
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Hier  ein  Beispiel  dazu: 

;  Installation  einer  Funktion  im  Reset -Vektor 
;  nach:  "Rainbow  TOS  Release  Notes" 

;  Assembler:  MAS68 

RESMAGIC  equ  $31415926 

_resvalid  equ  $426 

_resvector  equ  $42a 

_p_cookies  equ  $5a0 

.text 

;  eigene  Funktion  installieren 
install : 

move . 1  __resvalid, oldvalid 
move.l  #RESMAGIC,_resvalid 
move.l  __resvector, oldreset 
move.l  #newreset,  resvector 


;  dies  ist  die  neue  Funktion 

dc.b  "XBRACKJR"  ;  XBRA-Struktur 

oldreset : 

dc.l  0 

newreset : 

;  dieser  Code  wird  wahrend  des  Resets  ausgefuhrt 

move .  1  oldreset ,  __resvector 
move.l  oldvalid,  __resvalid 
jmp  (a6) 

.bss 

oldvalid: 

. ds . 1  1 
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Der  Vertical  Blank  Handler 

Einleitung 

Der  Vertical-Blank-Interrupt  (VBI)  wird  von  der  Video-Hardware  erzeugt  und  liegt  auf 
Interruptebene  4  (Vektor  bei  Adresse  $70). 

In  der  Interrupt-Hierarchie  nimmt  er  damit  einen  Platz  iiber  dem  Horizontal-Blank  (der  beim 
ST  normalerweise  nieht  benutzt  wird)  und  unterhalb  der  MFP-Interrupts  ein. 

Der  VBI  tritt  jeweils  beim  vertikalen  Zeileniiicklauf  des  Elektronenstrahls  auf  und  ist  damit 
besonders  fur  die  Manipulation  von  Registem  in  der  Video-Hardware  geeignet  (da  man  sonst 
mit  Storungen  auf  dem  Bildschirm  rechnen  miiBte). 

Daher  tritt  er  -  je  naeh  verwendetem  Video-System  -  zwischen  50  und  72  mal  pro  Sekunde 
auf. 

Die  folgende  Beschreibung  der  vom  BIOS  installierten  Vertical-Blank-Routine  erhebt  weder 
Anspruch  auf  Korrektheit  noch  auf  Vollstandigkeit.  Speziell  in  neuen  BlOS-Versionen 
konnen  sich  Unterschiede  bei  der  Reihenfolge  ergeben! 

1 .  Zunachst  wird  der  Zahler  “_frclock”  inkrementiert. 

2.  Falls  “vblsem”  kleiner  oder  gleich  0  ist,  wird  die  Interruptroutine  beendet. 

3.  Alle  Register  werden  gerettet. 

4.  “_vbclock”  wird  inkrementiert. 

5.  Falls  die  aktuelle  Auflosung  “hoch”  ist  (bei  ST  und  STE:  Auflosung  2,  beim  TT:  Auf¬ 
losung  6)  und  nieht  der  entsprechende  Bildschirm  angeschlossen  ist,  wird  die  Auflosung 
auf  “defshiftmd”  gesetzt  und  durch  den  Vektor  “swv_vec”  gesprungen. 

6.  Die  VT52-Cursor-Blink-Routine  wird  aufgerufen. 

7 .  Wenn  “colorptr”  ungleich  0  ist,  wird  die  dort  eingetragene  Farbpalette  in  die  Farbregister 
der  Video-Hardware  iibertragen  und  “colorptr”  anschlieBend  wieder  geloscht. 

8 .  Wenn  “screenpt”  ungleich  0  ist,  wird  die  dort  eingetragene  Adresse  in  “_v_bas_ad”  und 
die  dazugehorigen  Hardwareregister  iibertragen  und  “screenpt”  nieht  wieder  geloscht. 
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9.  Die  “deferred”  Vertical-Blank-Routinen  werden  nacheinander  aufgerufen  (mehr  dazu 
im  AnschluB). 

10.  Falls  “prt_cnt”  nicht  0  ist,  wird  durch  “scr_dump”  gesprungen  (und  dabei  normalerweise 
eine  Hardcopy  ausgegeben). 

11.  Die  geretteten  Registerinhalte  werden  wiederhergestellt. 


“Deferred”  Vertical-Blank-Routinen 

Mit  den  beiden  Systemvariablen  “nvbls”  ($454)  und  “_vblqueue”  ($456)  hat  man  die 
Moglichkeit,  eigene  Funktionen  in  die  System- VBI-Routine  einzuklinken.  Dazu  durchsucht 
man  die  Tabelle,  auf  die  “..vblqueue”  zeigt,  nach  freien  Eintragen  (also  nach  Eintragen,  die 
Nullzeiger  enthalten). 

Ist  kein  freier  Platz  da  (Anzahl  der  Platze  steht  in  “nvbls”),  reserviert  man  Platz  fur  eine  eigene 
Tabelle,  kopiert  die  bestehende  dorthin  und  fiigt  die  eigene  Routine  hinten  an.  AnschlieBend 
muB  man  noch  die  beiden  Systemvariablen  aktualisieren. 


Warnung:  Dreisterweise  uberschreibt  GEM  bei  der  Initialisierung  den  Vektor  fur  die  erste 
Vertical-Blank-Routine  durch  den  Zeiger  fur  die  Mausbewegungs-Routinen.  Soli  ein  im 
AUTO-Ordner  installierter  Interrupt  diesen  Anschlag  iiberleben,  muB  man  bei  der  Suche  nach 
einer  freien  Adresse  die  erste  Adresse  uberspringen  (der  Kliigere  gibt  nach...).  Der  Grunddafiir 
liegt  wahrscheinlich  darin,  daB  vermieden  werden  sollte,  daB  bei  der  emeuten  Initialisierung 
(nach  Wechseln  der  Aufldsung)  eine  zweite  Vertical-Blank-Routine  installiert  wird. 


Hier  ein  Beispiel; 

;  VBLank  installieren 


move . w  n  vbl  s ,  dO 

lsl.w  #2,d0 

move . 1  _vblqueue , aO 

moveq  #4,dl 

search__vb_slot : 

tst.l  (aO/dl) 

beq  slot_found 

addq  #4,dl 

cmp.w  dO,dl 

bne  search  vb  slot 


mal  4 

einen  Eintrag  tiberspringen 
frei? 


Ende  erreicht? 


so 
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;  Fehler  melden 
clr.w  dO 

rts 

slot_found : 

raove.l  #MyVB, 0 (aO,dl)  ;  VBlank-Handler  eintragen 

;  und  welter. . . 


Feste  Adressen  im  System 


Einleitung 

Die  untersten  zwei  Kilobytes  des  Arbeitsspeichers  nehmen  im  Atari  eine  besondere  Rolle  ein: 
die  Belegung  der  meisten  Speicheradressen  ist  dokumentiert  und  darf  unter  Beachtung  einiger 
VorsichtsmaBnahmen  auch  verandert  werden. 

Im  einzelnen  handelt  es  sich  um 

Vektoren  fur  Systeminterrupts  (ab  Byte  8  aufwarts)  und 

-  die  eigentlichen  Systemvariablen  (ab  $380  aufwSrts). 

Der  Zugriff  auf  diesen  Speieherbereich  ist  nur  aus  dem  Supervisor-Modus  heraus  moglich. 

Die  Systemvariablen  und  -vektoren  sind  die  absolut  “unterste”  Schicht  des  Betriebssystems. 
Anwendungsprogramme  sollten  schon  in  Hinsicht  auf  mogliehe  Multitasking-Erweiterungen 
des  Betriebssystems  (wie  zum  Beispiel  “Multi-GEM”  von  Maxon)  niemals  auf  diese  Spei- 
cherbereiche  zugreifen.  Nur  kleine  Utilities  und  Programme,  die  unter  die  Rubrik  “Systemsoft- 
ware”  fallen,  sollten  sich  hier  zu  schaffen  machen. 

Also: 

-  Niemals  Systemvariablen  verandem,  die  laut  Atari  nicht  verandert  werden  diirfen. 

-  Niemals  Systemvariablen  benutzen,  wenn  statt  dessen  auch  eine  Betriebssystemfunktion 
in  Frage  kame  (siehe  zum  Beispiel  “SetexcO”  und  “MfpintO”). 


Immer  sauber  zwischen  Anwendungsprogrammen  und  kleinen  Utilities  Oder  System- 
software  trennen. 
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Liste  der  Systemvektoren 

LONG  $000  0  Reset:  SSP 

Man  sollte  es  nicht  glauben,  aber  diese  und  die  folgenden  Speicherzellen  enthalten  ROM  - 
und  zwar  eine  Spiegelung  der  ersten  acht  Bytes  des  ROMs. 

Bei  einem  RESET  (durch  Tastendruck  Oder  Einschalten  des  Rechners)  wird  der  hier  liegende 
Wert  in  den  Supervisor-Stack-Pointer  geladen  (allerdings  kein  sinnvoller  -  der  “richtige” 
Stack  wird  erst  spater  vom  BIOS  installiert). 

LONG  $004  4  Reset:  PC 

Bei  RESET  wird  der  hier  vorgefundene  Wert  in  den  Program-Counter  geladen.  Man  fmdet 
hier  also  die  Adresse,  die  bei  einem  RESET  angespmngen  wird. 

LONG  $008  8  Busfehler 

Exception-Vektor  2:  zwei  Bombchen. 

Busfehler  treten  auf,  wenn  man  versucht,  auf  Speicherbereiche  zuzugreifen,  auf  die  kein 
Zugriff  erlaubt  ist.  Das  konnen  im  Supervisor-Modus  eigentlich  nur  nicht  existierende 
Speicherbereiche  sein.  Im  User-Modus  kann  es  auch  beim  Zugriff  auf  Hardware-Register  oder 
Bereiche  unterhalb  von  $800  passieren. 

Im  Normalfall  zeigt  dieser  Vektor  auf  die  TOS-Routinen  zur  Anzeige  von  Bombchen  (in 
diesem  Fall  zwei  an  der  Zahl). 

LONG  $00C  12  AdreBfehler 

Exception-Vektor  3:  drei  Bombchen. 

68000  und  68010  konnen  nur  byteweise  auf  ungerade  Adressen  zugreifen.  Diese  Exception 
wird  ausgelost,  wenn  man  dennoch  einen  Wort-  oder  Langwort-Zugriff  versucht  (auch  Pro- 
grammzahler  und  Stack-Pointer  diirfen  keine  ungeraden  Werte  enthalten!). 

LONG  $010  16  Illegaler  Befehl 

Exception-Vektor  4:  vier  Bombchen. 

Es  wurde  versucht,  einen  illegalen  Befehl  auszufiihren.  Dieser  Vektor  wird  von  vielen 
Debuggem  zur  Verwendung  fiir  Break-Points  geandert. 
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LONG  $014  20  Division  durch  Null 

Exception-Vektor  5:  kein  Bombchen. 

Bei  einem  DIV-Befehl  wurde  durch  0  geteilt. 

Dieser  Vektor  zeigt  im  Normalfall  auf  einen  “RTE”-Befehl  (Return  from  exception);  daher 
gibt  es  auch  keine  Bombchen. 

LONG  $018  24  CHK-Befehl 

Exception-Vektor  6 

Es  wurde  eine  Exception  durch  einen  “CHK”-Befehl  erzeugt. 

LONG  $01C  28  Befehl  TRAPV 

Exception-Vektor  7 

Es  wurde  eine  Exception  durch  einen  “TRAPV”-Befehl  erzeugt. 

LONG  $020  32  Privilegverletzung 

Exception-Vektor  8 

Es  wurde  versucht,  einen  Befehl  auszufuhren,  der  nur  im  Supervisor-Modus  erlaubt  ist. 

Beim  TT  testet  das  BIOS,  ob  es  sich  bei  dem  betreffenden  Befehl  urn  einen  “move  sr,...” 
gehandelt  hat:  dieser  Befehl  ist  im  Gegensatz  zum  68000er  nur  im  Supervisor-Modus  erlaubt. 
In  einem  solchen  Fall  setzt  das  BIOS  statt  dessen  einen  “move  ccr,..”  ein  und  versucht,  das 
Programm  weiterlaufen  zu  lassen. 

LONG  $024  36  Trace 

Exception-Vektor  9 

Ist  das  TRACE-Bit  im  Sfatusregister  gesetzt,  wird  nach  jeder  Instruktion  die  hier  angegebene 
Adresse  angesprungen. 


LONG  $028  40  Line-A-Vektor 

Exception-Vektor  10 
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Es  wurde  versucht,  eine  Instruktion  auszufiihren,  die  in  den  obersten  vier  Bits  den  Wert  “$  A” 
enthalt,  Zur  Zeit  wird  dieser  Vektor  fur  die  “Line-A-Routinen”  benutzt  (siehe  unter  VDI- 
Geratetreiber). 

LONG  $02C  44  Line-F-Vektor 

Exception-Vektor  1 1 

Es  wurde  versucht,  eine  Instruktion  auszufiihren,  die  in  den  obersten  Bits  den  Wert  “$F” 
enthalt. 

Wird  bis  TOS  1 .04  vom  GEM  benutzt  und  ist  eigentlich  fur  die  Programmierung  der  Floating- 
Point-Unit  gedacht. 

LONG  $030  48  Reserviert 

-  $05C  92 

Exception- Vektoren  12-23 

LONG  $060  9  Spurious  Interrupt 

Exception-Vektor  24 

Tritt  auf,  wenn  ein  Interrupt  ausgelost  wurde,  die  Ursache  dafiir  aber  nicht  feststellbar  war. 

LONG  $064  100  Autovektor-Interrupt,  Level  1 

Unbenutzt. 

LONG  $068  104  Autovektor-Interrupt,  Level  2 

Zeigt  auf  den  Handler  fur  Horizontal-Blanks. 

LONG  $06C  108  Autovektor-Interrupt,  Level  3 

Unbenutzt. 

LONG  $070  112  Autovektor-Interrupt,  Level  4 

Zeigt  auf  den  Handler  fur  Vertical-Blanks. 
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LONG  $074  116  Autovektor-Interrupt,  Level  5 

Unbenutzt. 

LONG  $078  120  Autovektor-Interrupt,  Level  6 

Zeigt  auf  Handler  fur  MFP-Interrupts. 

LONG  $07C  124  Autovektor-Interrupt,  Level  7 

Unbenutzt. 

LONG  $080  128  TRAP#0 

Exception-Vektor  32 

Vektor  fiir  den  Befehl  “TRAP  #0”.  Da  vom  Betriebssystem  nicht  benutzt,  gibt  es  Bombchen. 

LONG  $084  132  TRAP#1 

Exception-Vektor  33 

Vektor  fiir  den  Befehl  “TRAP  #1”.  Zeigt  auf  den  Dispatcher  fiir  die  GEMDOS-Funktionen. 

LONG  $088  136  TRAP  #2 

Exception-Vektor  34 

Vektor  fiir  den  Befehl  “TRAP  #2”.  Wird  von  AES  und  VDI  benutzt. 

LONG  $08C  140  TRAP  #3 

-$0B0  -176  TRAP  #12 

Exception-Vektoren  35  bis  44:  Entsprechend  viele  Bombchen,  da  sie  zur  Zeit  vom  Betriebssystem 
nicht  benutzt  werden. 

LONG  $0B4  180  TRAP  #13 

Exception-Vektor  45 

Vektor  fiir  den  Befehl  “TRAP  #13”.  Zeigt  auf  den  Dispatcher  fiir  die  BIOS-Funktionen. 
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LONG  $0B8  184  TRAP  #14 

Exception- Vektor  46.  Vektor  fur  den  Befehl  “TRAP  #14”.  Zeigt  auf  den  Dispatcher  fur  die 
XBIOS-Funktionen. 


LONG  $0BC  188  TRAP  #15 

Unbenutzt. 

LONG  $0C0  192  Reserviert 

-  $0FC  -252 

Exception-Vektoren  48  -  63 

LONG  $100  256  BUSY  Interrupt 

ST-MFP-Interrupt  0.  Wird  durch  parallele  Schnittstelle  ausgelost.  Normalerweise  nicht 
benutzt, 

LONG  $104  260  DCD  Interrupt 

ST-MFP-Interrupt  1.  Wird  durch  die  serielle  Schnittstelle  (“Carrier  detect”)  ausgelost. 
Normalerweise  unbenutzt. 

LONG  $108  264  CTS  Interrupt 

ST-MFP-Interrupt  2.  Wird  durch  die  serielle  Schnittstelle  (“Clear  to  send”)  ausgelost, 
Normalerweise  unbelegt. 

LONG  $10C  268  GPU  Done 

ST-MFP-Interrupt  3.  Kann  vom  Blitter  benutzt  werden,  um  den  AbschluB  einer  Operation 
anzuzeigen.  Normalerweise  nicht  benutzt, 

LONG  $110  272  Baudratengenerator 

ST-MFP-Interrupt  4.  Normalerweise  nicht  benutzt. 

LONG  $114  276  200  Hz  System  Timer 

ST-MFP-Interrupt  5,  Zeigt  auf  den  Systemtimer-Intemipt  und  darf  auf  keinen  Fall  verandert 
werden  (wird  fiir  Timing-Schleifen  im  TOS  benotigt!). 
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LONG  $118  280  IKBD/MIDI 

ST-MFP-Interrupt  6.  Zeigt  auf  den  Handler  fiir  IKBD-  und  MIDI-Interrupts. 

LONG  $11C  284  FDC/ACSI 

ST-MFP-Interrupt  7.  Normalerweise  unbelegt. 

LONG  $120  288  Display  Enable  Signal 

ST-MFP-Interrupt  8.  Normalerwei.se  gesperrt, 

LONG  $124  292  RS232  Sendefehler 

ST-MFP-Interrupt  9.  Wird  bei  Ubertragungsfehlem  beim  Senden  von  Daten  liber  die  serielle 
Schnittstelle  ausgelost. 

LONG  $128  296  RS232  Sendepuffer  leer 

ST-MFP-Interrupt  10.  Wird  ausgelost,  wenn  der  Sendevorgang  eines  einzelnen  Bytes 
abgeschlossen  worden  ist. 

LONG  $12C  300  RS232  Erapfangsfehler 

ST-MFP-Interrupt  11.  Tritt  bei  Empfangsfehlem  auf. 

LONG  $130  304  RS232  Empfangspuffer  voll 

ST-MFP-Interrupt  12.  Ein  komplettes  Zeichen  ist  von  der  seriellen  Schnittstelle  empfangen 
worden. 

LONG  $134  308  - 

ST-MFP-Interrupt  13.  Unbenutzt. 

LONG  $138  312  Ring  Indicator 

ST-MFP-Interrupt  14.  Wird  ausgelost,  wenn  die  serielle  Schnittstelle  einen  ankommenden 
Anruf  bemerkt  (z.  B.  bei  Verwendung  von  Modems).  Da  dieser  Interrupt  so  leicht  auszulosen 
ist  (entweder  mit  einem  speziellen  Schalter  an  der  RS232-Schnittstelle  oder  oft  -  bei 
angeschlossenem  Modem  -  durch  Aus-  und  Einschalten  des  Modems),  wird  er  geme  in 
Debuggem  als  Break-Signal  benutzt. 
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LONG  $13C  316  Monochrom  Monitor  Detect 

ST-MFP-Interrupt  15.  Unbenutzt. 

LONG  $140  320  TT-MFP-Interrupts 

-  $17C  380 

16  Interruptvektoren  fiir  den  zweiten  MFP  im  TT. 

LONG  $180  384  TT-SCC-Interrupts 

-  $1BC  444 

Platz  fur  die  Interruptvektoren  des  TT-SCC-Bausteins. 


Post-Mortem-Informationen 

Bei  einem  Systemabsturz  versucht  das  BIOS,  noch  Informationen  iiber  die  Art  des  Problems 
auszugeben  und  das  System  wieder  halbwegs  in  Ordnung  zu  bringen. 

Zu  den  MaBnahmen  gehoren: 

Je  nach  Exceptionnummer  wird  in  der  Bildschirmmitte  eine  Reihe  vonBombensy  mbolen 
ausgegeben.  Dies  natiirlich  perdirektem  Bildschirmzugriff,  VDI-Funktionen  konnen  in 
diesem  Moment  natiirlich  nicht  aufgerufen  werden. 

-  Im  Speicherbereich  von  $380  bis  $3FF  werden  die  aktuelle  Registerbelegung  und  Teile 
des  Stacks  gerettet. 

Der  vom  BIOS-Dispatcher  benotigte  “savptr”  wird  zuriickgesetzt. 

-  Das  Programm  wird  mit  “Pterm  (-1)”  beendet. 

Und  noch  ein  paar  Anmerkungen: 

-  Jede  dieser  Aktionen  kann  natiirlich  in  Ungliicksfallen  zu  weiteren  Exceptions  fiihren. 
Resultat  sind  dann  die  verhaBten  “Bombengirlanden”. 

-  Der  BIOS-Dispatcher  ignoriert  Exception  Nummer  fiinf  (Division  durch  0).  So  bleiben 
unter  Umstanden  einige  Programmfehler  unbemerkt. 
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-  Der  68030  ist  nicht  hundertprozentig  zum  68000  kompatibel.  So  gibt  es  beispielsweise 
einen  Befehl,  der  auf  dem  68000  im  User-Modus  erlaubt  ist,  auf  dem  68030  allerdings 
mit  einer  “privilege  violation”  quittiert  wird.  Das  TT-BIOS  kompensiert  dies  durch  einen 
speziellen  Exception-Handler,  der  versucht,  den  Befehl  sinnvoll  zu  emulieren. 

Und  hier  die  vom  Exception-Handler  benutzten  Systemvariablen: 

LONG  $380  896  procjives 

Wenn  in  dieser  Adresse  die  magische  Zahl  (“magic  number”)  $  12345678  steht,  sind  die  in  den 
folgenden  Adressen  vorliegenden  Informationen  giiltig. 

LONG  $384  900  proc_dregs 

-  $3a0  928 

In  diesen  Adressen  werden  im  Falle  einer  Exception,  die  Bombchen  hervorruft,  folgende 
Register  gerettet: 

DO,  Dl,  D2,  D3,  D4,  D5,  D6,  D7 

LONG  $3A4  932  procaregs 

-  $3C0  960 

In  diesen  Adressen  werden  im  Falle  einer  Exception,  die  Bombchen  hervorruft,  folgende 
Register  gerettet: 

A0,  Al,  A2,  A3,  A4,  A5,  A6,  A7’  (Supervisor-Stack-Pointer) 

BYTE  $3C4  964  procenum 

Nummer  der  aufgetretenen  Exception. 

LONG  $3C8  968  proc  jisp 

Geretter  Wert  des  User-Stack-Pointers. 

WORD  $3CC  972  proc_stk 

Die  obersten  sechzehn  Worte  des  Stacks  beim  Auftreten  der  Exception. 
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Liste  der  Systemvariablen 

LONG  $400  1024  etvtimer 

Logischer  GEMDOS- Vektor  256  (siehe  Einleitung  zum  GEMDOS) .  Sollte  immer  nur  mittel  s 
“Setexc()”  gesetzt  werden. 

LONG  $404  1028  etvcritic 

Logischer  GEMDOS-Vektor  257  (siehe  Einleitung  zum  GEMDOS).  Sollte  immer  nur  mittels 
“SetexcO”  gesetzt  werden. 

LONG  $408  1032  etvjerm 

Logischer  GEMDOS-Vektor  258  (siehe  Einleitung  zum  GEMDOS).  Sollte  immer  nur  mittels 
“SetexcO”  gesetzt  werden. 

LONG  $40C  1036  etvxtra 

Reserviert  fur  die  logischen  GEMDOS-Vektoren  259  bis  263  (zur  Zeit  nicht  benutzt). 

LONG  $420  1056  memvalid 

Sollte  die  magische  Zahl  $7520 19F3  enthalten. 

Siehe  auch  “memval2”,  “memval3”  und  “memcntrl”. 

BYTE  $424  1060  memcntrl 

Enthalt  die  untersten  vier  Bits  des  Speicherkontroll-Registers  ($FFFF8001). 

LONG  $426  1062  resvalid 

Wenn  diese  Adresse  bei  RESET  den  Wert  $31415926  enthalt,  wird  dutch  “resvector” 
gesprungen. 

LONG  $42A  1066  resvector 

Wird  bei  der  Systeminitialisierung  benutzt.  Enthalt  den  Vektor  fur  RESET,  falls  “resvalid” 
den  korrekten  Wert  beinhaltet.  Zum  Zeitpunkt  des  Aufrufs  sind  die  Hardwareregister  noch 
nicht  gesetzt,  und  auch  der  Stack-Pointer  ist  noch  nicht  initialisiert. 
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LONG  $42E  1070  phystop 

Zeiger  auf  das  erste  Byte  iiber  dem  physikalischen  Ende  des  ST-kompatiblen  RAM-Bereichs 
(zum  Beispiel  $00010000  bei  1MB  RAM). 

LONG  $432  1074  jmembot 

Unteres  Ende  des  unter  GEMDOS  freien  ST-kompatiblen  Speichers  (also  Anfang  der 
“urspriinglichen”  TP  A).  Wird  von  der  BIOS-Funktion  “GetmpbO”  verwendet. 

LONG  $436  1078  memtop 

Analog  zu  “_membot”  das  Ende  des  freien  ST-kompatiblen  Speieherbereichs. 

LONG  $43A  1082  memval2 

Sollte  die  Magic  Number  $237698AA  enthalten.  Haben  sowohl  “memval2”  als  auch 
“memvalid”  (und  ab  TOS  1 .02  “memval3”)  den  geforderten  Wert,  wird  beim  nachsten  RESET 
nur  ein  Warmstart  durchgefuhrt. 

WORD  $43E  1086  flock 

Wenn  hier  ein  Wert  ungleich  0  steht,  dann  darf  nicht  auf  den  DMA-Chip  zugegriffen  werden. 
DMA-Geratetreiber  mtissen  also  zunachst  abfragen,  ob  der  DMA-Chip  blockiert  worden  ist, 
und  “flock”  dann,  wenn  sie  mit  der  Arbeit  beginnen,  selbst  setzen. 

WORD  $440  1088  seekrate 

Seekrate  fur  die  beiden  Floppies.  Erlaubte  Werte: 


Wert 

Seekrate 

0 

6ms 

1 

12ms 

2 

2ms 

3 

3ms 

Diese  Systemvariable  wird  gleich  nach  dem  Systemstart  vom  BIOS  (durch  den  Aufruf  der  in 
“hdv_init”  eingetragenen  Routine)  ausgelesen  und  danach  ignoriert. 

Zum  Andern  der  tatsachlich  benutzten  Seekrate  muS  man  die  XBIOS-Funktion  “FloprateO” 
verwenden. 
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WORD  $442  1090  _timr_ms 

Zeit  in  Millisekunden,  die  normalerweise  zwischen  zwei  Aufrufen  des  System-Timers  vergeht 
(liegt  daher  bei  20;  wg.  50  Hz).  Dieser  Wert  wird  auch  von  der  BIOS-Funktion  “TickcalO” 
zuriickgeliefert. 

WORD  $444  1092  Jverify 

Legt  fest,  ob  das  BIOS  beim  Schreiben  auf  Diskette  per  “RwabsO”  einen  Verify  durchgefiihren 
soil  (0  bedeutet:  kein  Verify).  Im  Normalfall  ist  Verify  eingeschaltet. 

WORD  $446  1094  bootdev 

Enthalt  normalerweise  die  Nummer  des  Laufwerks,  von  dem  gebootet  worden  ist. 

Das  BIOS  benutzt  diese  Variable,  um  den  Standardzugriffspfad  fur  die  Environmentvariable 
“PATH”  zu  ermitteln.  In  alien  bekannten  TOS-Versionen  greift  es  dazu  allerdings  auf  das 
hoherwertige  Byte  zu,  so  daG  zumindest  an  dieser  Stelle  immer  “A:\”  herauskommt. 
Harddisktreiber  von  Fremdherstellem  beheben  dieses  Problem  meist. 

Mit  dem  Atari-Festplattentreiber  fallt  es  nicht  weiter  auf,  da  die  AES-Accessories  immer  auf 
Laufwerk  C:  suchen,  falls  dieses  existiert  (und  von  anderen  Partitionen  kann  man  mit  AHDI 
sowieso  nicht  booten). 

Daneben  wird  diese  Variable  auch  noch  beim  Booten  benutzt,  um  das  Bootlaufwerk  zu  wahlen 
(das  klappt  im  allgemeinen  aber  nur  dann,  wenn  kein  Festplattentreiber  gebootet  wird). 

Wenn  man  also  “_bootdev”  auf  1  setzt,  keine  autobootende  Festplatte  angeschlossen  hat  und 
einen  Reset  auslost,  wird  von  Laufwerk  B:  gebootet. 

WORD  $448  1096  palinode 

Legt  laut  Atari  die  Femsehnorm  fest. 

Die  Werte: 

0:  NTSC-Modus  (60  Hz) 

sonst:  PAL-Modus  (50  Hz) 

Tatsachlich  wird  diese  Systemvariable  nicht  beriicksichtigt.  Eine  Anderung  der  Bildwieder- 
holfrequenz  ist  nur  iiber  die  entsprechenden  Hardwareregister  moglich. 
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BYTE  $44A  1098  defshiftmd 

Standard-Farbgrafik-Auflosung.  Schaltet  der  Computer  auf  Farbbetrieb  um  (nach  RESET 
durch  Wechseln  der  Stecker  oder  Einschalten),  wird  in  die  angegebene  Auflosung  geschaltet. 


BYTE  $44C  1100  sshiftmd 

Kopie  des  Modus-Registers  des  Shifters  ($FFFF8260).  Die  Werte: 


Wert 


BildgroBe 


0 

1 

2 

4 

6 

7 


320  *200 
640  *  200 
640  *400 
640  *480 
1280*960 
320  *480 


(vier  Planes) 

(zwei  Planes) 

(ein  Plane) 

(vier  Planes,  nur  beim  TT) 
(ein  Plane,  nur  beim  TT) 
(acht  Planes,  nur  beim  TT) 


Alle  anderen  Werte  sind  fur  kiinftige  Erweiterungen  reserviert. 


LONG  $44E  1102  _v_bas_ad 

Zeiger  auf  den  Anfang  des  Bildspeichers,  der  beim  ST  auf  einer  256-Byte-Grenze  beginnen 
muB  (Sorry,  kein  Raum  fur  groBartige  Tricks  fur  Fine-Scrolling).  Beim  STE  und  TT  ist  es  eine 
2-  bzw.  8-Byte-Grenze. 

Dies  ist  der  Wert,  der  normalerweise  von  “LogbaseO”  zuriickgeliefert  wird. 


WORD  $452  1106  vblsem 

1:  Vertical-Blank-Handler  aktiviert. 

WORD  $454  1108  nvbls 

Anzahl  der  Eintrage,  auf  die  “_vblqueue”  zeigt.  Identisch  mit  der  Maximalzahl  von 
gleichzeitig  installierbaren  Vertical-Blank-Routinen.  Standardwert  ist  8. 


LONG  $456  1110  vblqueue 

Zeiger  auf  Zeigertabelle  fiir  Vertical-Blank-Prozesse. 
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LONG  $45A  1114  colorptr 

Zeiger  auf  erne  Farbpalette,  die  beim  nachsten  Vertical  Blank  in  die  ST -Hardware-Farbregister 
geladen  wird  (ab  Adresse  $FFFF8240).  Damit  w  ird  ein  unschones  Zucken  auf  dem  Bildschirm 
vermieden.  Steht  in  “colorptr”  eine  Null,  passiert  gar  nichts.  Nach  der  Ubertragung  der  Farb- 
werte  wird  “colorptr”  geloscht. 

Besser  ist  es,  die  entsprechenden  VDI-Funktionen  zu  nutzen,  da  schon  beim  “Atari  TT”  die 
Farbpalette  mehr  als  1 6  Eintrage  umfassen  kann.  Bei  anderen  Grafikkarten  wird  diese  Variable 
ganz  ignoriert. 


LONG  $45E  1118  screenpt 

Zeiger  auf  den  Anfang  des  Bildspeichers.  Wird  beim  nachsten  Vertical  Blank  in  die 
betreffenden  Hardwareregister  tibertragen,  ansehlieBend  aber  nicht  geloscht  (daher  sollte  man 
statt  dessen  immer  mit  “SetscreenO”  arbeiten!). 


LONG  $462  1122  _vbclock 

Anzahl  der  bereits  erfolgten  Vertical  Blanks. 

LONG  $466  1126  Jrclock 

Wie  “_vbclock”,  mit  dem  Unterschied,  daB  die  Zahlung  nicht  durch  “vblsem”  angehalten 
wird. 


LONG  $46A  1130  hdvjnit 

Vektor  zu  den  Initialisierungsroutinen  fur  die  Diskettenlaufwerke.  Wird  vor  dem  Lesen  der 
Bootsektoren  ausgelesen  und  kann  daher  nur  von  reset-residenten  Programmen  Oder  ROM- 
Modulen  verandert  werden. 

Zu  den  Aufgaben  gehoren: 

-  Initialisierung  der  Diskettenlaufwerke  (“_nflops”  wird  entsprechend  gesetzt) 

-  Ubertragung  von  “seekrate”  in  die  BlOS-intemen  Variablen 

LONG  $46E  1134  swv_vec 

Zeiger  auf  die  Routine,  die  auf  das  AnschlieBen  eines  SchwarzweiB-  bzw.  Farbmonitors 
reagiert  (zeigt  zu  Beginn  auf  die  normale  RESET-Routine). 
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LONG $472  1138  hdvbpb 

Vektor  zur  Routine,  die  den  BPB  (BIOS  Parameter  Block)  eines  BIOS-Laufwerks  ermittelt. 
Auf  dem  Stack  (4(sp))  wird  die  BIOS-Geratenummer  iibergeben. 

In  DO  liefert  man  entweder  einen  Zeiger  auf  den  BPB  oder  im  Fehlerfall  0  zuriick, 

LONG  $476  1142  hdv_rw 

Vektor  zur  Routine  zum  Lesen  und  Schreiben  von  Blocken  auf  BIOS-Laufwerken.  Auf  dem 
Stack  werden  die  gleichen  Parameter  wie  bei  “RwabsO”  ubergeben  (beginnend  mit  4(sp): 
rwflag). 

In  DO  liefert  man  den  Retum-Wert  fur  “RwabsO”  zuriick  (beispiel  weise  0,  wenn  alles  geklappt 
hat). 

LONG  $47A  1146  hdvjboot 

Vektor  zur  Routine  zum  Laden  des  Bootsektors.  Diese  Routine  wird  vom  BIOS  benutzt,  um 
festzustellen,  ob  ein  Bootsektor  vorhanden  und  ob  er  ausfuhrbar  ist. 

LONG  $47E  1150  hdv  mediach 

Vektor  zur  Routine  zur  Bestimmung  des  Medienwechsel-Status  eines  BIOS-Laufwerks.  Auf 
dem  Stack  (4(sp))  wird  die  BIOS-Geratenummer  Ubergeben. 

In  DO  liefert  man  den  Retum-Wert  fur  “MediachO”  zuriick. 

WORD  $482  1154  _cmdload 

Wenn  dieses  Register  nicht  0  ist,  wird  versucht,  anstelle  von  GEM  das  Programm  “COM- 
MAND.PRG”  zu  starten  (kann  durch  ein  Programm  in  einem  ausfuhrbaren  Bootsektor  gesetzt 
werden). 


BYTE  $484  1156  conterm 

Attributbits  fiir  BIOS-Gerat  “CON:”: 


Bit 

Bedeutung 

0 

Tastenklick  (Keyclick)  ein/aus 

1 

Tastenwiederholung  ein/aus 
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Bit 


Bedeutung 


2  Glocke  (Ping!)  bei  Ausgabe  von  CTRL-G 

3  Bei  “Bconin()”  aktuellen  Wert  von  “KbsbiftO”  in  den  Bits  24..3 1  zuriickgegeben 


LONG  $486  1158  trpl4ret 

Offiziell  nicht  dokumentiert  und  wohi  auch  unbenutzt. 


LONG  $48A  1162  criticret 

Offiziell  nicht  dokumentiert  und  wohl  auch  unbenutzt. 


MD  $48E  1166  themd 

MD-Struktur  des  GEMDOS. 

Diese  wird  ein  einziges  Mai  bei  der  Initialisierung  des  Systems  gesetzt  und  darf  nicht  verandert 
werden  (und  das  wird  sie  durch  Benutzung  der  BIOS-Funktion  “GetmpbO”!). 

LONG  $49E  1182  _ md 

Offiziell  nicht  dokumentiert  und  wohl  auch  unbenutzt. 

LONG  $4A2  186  savptr 

Zeiger  auf  Register-Zwischenspeicher  von  BIOS  und  XBIOS.  Mehr  dazu  bei  der  Dokumen- 
tation  des  BIOS-  bzw.  XBIOS -Bindings. 

WORD  $4A6  1190  _nflops 

Anzahl  der  angeschlossenen  Diskettenlaufwerke  (0,  1  oder  2). 

LONG  $4A8  1192  con_state 

Intemer  Zeiger  fur  Bildschirmausgaberoutinen;  offiziell  nicht  dokumentiert. 

WORD  $4 AC  1196  sav_row 

Intemer  Puffer  zur  Zwischenspeicherung  der  Cursor-Position;  offiziell  nicht  dokumentiert. 
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LONG  $4AE  1198  sav_context 

Sollte  eigentlich  ein  Zeiger  auf  den  Speicherbereich  sein,  in  den  bei  Exceptions  die  Register 
und  Teile  des  Stacks  gerettet  werden.  Tatsache  aber  ist,  daB  er  vom  TOS  nicht  benutzt  wird 
und  daB  man  daher  direkt  auf  die  Variablen  bei  Adresse  $380  zugreifen  muB. 

LONG  $4B2  1202  bufl 

Zwei  Zeiger  auf  GEMDOS-Pufferlisten.  Mehr  dazu  in  der  Einfiihrung  zum  GEMDOS. 

LONG  $4BA  1210  hz_200 

Bisherige  Anzahl  der  200-Hz-Interrupts. 

LONG  $4BE  1214  the_env 

Zeiger  auf  die  Standard-Environment-Strings  (unbenutzt!). 

LONG  $4C2  1218  _drvbits 

Bit-Tabeile  iiber  die  angemeldeten  BIOS-Laufwerke  (Bit  Null  fur  Laufwerk  “A:”  etc.).  Hier 
ist  also  Platz  fur  32  Eintrage!  Diese  Variable  wird  im  TOS  1.00  beim  Reset  nicht  geloscht. 
Eigene  Treiber  sollten  daher  bei  einem  Reset  die  selbst  eingetragenen  Bits  loschen.  Ansonsten 
kann  es  passieren,  daB  Laufwerkskennungen  “verschwinden”  (viele  Treiber  installieren  sich 
immer  auf  der  ersten  “freien”  Geratenummer). 

LONG  $4C6  1222  _dskbufp 

Zeiger  auf  einen  1024  Bytes  groBen  Puffer  zum  Lesen  und  Schreiben  auf  Disketten  oder 
Festplatten  (z.  B.  beim  Bootversuch).  Wird  auch  vom  VDI  verwendet. 

LONG  $4CA  1228  autopath 

Zeiger  auf  Zugriffspfad  fur  AUTO-Ordner  (unbenutzt  und  nicht  offiziell  dokumentiert). 
LONG  $4CE  1232  _vbl_list 

Urspriingliche  Liste  der  Vertical-Blank-Routinen  (immer  nur  iiber  “...vblqucue”  zugreifen!). 

WORD  $4EE  1262  prtcnt 

Zahler  fiir  die  ALT-HELP-Tastendriicke: 
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Wert 

Bedeutung 

-1: 

normaler  Status 

0: 

Hardcopy  beginnen 

>0: 

Hardcopy  abbrechen  und  auf  -1  zuriicksetzen 

Diese  Variable  muB  man  auch  vor  einem  Aufruf  von  “PrtblkQ”  setzen! 


WORD  $4F0  1264  _prtabt 

Flag  fur  Abbruch  des  Druckvorgangs  (unbenutzt). 


LONG  $4F2  1266  _sysbase 

Zeiger  auf  eine  Struktur  folgender  Form: 


typedef  struct 
{ 

osheader 

UWORD 

os_entry; 

/* 

UWORD 

os_version; 

/* 

void 

*reseth; 

/* 

struct  __osheader 
*os_beg; 

/* 

void 

*os  end; 

/* 

LONG 

os_rsvl; 

/* 

GEM_MUPB 

*os_magic; 

/* 

LONG 

os  date; 

/* 

UWORD 

os__conf  ; 

/* 

UWORD 

os_dosdate; 

/* 

BRAnch-Instruktion  zum  RESET - 
Handler,  Offset  $00  */ 
TOS-Versionsnurrmer,  Offset  $02  */ 
Zeiger  auf  RESET-Handler, 

Offset  $04  */ 

Basisadresse  des  Betriebssystems, 
Offset  $08  */ 

Erstes  nicht  vom  OS  benutztes 
Byte,  Offset  $0C  */ 
reserviert.  Offset  $10  */ 

Zeiger  auf  "GEM  memory  usage 
parameter  block".  Offset  $14  */ 
TOS-Herstellungsdatum  im  BCD- 
Format,  etwa  $02061986  fur 
6.  Februar  1986,  Offset  $18  */ 
verschiedene  Konfigurationsbits, 
Offset  $1C  */ 

TOS-Herstellungsdatum  im  GEMDOS- 
Forxnat,  Offset  $1E  */ 


/*  die  folgenden  Felder  erst  ab  TOS-Version  1.02  */ 
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char 

**p_root; 

/* 

Basisadresse  des  GEMDOS -Pools, 
Offset  $20  */ 

BYTE 

**pkbshift; 

/* 

Zeiger  auf  BlOS-interne  Variable 
fur  den  aktuellen  Wert  von 
"Kbshift () ",  Offset  $24  */ 

BASEPAGE 

**p  run; 

/* 

Adresse  der  Variablen,  die  einen 
Zeiger  auf  den  aktuellen  GEMDOS- 
ProzelJ  enthalt, Offset  $28  */ 

char 

OSHEADER; 

*p  rsv2; 

/* 

reserviert,  Offset  $2C  */ 

Zum  “OS-Header”  gibt  es  viel  zu  sagen  und  deshalb  auch  einen  eigenen  Abschnitt  (direkt  vor 
diesem!). 

LONG  $4F6  1270  _shell_p 

Dieser  Zeiger  wird  vom  ROM  nicht  genutzt.  Das  heiBt:  Programme,  die  ihn  selbst  benutzen, 
miissen  ihn  im  Falle  eines  Resets  und  nattirlich  auch  bei  Programmbeendigung  loschen! 

Normalerweise  wird  “_shell_p”  von  UNIX-ahnlichen  Shells  gesetzt  und  zeigt  auf  eine 
Routine,  die  eine  Kommandozeile  abarbeitet.  Die  Adresse  der  Zeichenkette  wird  auf  dem 
Stack  (4(sp))  iibergeben,  das  Ergebnis  der  Operation  erhalt  man  in  Register  DO.  Die  meisten 
C-Libraries  enthalten  ein  Binding  fur  die  Standardfunktion  “systemQ”,  das  in  etwa  so  aussieht: 

/*  WORD  system  (const  char  *cmd) 

Fuhrt  das  Kommando  "cmd"  uber  die  in  _shell_p  install ierte 
Shell  aus. 

Wenn  "cmd"  ein  Nullzeiger  1st,  wird  festgestellt,  ob  eine  Shell 
installiert  ist.  Ansonsten  wird  die  Zeile  Iibergeben  und  der 
Return-Wert  der  Shell  zuriickgeliefert . 

*/ 

♦define  _SHELL_P  ( (LONG  *) 0x4 f6L) 

WORD  system  (const  char  *cmd) 

{ 

WORD  cdecl  (*do_sys) (const  char  *cmd) ; 

LONG  oldssp; 

oldssp  =  Super  (0L); 

do_sys  =  (void  (*) )  *__SHELL_P; 

Super  ( (void  *) oldssp) ; 
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if  <!cmd) 

return  (do_sys  !=  OL) ; 

if  <do_sys  !=  OL) 

return  do_sys  (cmd) ; 


Was  in  der  Kommandozeile  stehen  kann,  ist  natiirlich  von  der  benutzten  Shell  abhangig.  Bei 
alien  in  Frage  kommenden  Shells  handelt  es  sich  allerdings  um  UNIX-ahnliche  Shells,  so  daft 
man  davon  ausgehen  kann,  dab  UNIX-iibliche  Standardkommandos  und  auch  eigene,  zusatz- 
lich  installierte  TOS-Programme  gestartet  werden  konnen. 

LONG  $4FA  1274  endos 

Zeiger  auf  das  erste  nicht  fur  TOS-inteme  Variablen  benutzte  Byte  (also  das  erstes  Byte  des 
freien  Speiehers). 

LONG  $4FE  1278  exec_os 

Zeiger  auf  das  erste  Byte  des  Textsegments  des  Shell-Programms. 

Das  Shell-Programm  wird  nach  der  vollstandigen  Initialisierung  von  GEMDOS  und  dem 
Abarbeiten  des  AUTO-Ordners  mittels  “Pexec()”  gestartet  (normalerweise  AES  und  Desktop). 

LONG  $502  1282  scr_dump 

Zeiger  auf  Hardcopyroutine  (wird  von  der  XBIOS-Funktion  “ScrdmpQ”  benutzt). 

LONG  $506  1286  prv Jsto 

Zeiger  auf  Routine  zum  Feststellen  des  Status  des  parallelen  Ports  (ebenfalls  fur  Hardcopy- 
Routine). 

LONG  $50A  1290  prvjst 

Zeiger  auf  Routine  zur  Ausgabe  auf  dem  parallelen  Port  (ebenfalls  fur  Hardcopy-Routine). 
Das  auszugebende  Zeichen  steht  in  6(sp). 
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LONG  $50E  1294  prvauxo 

Zeiger  auf  Routine  zum  Feststellen  des  Status  der  seriellen  Schnittstelle  (ebenfalls  fur 
Hardcopy-Funktion). 

LONG  $512  1298  prv  aux 

Zeiger  auf  Routine  zur  Ausgabe  auf  dem  seriellen  Port  (ebenfalls  fur  Hardcopy-Routine).  Das 
auszugebende  Zeichen  steht  in  6(sp). 


LONG  $516  1302  punjptr 

Zeigt  bei  erfolgreicher  Installation  eines  AHDI-korapatiblen  Festplattentreibers  auf  die  fol- 
gende  Datenstruktur.  Naheres  dazu  im  Abschnitt  “Treiber  fiir  Festplatten”. 


typedef  struct 

{ 

WORD  puns ; 

BYTE  pun [16]; 

LONG  part_start [16]; 

LONG  P_cookie; 

LONG  *P_cookptr; 

UWORD  P_version; 

DWORD  P_max_sector; 

LONG  r e  se  rved [16]; 

}  PUN  INFO; 


/*  Anzahl  der  Gerate  */ 

/*  diverse  Flags  */ 

/*  Partitionsanfange  */ 

/*  muB  "AHDI"  sein  */ 

/*  zeigt  auf  das  vorherige 
Element  */ 

/*  0x0300  Oder  grofier  */ 

/*  maximale  Sektorgrofie  */ 


LONG  $51A  1306  memval3  (ab  TOS  1.02) 

Siehe  auch  memval  und  memval2.  In  diesem  Fall  ist  der  “magic  value”  $5 555 AAA  A. 


LONG  $51E  1310  xconstat  (ab  TOS  1,02) 

Acht  Vektoren  fiir  “Bconstat()”-Routinen  (mehr  dazu  in  der  BIOS-Einfiihrung  unter 
“Zeichenorientierte  Funktionen”). 


LONG  $53E  1342  xconin  (ab  TOS  1.02) 

Acht  Vektoren  fiir  “Bconin()”-Routinen  (mehr  dazu  in  der  BIOS-Einfiihrung  unter 
“Zeichenorientierte  Funktionen”). 
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LONG  $55E  1374  xcostat  (ab  TOS  1.02) 

Acht  Vektoren  fur  “Bcostat()”-Routinen  (mehr  dazu  in  der  BIOS-Einfiihrung  unter  “Zeichen- 
orientierte  Funktionen”).  Vorsicht :  fiir  “BcostatO”  sind  die  Kanalnummem  3  (MIDI)  und  4 
(IKBD)  vertauscht. 

LONG  $57E  1406  xconout  (ab  TOS  1.02) 

Acht  Vektoren  fur  “Bconout()”-Routinen  (mehr  dazu  in  der  BIOS-Einfiihrung  unter  “Zei- 
chen-orientierte  Funktionen”). 

WORD  $59E  1438  Jongframe 

Wenn  dieses  Flag  nicht  0  ist,  dann  ist  eine  CPU  mit  langen  Stackframes  (also  kein  68000er) 
installiert. 

Dieser  Wert  ist  speziell  dann  von  Interesse,  wenn  man  eine  Routine  in  einen  Exception- Vektor 
einklinken  will  und  die  zu  untersuchenden  Werte  auf  dem  Stack  iibergeben  werden.  Wenn 
“Jongframe”  0  ist,  findet  man  dann  die  Parameter  bei  Offset  6,  ansonsten  bei  Offset  8. 

Man  kann  sich  iibrigens  durchaus  darauf  verlassen,  daB  der  hier  stehende  Wert  korrekt  ist. 
Hersteller  von  “Beschleunigerkarten”  miissen  sich  sowieso  darum  kiimmem,  daB  diese 
Systemvariable  korrekt  gesetzt  ist  -  sonst  wiirde  ein  groBer  Teil  der  Atari-Systemsoftware 
(wie  zum  Beispiel  der  Diablo-Emulator  der  SLM-Laserdrucker)  nicht  funktionieren. 

LONG  $5A0  1440  ji  cookies 

Zeiger  auf  den  Cookie  Jar  (deutsche  Ubersetzung:  “Keksdose”).  Dokumentation  im  AnschluB 
zu  diesem  Abschnitt. 

LONG  $5A4  1444  ramtop 

Zeiger  auf  das  Ende  des  Fast-RAMs  im  TT.  Nicht  offiziell  dokumentiert! 

LONG  $5A8  1448  ramvalid 

Magic- Wert,  der  anzeigt,  ob  “ramtop”  einen  sinnvollen  Wert  enthalt  (muB  $  1 357BD 1 3  sein) . 
Nicht  offiziell  dokumentiert! 

LONG  $5AC  1452  bell_hook  (ab  TOS  1.06) 

Zeiger  auf  Routine  zur  Ausgabe  des  “Ping”-Gerausches. 
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BIOS  sorgt  selbsttatig  fur  die  Abfrage  des  Flags  in  “conjerm”  und  ruft  diese  Routine  nur  dann 
auf,  wenn  das  Gerausch  wirklich  erklingen  soli.  Die  Routine  wird  im  Supervisor-Modus 
aufgerufen,  per  “rts”  abgeschlossen  und  darf  die  Register  D0-D2  und  A0-A2  verandem.  Auch 
BIOS-Aufrufe  vom  “Innem”  der  Routine  aus  sind  erlaubt. 

LONG  $5B0  1456  kcl_hook  (ab  TOS  1.06) 

Zeiger  auf  Routine  zur  Ausgabe  des  Tastenklick-Gerauschs.  BIOS  sorgt  selbsttatig  fur  die 
Abfrage  des  Flags  in  “conjerm”  und  ruft  diese  Routine  nur  dann  auf,  wenn  das  Gerausch 
wirklich  erklingen  soli.  Die  Routine  wird  im  Supervisor-Modus  aufgerufen,  per  “rts” 
abgeschlossen,  darf  die  Register  D0-D2  und  A0-A2  verandem  und  sollte  nicht  allzu  viel  Zeit 
verbrauchen. 


Der  Cookie  Jar 

Einleitung 

Beim  “Cookie  Jar”  (“Keksdose”)  handelt  es  sich  im  Grunde  genommen  um  eine  Generalisierung 
der  Systemvariablen.  Die  wichtigsten  Unterschiede: 

-  Der  Cookie  Jar  ist  eine  Tabelle,  von  der  nur  die  Basisadresse  bekannt  ist.  Damit  kann  sie 
bei  Bedarf  verlangert  und  im  Speicher  umhergeschoben  werden. 

-  Jeder  Eintrag  im  Cookie  Jar  hat  eine  (hoffentlich)  eindeutige  Kennung.  Damit  hat  man 
die  Moglichkeit,  auch  selbst  Eiritrage  fiir  eigene  Zwecke  vorzunehmen. 

“Cookie”  ist  ein  im  Atari-Slang  gebrauchlicher  Terminus  und  steht  fiir  meist  32  Bits  groBe 
Codenummem.  Meistens  interpretieit  man  sie  als  vier  ASCII-Zeichen,  die  eine  Abkiirzung 
liber  den  jeweiligen  Verwendungszweck  enthalten.  Zu  jedem  Cookie  gehort  ein  32  Bits  groBer 
Eintrag,  der  je  nach  Cookie  verschiedene  Bedeutungen  haben  kann.  Meist  handelt  es  sich  um 
Zeiger  auf  weitere  Strukturen  oder  um  Versionsnummem.  Der  “Cookie  Jar”  ist  nichts  anderes 
als  ein  Array  von  Cookies  und  ihren  Werten. 


Einige  Anwendungsbeispiele 

“MACCEL3”,  der  Mausbeschleuniger  von  Atari  (gehort  zum  Lieferumfang  von  Mega  STE 
und  TT),  tragt  in  den  Cookie  Jar  einen  Zeiger  auf  eine  programminteme  Struktur  ein,  mit  deren 
Hilfe  man  im  laufenden  Betrieb  seine  Parameter  verstellen  kann  (MACCEL3  benutzt  aller- 
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dings  einen  Cookie,  der  nicht  aus  ASCH-Zeichen  besteht-  wohl  deshalb,  weil  sein  Vorganger 
MACCEL2  vor  der  eigenrtichen  Definition  des  Cookie  Jar  entstanden  ist).  In  diesem  Fall  wird 
der  Cookie  also  von  einem  residenten  Utility  installiert,  das  iiber  den  Cookie  Datenstrukturen 
zur  Konfiguration  nach  “auBen”  fiihrt.  Diese  Schnittstelle  kann  dann  von  einem  Accessory 
oder  einem  Kontrollfeld-Modul  genutzt  werden. 

Das  BIOS  tragt  ab  TOS  1 .06  die  sogenannten  System-Cookies  ein,  mit  Hilfe  derer  man  detail- 
lierte  Informationen  uber  die  installierte  Hardware  erfragen  kann. 


Aufbau  des  Cookie  Jar 

Der  Zeiger  bei  Adresse  $5A0  (“_p_cookies”)  ist  entweder  0  (dann  ist  noch  kein  Cookie  Jar 
installiert),  oder  er  zeigt  auf  eine  Tabelle  von  Paaren  von  32-Bit-Werten. 

Im  ersten  steht  jeweils  die  Identifikation  in  Form  von  vier  ASCII-Zeichen.  Bei  der  Definition 
eigener  Kennungen  sollte  man  folgendes  beachten: 

-  Mit  beginnende  Kennungen  sind  fiir  Atari  reserviert. 

-  Die  vier  Buchstaben  sollten  im  engsten  Sinne  “druckbar”  sein  (ASCII-Codes  zwischen 
32  und  126,  keine  nationalen  Sonderzeichen!). 

-  Die  vier  Buchstaben  sollten  eine  Abkiirzung  ergeben,  aus  der  man  auf  das  zugehorige 
Programm  scblieBen  kann.  Varianten  der  Worter  “Cookie”,  “Vector”  u.  a.  gehoren  nicht 
dazu! 

Das  Ende  der  Liste  wird  durch  einen  “Nullcookie”  angezeigt  (also  $00000000),  der  als  Wert 
die  maximale  Anzahl  von  Eintragen  im  Cookie  Jar  enthalt. 


Abfrage  von  Cookies 

Es  ist  leicht,  Werte  existierender  Cookies  abzufragen  -  eine  Beispielfunktion  in  ANSI-C: 

/*  WORD  GetCookie  (LONG  cookie,  LONG  *value) 

"cookie"  im  Cookie  Jar  suchen. 

Bei  Erfolg  wird  der  Wert  in  "value"  abgelegt  und  als 
Funktionswert  TRUE  zuriickgeliefert .  Anderenfalls  erhalt 
man  FALSE.  */ 
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WORD  GetCookie  (LONG  cookie,  LONG  *value) 

{ 

LONG  oldstack; 

LONG  *cookiejar; 

/*  Zeiger  auf  Cookiejar  holen  */ 

oldstack  =  Super  (OL) ; 
cookiejar  =  *((LONG  **) 0x5a0L) ; 

Super  ((void  *) oldstack); 

/*  Cookiejar  uberhaupt  vorhanden?  */ 
if  (cookiejar  =  OL) 
return  FALSE; 
do 
{ 

/*  Cookie  gefunden?  */ 
if  (cookiejar [0]  ~  cookie) 

{ 

/*  nur  eintragen,  wenn  "value"  kein  Nullpointer  */ 
if  (value) 

*value  =  cookiejar [1] ; 
return  TRUE; 

} 

else 

( 

/*  nachsten  Cookie  nehmen  */ 
cookiejar  =  &  (cookiejar [2] ) ; 

} 

}  while  (cookiejar [-2] ) ;  /*  Nullcookie?  */ 
return  FALSE; 

} 


Installation  eigener  Cookies 

Wie  tragt  man  nun  “semen”  Cookie  in  die  Liste  ein?  Dazu  stellt  man  zunachst  fest,  wie  lang 
die  Liste  eigentlich  ist  (also  vom  Beginn  der  Liste  an  nach  dem  “Nullcookie”  suchen,  dessen 
Wert  ja  die  Lange  der  Liste  anzeigt).  Da  eben  dieser  Nullcookie  auch  das  Ende  der  Liste 
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anzeigt,  muS  man  nur  dort  seinen  eigenen  Cookie  hineinkopieren  und  den  Nullcookie  um 
einen  Eintrag  zum  Ende  hin  zu  verschieben. 

War  die  Liste  allerdings  schon  voll,  dann  bleibt  nichts  anderes  iibrig,  als  Platz  fur  eine  neue 
(langere)  Liste  zu  allozieren,  die  alten  Eintrage  dorthin  zu  kopieren  und  “_p_cookies” 
umzubiegen.  Wenn  man  schon  dabei  ist,  sollte  man  vielleicht  gleich  mehr  Platz  als  fur  einen 
zusatzlichen  Cookie  schaffen. 

Dies  geht  logischerweise  nur  in  Programmen,  die  sich  nach  ihrem  Auffuf  mittels  “Ptermres()” 
resident  im  Speicher  verankem.  Andere  Programme  oder  Acessories  konnen  und  diirfen  keine 
Cookies  installieren!  Statt  dessen  sollte  das  AES-Message-Passing  oder  die  Environment- 
Variablen  benutzt  werden. 

Bleibt  noch  die  Frage:  wie  kann  man  einen  Cookie  wieder  entfemen?  Leider  reicht  es  nicht, 
einfach  den  bestehenden  Eintrag  zu  “loschen”  (denn  was  soil  schon  ein  “leerer”  Eintrag  sein?). 
Also  kommt  man  nicht  umhin,  alle  folgenden  Cookies  innerhalb  des  Cookie  Jar  um  einen 
Eintrag  nach  vome  zu  kopieren. 

Das  ist  zwar  nicht  sonderlich  bequem,  aber  so  oft  wird  man  Cookies  ja  nicht  entfemen... 


Der  Cookie  Jar  vor  TOS  1.06 

Vor  TOS  1 .06  wurde  der  Cookie  Jar  noch  nicht  automatisch  installiert.  Dann  hat  “_p_cookies” 
den  Wert  0. 

Programme  konnen  allerdings  problemlos  einen  leeren  Cookie  Jar  anlegen  und  “_p_cookies” 
entsprechend  setzen.  Das  System  (und  alle  anschlieBend  geladenen  Programme)  verhalten 
sich  dann  genauso,  als  ware  der  Cookie  Jar  schon  immer  dagewesen. 

Nur  eine  Einschrankung  ist  zu  berucksichtigen:  bei  einem  Reset  wird  “_p_cookies”  nicht 
automatisch  geloscht.  Ein  Programm,  das  einen  neuen  Cookie  Jar  anlegt,  muB  sich  also  auch 
darum  kiimmem,  daB  “_p_cookies”  bei  einem  Reset  wieder  geloscht  wird! 

Dazu  ein  Beispielprogramm,  das  einen  leeren  Cookie  Jar  anlegt: 

;  cookie jr.s  ; 

;  Assembler:  MAS68 

;  Installiert  einen  40  Eintrage  langen 
;  Cookie  Jar,  sofern  noch  nicht  vorhanden 
;  beseitigt  ihn  ggfs.  bei  einem  Reset 
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RESMAGIC 

equ 

$31415926 

_resvalid 

equ 

$426 

resvector 

equ 

$42a 

_j?_cookies 

equ 

$5a0 

.text 


pea  Install 

raove.w  #38, -(sp)  ;  Supexec 

trap  #14  ,*  XBIOS 

addq.l  #6,sp 


tst.w  dO  ;  installiert? 

beq  Not Installed 


;  Installationsmeldung  ausgeben 


pea 

Success 

move . w 

#9,  - (sp) 

r 

Cconws 

trap 

#1 

T 

GEMDOS 

;  und  resident  halten 

move . 1 

4  (sp) ,  aO 

r 

Basepage 

move . 1 

#$100, dO 

r 

256  Bytes  Basepage 

add.l 

$C(aO) , dO 

r 

p  lten 

add.l 

$14 (aO) ,d0 

/ 

p_dlen 

add.l 

$lC(aO)  ,d0 

r 

p  blen 

clr  .w 

-  (sp) 

move . 1 

dO,- (sp) 

move.w  ' 

#49, -(sp) 

r 

Ptermres 

trap 

#1 

/ 

GEMDOS 

nstalled: 

pea 

Failure 

move . w 

#9,  - (sp) 

/ 

Cconws 

trap 

#1 

t 

GEMDOS 

clr .  w 

-(sp) 

r 

richtig  terminieren 

trap 

#1 

r 

GEMDOS  Pterm 

all: 

clr  .w 

dO 

BIOS  und  XBIOS 


77 


tst.l 

_p_cookies  ;  schon  installiert? 

beq 

Installlt 

rts 

;  Schlufi ! 

Installlt: 

moveq 

#l,d0 

move .  1 

#NewCookies,_p  cookies 

move .  1 

resvalid, OldValid 

move . 1 

#RESMAGIC,  __resvalid 

move .  1 

resvector, OldReset 

move . 1 

rts 

#NewReset,  resvector 

dc.b 
OldReset : 

dc.l 
NewReset : 
clr.l 
move . 1 
move .  1 
jmp 

.data 

Success : 

.dc.b  "cookie jr:  Cookie jar  for  40  cookies 

installed. ",13,10,0 

Failure: 

.dc.b  "cookiejr:  Cookiejar  already  in  use. ",13,10,0 

NewCookies : 

.dc.l  0,40  ;  40  Stuck 

.dcb.l  78,0  ;  78  mal  0 

.bss 

OldValid: 

.ds.l  1 


"XBRACKJR"  ;  XBRA-Struktur 

0 

_p_cookies  ;  wieder  loschen 

OldReset , _resvector 
OldValid, _resvalid 
(a6) 


.end 
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Vom  BIOS  belegte  Cookies 

Ab  TOS  1 .06  wird  der  Cookie  Jar  automatisch  bei  der  Systeminitialisierung  installiert  und  mit 

einigen  Informationen  iiber  den  benutzen  Rechner  versehen. 

Zur  Zeit  sind  folgende  Cookies  dokumentiert: 

CPU  -  Prozessortyp 

Hat  die  Werte  0, 10, 20, 30  oder40  fur  Rechner  mit  68000, 68010, 68020, 68030  oder  68040. 

FPU  -  FPU-Typ 

Dieser  Cookie  beschreibt,  auf  welche  Art  Hardware  und  Betriebssystem  die  Arbeit  mit 

FlielJkommazahlen  unterstiitzen.  Dabei  sind  verschiedene  Schnittstellen  denkbar: 

-  In  ST-  und  STE-Modellen  kann  der  68881  als  Peripheriebaustein  installiert  werden 
(beim  ST  und  STE  iiber  eine  Steckkarte  wie  die  SFP  004  von  Atari;  beim  Mega  STE  iiber 
einen  Steckplatz  auf  der  Hauptplatine). 

-  Bei  Systemen  mit  68020  oder  68030  kann  eine  eventuell  vorhandene  FPU  iiber  die  Line- 
F-Instruktionen  angesprochen  werden. 

-  Beim  68040  sind  die  meisten  Befehle  des  68882  direkt  in  der  CPU  eingebaut.  Einige 
wenige  Ausnahmen  werden  per  Software  emuliert.  Beim  Zugriff  iiber  Line-F  besteht 
vollstandige  Kompatibilitat. 

-  Bei  Rechnem  mit  TOS  1.06  oder  neueren  TOS-Versionen  ist  es  denkbar,  nachtraglich 
einen  Line-F-Treiber  (fur  Softwareemulation  oder  fur  den  Zugriff  auf  einen  als 
Peripheriebaustein  betriebenen  68881)  zu  betreiben. 

Das  obere  Wort  beschreibt  den  Typ  des  benutzten  Floating-Point-Koprozessors: 

Bit  0:  falls  gesetzt:  SFP  004  oder  kompatible  FPU-Karte  (68881  als  Peripheriebau¬ 

stein) 

Bit  1..2:  68881  oder  68882  als  Koprozessor,  im  Detail: 

0:  weder  -  noch 

1;  68881  oder  68882,  Typ  unbekannt 
2:  68881 
3:  68882 

falls  gesetzt;  68040 


Bit  3: 
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68881  und  68882  sind  von  der  Softwareseite  her  praktisch  vollstandig  kompatibel.  Daher 
macht  sich  das  BIOS  des  TT  auch  keine  Miihe,  den  genauen  Typ  zu  erkennen.  Software,  die 
die  genaue  Typenbezeichnung  braucht,  kann  diese  Information  selbst  zu  ermitteln  versuchen 
und  den  Cookie  entsprechend  korrigieren. 

Das  untere  Wort  ist  fur  Informationen  iiber  Softwareunterstiitzung  via  Line-F-Trap  reserviert 
und  ist  zur  Zeit  noch  nicht  benutzt,  Laut  Atari  bedeutet  ein  Wert  ungleich  0,  daB  Line-F-Unter- 
stiitzung  vorhanden  ist. 

Fiir  den  Anwendungsprogrammierer  sind  eigentlich  nur  zwei  Fragen  interessant: 

1.  Hat  der  Rechner  eine  als  Peripheriebaustein  installierte  FPU?  Hierfiir  sollte  man  bei 
vorhandenem  FPU-Cookie  Bit  0  des  oberen  Werts  testen.  Ist  der  Cookie  nicht  vorhanden 
(zum  Beispiel  in  Versionen  vorTOS  1.06),  muB  man  direkt  die  Hardwareadressen  iiber- 
prtifen  (Lbschen  des  LONG-Werts  an  Adresse  $FFFFFA46  fiihrt  zum  Bus-Error). 

2.  Konnen  die  Line-F-Instruktionen  fiir  Floating-Point-Berechnungen  benutzt  werden? 
Hierzu  reicht  es,  den  FPU-Cookie  zu  testen.  Wenn  das  obere  Wort  einen  Wert  groBer  1 
Oder  das  untere  Wort  einen  Wert  ungleich  0  hat,  sind  Line-F-Instruktionen  erlaubt. 


JFRB  -  Fast-RAM-Buffer 

Da  das  “Fast  RAM”  des  TT  fiir  normale  ACSI-DMA-Transfers  nicht  benutzt  werden  kann, 
legt  das  BIOS  auf  solchen  Rechnem  einen  64  KByte  groBen  Puffer  im  ST-RAM  an,  dessen 
Adresse  man  hier  vorfindet.  Geratetreiber  fiir  die  ACSI-SchnittsteUe  dtirfen  diesen  Puffer  als 
temporaren  Zwischenspeicher  fiir  Transfers  in  das  Fast-RAM  nutzen.  Der  Zugriff  wird  iiber 
die  Systemvariable  “flock”  koordiniert. 

Wenn  dieser  Cookie  nicht  da  ist,  verfiigt  die  Maschine  entweder  iiber  kein  Fast-RAM  oder 
keine  ACSTSchnittstelle. 

_MCH  -  Maschinentyp 

Beschreibt  den  benutzten  Rechnertyp.  Das  obere  Wort  bezeichnet  die  Rechnerfamilie: 

0:  ST  (520ST,  1040ST  und  Mega  ST  und  ahnliche) 

1 :  STE  (1040  STE,  Mega  STE) 

2:  TT 


Das  untere  Wort  dient  fiir  feinere  Unterscheidungen  und  ist  zur  Zeit  nur  beim  Mega  STE 
(0x0010)  ungleich  0. 
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_SND  -  Soundhardware 

Bittabelle,  die  die  vorhandenen  Soundmoglichkeiten  beschreibt. 

Bit  0:  GI/ Yam  aha  Sound  Chip  wie  in  bisher  alien  bekannten  Rechnem 
Bit  1:  Stereo-DMA-Sound  (wie  beim  STE  und  dem  TT) 

_SWI- DIP-Switches 

Werte  der  “Konfigurationsschalter”  (Dip-Schalter),  falls  vorhanden. 

_VDO  -  Videohardware 

Beschreibt  die  verfiigbare  Videohardware.  Das  obere  Wort  wird  fUr  die  grobe  Klassifizierung 
benutzt.  Das  untere  Wort  ist  fiir  feinere  Unterscheidungen  reserviert. 

0:  ST 
1:  STE 
2:  TT 


Weitere  von  Atari  benutzte  Cookies 


Neuere  Systemsoftware  bzw.  Patchprogramme  benutzen  ebenfalls  den  Cookie  Jar: 


Cookie  Programm 

_FDC  Dieser  Cookie  kann  von  Treibersoftware  fiir  Floppycontroller  hoherer 

Schreibdichte  installiert  werden.  Das  oberste  Byte  gibt  iiber  die  Art  der 
hochsten  Schreibdichte  im  System  Auskunft: 


Wert 


Bedeutung 


0  normales  Floppyinterface  (zum  Beispiel  720K  bei  doppelseitigen  Dis- 
ketten) 

1  “High-Density”  (HD,  1 ,44  MByte  bei  3,5-Zoll-Disketten) 

2  “Extra  High  Density”  (ED,  2,88  MByte) 


Damit  ist  naturlich  noch  nicht  garantiert,  daB  tatsachlich  ein  solches  Laufwerk 
angeschlossen  und  eine  passende  Diskette  eingelegt  ist! 


Alle  weiteren  Werte  sind  fiir  kiinftige  Erweiterungen  reserviert.  Die  restlichen 
drei  Bytes  beschreiben  den  Ursprung  der  Controller-Hardware: 
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Wert 

Bedeutiing 

$000000 

keine  Information  verfiigbar 

$415443 

(“ATC”)  Die  Hardware  ist  entweder  Teil  des  Systems  oder  ist 
nachtraglich  auf  solche  Art  und  Weise  in  das  System  integriert 
worden,  dafi  sie  sich  genauso  wie  ein  Teil  der  Originalhardware 
einer  Atari-Maschine  verhalt. 

$445031 

(“DPI”)  Die  Hardware  entstammt  einem  Bausatz  der  Firma 
“DreamPark  Development”. 

Alle  anderen  mit  “DP”  beginnenden  Kennungen  sind  ebenfalls 
fiir  diesen  Hersteller  reserviert. 

andere 

Hardwareentwickler  kdnnen  sich  vom  Atari-Entwickler-Support 
eigene  Kennungen  zuteilen  lassen. 

_FLK  Wenn  dieser  Cookie  existiert,  dann  verfiigt  das  installierte  Gemdos  liber  File- 

Locking-Erweiterungen  (Wert  des  Cookies  ist  die  Versionsnummer  der  Erwex- 
terung). 

_INF  STEFIX.  Patchprogramm  fiir  Fehler  im  Desktop  von  TOS  1.06. 

_NET  Flag  fiir  GEMDOS-Netzwerkerweiterungen.  Der  Inhalt  des  Cookies  ist  ein 

Zeiger  auf  zwei  LONG-Werte.  Der  erste  enthalt  eine  Herstellerkennung  fiir  das 
Netzwerk,  der  zweite  die  vom  Hersteller  vergebene  Versionsnummer. 

_OOL  POOLFIX3.  Patchprogramm  fiir  Fehler  in  GEMDOS-Version  0. 1 5. 

__SLM  Diablo-Treiber  fiir  SLM-Laserdrucker  (Wert  zeigt  auf  nicht  dokumentierte 

Struktur). 

AuBerdem  benutzt  auch  der  Maus-Beschleuniger  “MACCEL3”  den  Cookie  Jar. 

Der  Cookie  selbst  besteht  jedoch  nicht  aus  druckbaren  ASCII-Zexchen. 


Das  XBRA-Verfahren  fiir  vektorverbiegende 
Programme 

Speicherresidente  Programme,  die  Vektoren  verbiegen,  haben  stets  zwei  Probleme: 

-  Sie  konnen  den  Vektor  nur  schwer  zuriicksetzen,  da  sich  ja  unter  Umstanden  mittlerweile 
ein  anderes  Programm  in  den  gleichen  Vektor  gehangt  haben  konnte. 

-  Sie  konnen  aus  dem  gleichen  Grund  nur  schwer  uberpriifen,  ob  sie  bereits  mstalliert  sind. 
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Das  hier  angegebene  XBRA- Verfahren  (“extended  BRAner”)  wurde  erstmals  1 988  im  “Atari 
ST  Profibuch”  vorgeschlagen  und  geht  auf  eine  Idee  von  Moshe  Braner  zuriick,  die  nur  in 
einem  Punkt  etwas  erweitert  wurde.  Jedes  vektorverbiegende  Programm  plaziert  direkt  vor 
seiner  eigenen  Einsprungadresse  (also  genau  vor  der  Adresse,  auf  die  der  Vektor  gesetzt 
wurde)  folgende  Struktur: 

typedef  struct 

{ 

char  xb_mag±c [ 4 ] ; 
char  xb_id[4]; 

LONG  xb_oldvec; 

}  XBRA; 

Die  Konstante  “xb_magic”  wurde  binzugefiigt,  um  eine  hundertprozentige  Erkennung  der 
XBRA-Struktur  zu  ermoglichen.  Mit  diesen  zusatzlichen  Informationen  konnen  Programme 
leicht  feststellen,  ob  sie  schon  installiert  sind,  und  sich  leicht  aus  der  Vektorkette  ausklinken. 

Ohne  Ubertreibung  kann  man  sagen,  da8  sich  das  XBRA- Verfahren  vollstandig  durchgesetzt 
hat.  Mittlerweile  wird  es  gemeinhin  als  schlechter  Programmierstil  angesehen,  wenn  man  es 
nicht  benutzt.  Selbst  Atari  Amerika  verbiegt  in  eigenen  Utilities  und  Patchprogrammen  die 
Vektoren  mittlerweile  XBRA-kompatibel. 

Es  ist  erstrebenswert,  daB  es  nicht  zu  Doppeltbelegungen  von  XBRA-Kennungen  kommt. 
Daher  fiihrt  der  Autor  die  sogenartnte  “XBRA-Liste”,  in  der  offiziell  gemeldete  Kennungen 
eingetragen  werden  und  die  in  regelmafiigen  Abstanden  in  Fachzeitschriften  veroffentlicht 
wird.  Anfragen  bitte  (vollstandig  mit  Autor  und  Bezugsquelle  fiir  das  betreffende  Programm 
und  einer  Aufstellung  der  benutzten  Systemadressen)  an: 

Julian  Reschke 
Redaktion  ST-Magazin 
Markt  &  Technik  Verlag  AG 
Hans-Pinsel-StraBe  2 


/*  "XBRA"  =  0x58425241  */ 

/*  vier  Buchstaben  lange  Kennung  wie  beim 
Cookie  Jar  */ 

/*  urspriinglicher  Wert  des  Vektors  */ 


8013  Haar  bei  Miinchen 
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BIOS-Referenz 


Bconin  (BIOS  2) 

Liest  ein  Zeichen  von  einem  Eingabegerat  ein,  sobald  es  verfiigbar  ist.  Daher  sollte  man  diese 
Funktion  nach  Moglichkeit  zusammen  mit  “Bconstat()”  verwenden! 

Deklaration  in  C: 

LONG  Bconin  (WORD  dev) ; 

Aufruf  in  Assembler: 

move.w  dev, -(sp)  ;  Offset  2 

move.w  #2,-(sp)  ;  Offset  0 

trap  #13 

addq.l  #4,sp 

Parameter: 

dev:  Nummer  des  betreffenden  Eingabegerats: 

PRT  (0):  parallele  Schnittstelle 

AUX  (I):  serielle  Schnittstelle 

CON  (2):  Konsole  (VT-52) 

MIDI  (3):  MIDI 

Bconin():  Bits  0..7:  das  eingelesene  Zeichen 

Bemerkungen 

Fiir  das  Gerat  “CON”  enthalten  die  Bits  16..23  den  Scancode  der  betreffenden  Taste.  Ist 
zusatzlich  das  entsprechende  Bit  in  der  Systemvariable  conterm  gesetzt,  dann  fmdet  man  in 
den  Bits  24-3 1  den  aktuellen  Wert  von  “KbshiftO”. 
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Bconout  (BIOS  3) 

Gibt  ein  Zeichen  auf  dem  angegebenem  Gerat  aus  (und  kehrt  erst  dann  zuriick,  wenn  das 
Zeichen  tatsachlich  ausgegeben  worden  ist  -  also  Vorsicht  bei  Benutzung  des  Druckers  u.a.). 

Deklaration  in  C: 

void  Bconout  (WORD  dev,  WORD  c) ; 


Aufruf  in  Assembler: 

move.w  c, -<sp)  ;  Offset  4 

move.w  dev, -(sp)  ;  Offset  2 

move.w  #3,-(sp)  ;  Offset  0 

trap  #13 

addq.l  #6,sp 

Parameter: 

dev:  Nummer  des  betreffenden  Ausgabegerats: 

PRT  (0):  parallele  Schnittstelle 

AUX  (1):  serielle  Schnittstelle 

CON  (2):  Konsole  (VT-52) 

MIDI  (3):  MIDI-Schnittstelle 

IKBD  (4):  Tastatur-Prozessor 

RAWCON  (5):  Konsole  (ohne  Terminalemulation) 

c:  Auszugebendes  Zeichen 

Bemerkungen 

Man  beachte,  daB  aufgrund  eines  Fehlers  die  mit  “SetprtO”  gemachten  Einstellungen  ignoriert 
werden. 

Die  Zeichenausgabe  iiber  “RAWCON”  ist  Ubrigens  ein  ganzes  Stuck  schneller  als  die  liber 
“CON”,  da  die  VT52-Sequenzen  nicht  ausgewertet  werden  miissen. 

Fiir  den  Drucker  wird  im  Fehlerfall  0  zuriickgeliefert. 
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B  cons  tat  (BIOS  1) 

Stellt  den  Status  eines  Eingabegerates  fest. 

Deklaration  in  C: 

WORD  Bconstat  (WORD  dev) ; 

Aufruf  in  Assembler: 

move.w  devr-(sp)  ;  Offset  2 

move.w  #l,-(sp)  ;  Offset  0 

trap  #13 

addq.l  #4,sp 

Parameter: 

dev:  Nummer  des  betreffenden  Eingabegerats: 

AUX  (1):  serielle  Schnittstelle 

CON  (2):  Konsole  (VT-52) 

MIDI  (3):  MIDI-Port 

Bconstat():  0:  kein  Zeichen  verfiigbar 

-1 :  mindestens  ein  Zeichen  kann  eingeiesen  werden 

Bemerkungen 

Die  Gerate  “AUX”  und  “MIDI”  werden  per  Interrupt  betrieben,  mehr  dazu  unter  “Iorec()”, 
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Bcostat  (BIOS  8) 


Liefert  den  Ausgabestatus  eines  Ausgabegerats. 

Deklaration  in  C: 

LONG  Bcostat  (WORD  dev) ; 


Aufruf  in  Assembler: 

move.w  dev, -(sp)  ;  Offset  2 

move.w  #8,-(sp)  ;  Offset  0 

trap  #13 

addq.l  #4,sp 


Parameter: 

dev: 


BcostatQ: 


Nummer  des  betreffenden  Ausgabegerats: 

PRT  (0):  parallele  Schnittstelle 

AUX  (1):  serielle  Schnittstelle 

CON  (2):  Konsole  (VT-52) 

IKBD  (3):  Tastatur-Prozessor 

MIDI  (4):  MIDI-Schnittstelle 

RAWCON  (5):  Konsole  (ohne  Terminalemulation) 

0:  Zeichen  kann  noch  nicht  gesendet  werden 

—1:  Zeichen  kann  gesendet  werden 


Bemerkungen 

Man  beachte  die  Vertauschung  von  “MIDI”  und  “IKBD”  gegeniiber  den  anderen  BIOS- 
Funktionen!  Laut  Atari  wird  dies  aus  Kompatibilitatsgriinden  auch  so  bleiben. 
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Drvmap  (BIOS  10) 


Liefert  einen  Bitvektor  der  dem  BIOS  bekannten  logischen  Laufwerke. 


Deklaration  in  C: 

LONG  Drvmap  (void) ; 


Aufruf  in  Assembler: 

move.w  #$A, - (sp)  ;  Offset  0 

trap  #13 

addq.l  #2,sp 


Parameter: 

Drvmap():  Bitvektor  mit  den  vorhandenen  Laufwerken  (A:  Bit  0,  B:  Bit  1...). 

Es  sind  also  32  Gerate  moglich! 

Bemerkungen 

“DrvmapO”  liefert  den  Inhalt  der  Systemvariable  “_drvbits”  zuriick. 

Normalerweise  ist  es  interessanter,  welche  Laufwerke  GEMDOS  kennt.  Um  das  festzustellen, 
sollte  man  besser  die  GEMDOS-Funktion  “Dsetdrv()”  einsetzen. 
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Getbpb  (BIOS  7) 


Liefert  Adressen  auf  den  BIOS-Parameter-Block  des  betreffenden  Gerats  (springt  dazu  durch 
den  Vektor  “hdv_bpb”  ($472)): 


typedef  struct 
{ 

WORD  recsiz; 
WORD  clsiz; 
WORD  clsizb; 
WORD  rdlen; 
WORD  fsiz; 
WORD  fatrec; 
WORD  datrec; 
WORD  numcl; 
WORD  bflags; 


}  BPB; 


/*  Bytes  pro  Sektor  */ 

/*  Sektoren  pro  Cluster  (Einheit)  */ 

/*  Bytes  pro  Cluster  */ 

/*  Lange  des  Wurzelverzeichnis  in  Sektoren  */ 
/*  Lange  des  File  Allocation  Table  (FAT)  */ 

/*  Startsektor  der  zweiten  FAT  */ 

/*  Sektornummer  des  ersten  freien  Clusters  */ 
/*  Gesamtzahl  der  Cluster  auf  dem  Medium  */ 

/*  Bitvektor,  zur  Zeit  nur  Bit  0  belegt: 

0  (12-Bit-FAT) ,  1  (16-Bit -FAT)  */ 


Deklaration  in  C: 

BPB  * Getbpb  (WORD  dev) ; 


Aufruf  in  Assembler: 

move.w  dev,-(sp)  ;  Offset  2 

move.w  #7,-(sp)  ;  Offset  0 

trap  #13 

addq.l  #4,sp 

Parameter: 

dev:  Geratenummer  (A:  0,  B:  1,  C:  2...) 

Getbpb():  Zeiger  auf  den  BPB  des  Gerats  oder  im  FeMerfall  0  (zum  Beispiel,  wenn  die 

Informationen  im  Bootsektor  den  Verdacht  nahelegen,  daB  die  Diskette  nicht 
korrekt  formatiert  ist) 

Bemerkungen 

“GetbpbQ”  setztden  Mediachange-Status  im  BIOS  zuriick.  Weitere  Hinweise  dazu  finden  Sie 
in  der  Einfiihrung  zum  GEMDOS. 
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Getmpb  (BIOS  0) 


Diese  Funktion  dient  zur  Initialisierung  der  Speicherverwaltung.  Sie  wird  von  GEMDOS  ein 
einziges  Mai  beim  Starten  des  Systems  aufgerufen,  um  die  Ursprungs-TPA  zu  erzeugen  (mehr 
dazu  in  der  GEMDOS-Emfiihrung),  und  darf  anschliefiend  nicht  noch  einmal  aufgerufen  wer- 
den. 

“GetmpbO”  fullteine  Speicherparameter-Struktur  (Memory  Parameter  Block),  die  folgende 
Gestalt  hat: 

typedef  struct 
{ 

MD  *mp_mfl;  /*  Zeiger  auf  "Memory  Free  List"  */ 

MD  *mp_irial;  /*  Zeiger  auf  "Memory  Allocated  List"  */ 

MD  *mp_rover;  /*  roving  pointer;  wird  nur  intern  benotigt  */ 

}MPB; 

Die  MD-Struktur  hat  das  folgende  Format: 

typedef  struct  md 
{ 

struct  md  *m_link;  /*  Zeiger  auf  nachsten  MD  */ 

LONG  m_start;  /*  Anfangsadresse  des  Blocks  */ 

LONG  m_length;  /*  Lange  des  Blocks  */ 

BASEPAGE  *m_own;  /*  Zeiger  auf  Prozeil-Beschreibungsstruktur 

*/ 

}  MD; 

Jede  MD  enthalt  also  einen  Zeiger  auf  eine  weitere  Struktur  (verkettete  Liste)  sowie  die 
Anfangsadresse  und  die  Lange  des  entsprechenden  Speicherabschnitts. 

“m_own”  zeigt  auf  die  BASEPAGE-Struktur  des  Prozesses,  dem  der  Speicherblock  gehort. 


Deklaration  in  C: 

void  Getmpb  (MPB  *p_mpb) ; 
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Aufruf  in  Assembler: 

pea  p_mpb 

move.w  #Q,-(sp) 

trap  #13 

addq.l  #6,sp 

Parameter: 

p_mpb:  zeigt  auf  eine  vom  Programm  zur  Verfiigung  gesteilte  MPB-Struktur 


;  Offset  2 
;  Offset  0 
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Kbshift  (BIOS  11) 


Liefert  oder  verandert  den  momentanen  Tastaturstatus.  Die  Bitbelegung  sieht  folgenderma- 
I3en  aus: 


Bit 


Belegung 


BitO 
Bill 
Bit  2 
Bit  3 
Bit  4 
Bit  5 
Bit  6 
Bit  7 


Shift-Taste  rechts 
Shift-Taste  links 
Control-Taste 
Alternate-Taste 
CapsLock  gesetzt 
Maustaste  rechts  (ClrHome) 
Maustaste  links  (Insert) 
reserviert  (0) 


Deklaration  in  C: 

LONG  Kbshift  (WORD  mode) ; 


Aufruf  in  Assembler: 

move . w  mode, - (sp) 

move.w  #$B, - (sp) 

trap  #13 

addq.l  #4,sp 


;  Offset  2 
;  Offset  0 


Parameter: 

mode:  entweder  negativ  (dann  wird  nur  der  aktuelle  Status  zuriickgeliefert)  oder  >=0 

(dann  legt  mode  den  neuen  Status  fest) 

Kbshift():  aktueller  (bzw.  bisheriger)  Tastaturstatus 

Bemerkungen 

“KbshiftO”  ffagt  lediglich  eine  BlOS-inteme  Systemvariable  ab.  Deren  Adresse  kann  man  bei 
Bedarf  (also  zum  Beispiel  in  Interrupt-Routinen)  mit  Hilfe  von  “_sysbase”  berechnen. 
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Mediach  (BIOS  9) 

Stellt  fest,  ob  ein  Medienwechsel  stattgefunden  hat.  Fur  Disketten  sind  folgende  Hinweise  zu 
beach  ten:  die  Erkennung  eines  Diskettenwechsels  funktioniert  nur  dann  korrekt,  wenn  die 
Diskette  nicht  schreibgeschiitzt  ist.  Im  Zweifelsfall  ist  es  wichtig,  daB  Disketten  unterschied- 
liche  Seriennummem  tragen,  was  nicht  bei  alien  Formatierprogrammen  und  auch  nicht  bei 
unter  MS-DOS  formatierten  Disketten  gewahrleistet  ist. 

Doch  nicht  nur  Disketten  konnen  gewechselt  werden:  auch  bei  Wechselplatten  oder  CD- 
ROMs  (oder  anderen  “neuartigen”  Geraten)  kann  es  zu  einem  Medienwechsel  kommen. 

Daher:  Niemals  davon  ausgehen,  daB  ein  Gerat  nicht  wechselbar  ist! 

Deklaration  in  C: 

LONG  Mediach  (WORD  dev) ; 

Aufruf  in  Assembler: 

move.w  dev,-(sp)  ;  Offset  2 

move.w  #9,-(sp)  ;  Offset  0 

trap  #13 

addq.l  #4,sp 

Parameter: 

dev:  Nummer  des  Laufwerks  (A:  0,  B:  1,  C:  2...) 

Mediach():  0:  Medium  wurde  mit  Sicherheit  nicht  gewechselt 

1:  Medium  wurde  moglicherweise  gewechselt 

2:  Medium  wurde  mit  Sicherheit  gewechselt 

(endlich  einmal  dreiwertige  Logik!) 

Bemerkungen 

Normalerweise  wird  diese  Funktion  vom  GEMDOS  aufgerufen.  Dabei  sind  folgende  Falle 
moglich: 

Retum-Wert  0:  Alles  ist  in  Ordnung,  und  GEMDOS  arbeitet  normal  weiter. 

Retum-Wert  1:  GEMDOS  macht  einen  Lesezugriff,  um  einen  definitiven  Status  zu 

erfragen. 
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Return- Wert  2: 


GEMDOS  erkennt  den  Medienwechsel,  vergiflt  alle  Informationen  tiber 
das  Laufwerk  (siehe  in  der  GEMDOS -Einfiihrung  zum  Thema 
“Medienwechsel”)  und  ruft  “GetbpbO”  auf.  Dadurch  wird  dem  BIOS 
signalisiert,  daB  der  Medienwechsel  verarbeitet  ist  und  der  Status 
zuriickgesetzt  werden  kann. 
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Rwabs  (BIOS  4) 


Liest  und  schreibt  logische  Sektoren  von  Disketten  oder  anderen  Geraten,  die  iiber  die 
Harddisk- Vektoren  (ab  $46a,  “hdv_init”)  installiert  sind.  Dazu  gehoren  natiirlich  nicht  nur 
Festplatten,  sondem  auch  RAM-Disks  und  Cache-Programme.  Diese  BIOS-Routine  springt 
dazu  direkt  durch  den  Vektor  “hdv_rw”  ($476). 

Beim  Betrieb  von  Festplatten  kann  man  normalerweise  nur  auf  die  einzelnen  Partitionen 
zugreifen.  Um  Festplatten  partitionieren  zu  konnen,  mu8  man  allerdings  direkten  Zugriff  auf 
alle  Sektoren  der  Platte  haben. 

AHDI-3.0-kompatible  Festplattentreiber  kennen  daher  eine  Erweiterung,  die  den  direkten 
(physikalischen)  Zugriff  aus  die  Festplatten  zulaBt. 

Auch  der  Parameter  “lrecno”  ist  eine  Erweiterung,  die  es  nur  mit  AHDI-3.0-kompatiblen 
Festplattentreibem  gibt.  Damit  ist  es  moglich,  auf  mehr  als  65535  Sektoren  der  Platte  zuzu- 
greifen  (was  bei  Festplatten  mit  mehr  als  32  MByte  GroBe  natiirlich  sehr  wichtig  ist). 

Wie  stellt  man  fest,  ob  ein  solcher  Festplattentreiber  installiert  und  fiir  welche  Gerate  er 
zustandig  ist? 

Ganz  einfach:  Man  inspiziert  die  Systemvariable  “pun_ptr”,  die  auf  eine  Struktur  mit  alien 
notwendigen  Informationen  zeigen  sollte. 


Deklaration  in  C: 

LONG  Rwabs  (WORD  rwflag,  void  *buf,  WORD  count,  WORD  recno, 


WORD  dev. 

LONG 

lrecno) ; 

Aufruf  in  Assembler: 

move . 1 

lrecno,  -  (sp) 

t 

Offset 

14 

41 

move .w 

dev,  -  (sp) 

} 

Offset 

12 

move.w 

recno,- (sp) 

t 

Offset 

10 

'll 

move . w 

count , - ( sp) 

r 

Offset 

8 

/to 

pea 

buf 

/ 

Offset 

4 

b 

move.w 

rwflag, -(sp) 

r 

Offset 

2 

vdp 

move . w 

#4,  - (sp) 

t 

Offset 

0 

trap 

#13 

lea 

$12 (sp) , sp 

tnl l/_  /V  ' 
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Parameter: 


dev:  Im  Normalmodus:  Nummer  des  logischen  Laufwerks  (A:  0,  B:  1,  C:  2,..). 

Im  “physikalischen”  Modus:  2  plus  Geratenummer  (also  2.. 9  fur  ACSI-Platten, 
10..  17  fur  SCSI-Platten). 

recno:  Nummer  des  ersten  Sektors  (bei  -1  wird  start  dessen  “lrecno”  benutzt) 

lrecno:  dieser  Parameter  wird  nur  benutzt,  wenn  “recno”  -1  ist  und  man  einen  AHDI- 

3.0-kompatiblen  Festplattentreiber  benutzt  (siehe  unter  “pun_ptr”) 
count:  Anzahl  der  zu  iibertragenden  Sektoren 

buf:  Anfangsadresse  des  Puffers  (darf  auf  ungerader  Adresse  liegen,  was  allerdings 

die  Geschwindigkeit  verringert!) 
rwflag:  Bitvektor,  der  die  Art  der  Operation  festlegt; 

BitO:  lesen  (0)  Oder  schreiben  (1) 

Bit  1:  Medienwechsel  beachten  (0)  oder  ignorieren  (1) 

Bit  2:  Im  Fehlerfall  “Retry”  versuchen  (0)  oder  nicht  (1 )  (nur  bei  zu  AHDI  3.0 
kompatiblen  Festplattentreibem) 

Bit  3;  Normalmodus  (0)  oder  “physikalischer”  Modus  (1)  (nur  bei  zu  AHDI 
3.0  kompatiblen  Festplattentreibem) 

Rwabs():  0  (OK)  Oder  eine  BIOS-Fehlermeldung 
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Setzt  und  liest  die  Inhalte  von  Exception-Vektoren. 

Die  Vektoren  2  bis  255  sind  durch  die  Exceptions  der  CPU  belegt.  Ihre  Vektoren  liegen  an 
den  Adressen  $8  bis  einschlieBlich  $3FF. 

Die  acht  weiteren  Vektoren  256  bis  263  sind  fur  GEMDOS  reserviert  und  liegen  zur  Zeit  an 
den  Adressen  $400  bis  $41F.  Das  mufi  natiirlich  nicht  unbedingt  so  bleiben.  Mehr  zu  den 
GEMDOS- Vektoren  frnden  Sie  im  entsprechenden  Abschnitt  der  GEMDOS-EinfiLhrung. 

Deklaration  in  C: 

LONG  Setexc  (WORD  vecnum,  void  (*vec)  ()); 

Aufruf  in  Assembler: 

pea  vec 

move . w  vecnum, - ( sp) 
move.w  #5,-(sp) 

trap  #13 

addq.l  #8,sp 

Parameter: 

vecnum:  Nummer  des  zu  setzenden  Exception- Vektors  (ist  identisch  mit  der  zu  setzen- 

den  Adresse,  dividiert  durch  4) 

vec:  Neue  Adresse  (oder  -1,  wenn  diese  nicht  verandert  werden  soil) 

SetexcQ:  Bisheriger  (bzw.  aktueller)  Wert  des  Vektors 


;  Offset  4 
;  Offset  2 
;  Offset  0 
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Tickcal  (BIOS  6) 

Liefert  den  Inhalt  von  “_timr_ms”,  also  die  Anzahl  von  Millisekunden  zwischen  zwei 
Aufrufen  des  Systemtimers. 

Deklaration  in  C: 

LONG  Tickcal  (void) ; 

Aufruf  in  Assembler: 

move.w  #6,-(sp)  ;  Offset  0 

trap  #13 

addq.l  #2,sp 

Parameter: 

Tickcal():  Anzahl  der  Millisekunden 
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XBIOS-Referenz 


Bconmap  (XBIOS  44)  -  nicht  auf  alien  TOS-Versionen 


Mit  dieser  Funktion  kann  dem  BIOS-Kanal  1  (serielle  Schnittstelle)  eine  der  erweiterten 
Kanalnummemzugeordnetwerden.DiebisherzugeordneteKanalnummerwirdzuruckgeliefert. 

Als  Sonderfall  kann  ein  Zeiger  auf  die  BCONMAP-Struktur  abgeff  agt  werden,  iiber  die  man 
die  maximal  erlaubte  BIOS-Geratenummer  abfragen  und  neue  Geratetreiber  installieren  kann 
(siehe  Einleitung  zum  XBIOS). 

“BconmapO”  beeinfluBt  einerseits  die  BlOS-Vektortabelle  in  den  Systemvariablen  (begin- 
nend  bei  “xconstat”,  Adresse  $5 1 E).  Andererseits  wird  auch  das  Verhalten  von  “RsconfO”  und 
“Iorec()”  entsprechend  modifiziert. 


Deklaration  in  C: 

LONG  Bconmap  (WORD  devno) ; 


Aufruf  in  Assembler: 

move . w  devno , - ( sp) 

move.w  #$2C,-(sp) 

trap  #14 

addq.l  #4,sp 


;  Offset  2 
;  Offset  0 


Parameter: 

devno:  -2:  Zeiger  auf  BCONMAP-Struktur  zuriickliefem 

—1 :  Nur  aktuelle  Kanalnummer  abfragen 

0:  Test,  ob  “BconmapO”  vorhanden  ist 

>=6:  Neue  Kanalnummer 

bei  ungiiltigen  Angaben  (kleiner-3  oder  zwischen  0  und  5)  wird  0  zuriickgeliefert 
BconmapO:  fur  devno  =  -2:  Zeiger  auf  BCONMAP-Struktur 

sonst:  bisher  eingestellte  Kanalnummer 
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Bemerkungen 

Laut  Atari-Systemprogrammierer  Allan  Pratt  sollte  man  seine  TOS-Version  folgendermaGen 
auf  das  Vorhandensein  von  “BconmapQ”  testen: 

WORD  has_bcormap  (void) 

{ 

return  (OL  =  Bconmap  (0) ) ; 

) 
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Bioskeys  (XBIOS  24) 

Stellt  die  urspriingliche  Tastaturbelegung  (die  man  mit  “KeytblO”  andem  kann)  wieder  her. 

Deklaration  in  C: 

void  Bioskeys  (void)  ; 

Aufruf  in  Assembler: 

move.w  #$18,- (sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 
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Blitmode  (XBIOS  64)- erst  ab  TOS  1.02 

Diese  Funktion  dient  zur  Konfiguration  des  Blitter-Chips  (ab  TOS  1,02). 


Deklaration  in  C: 

WORD  Blitmode  (WORD  mode) ; 


Aufruf  in  Assembler: 

move.w  mode,-(sp)  ;  Offset  2 

move.w  #$40, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 

mode:  -I:  Status  der  Blitterregister  auslesen 

sonst:  Blitterbetrieb  wird  umgeschaltet. 

In  Bit  0  wird  folgende  Information  iibergeben: 

0:  Blitter  aus  (wird  durch  Bildschirmtreiber  nicht  benutzt) 

1 :  Blitter  an  (wird  durch  Bildschirmtreiber  benutzt) 

Bit  15  mu6  0  sein 
Blitmode():  Bisheriger  Blitterstatus: 

Bit  0:  Blitter  wird  nicht  benutzt  (0) 

Blitter  wird  benutzt  (I) 

Bit  1 :  kein  Blitter  installiert  (0) 

Blitter-Chip  vorhanden 
Bit  15:0 

Alle  weiteren  Bits  sind  reserviert 
Bemerkungen 

Obwohl  in  TOS  1 .00  nicht  vorhanden,  darf  man  laut  Atari  “BlitmodeO”  ohne  Versionsabfrage 
benutzen  (ein  Seiteneffekt  im  XBIOS -Dispatcher  macht  es  moglich).  Darauf  sollte  man  sich 
aber  besser  nicht  verlassen  -  vielleicht  gibt  es  ja  Programme,  die  den  XBIOS-Trap  “verbie- 
gen”  und  nicht  darauf  achten,  daJ3  fur  Opcode  64  der  gleiche  Retum-Wert  wie  beim  ROM 
zuriickgeliefert  wird. 
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Legt  verschiedene  Cursor-Attribute  fest  oder  fragt  die  Blinkfrequenz  des  Cursors  ab. 


Deklaration  in  C: 

WORD  Cursconf  (WORD  function,  WORD  operand) ; 


Aufruf  in  Assembler: 

move.w  operand, - (sp)  ;  Offset  4 

move.w  function, - (sp)  ;  Offset  2 

move.w  #$15, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 


Parameter: 

function:  CURS_HIDE  (0):  Cursor  ausschalten 

CURS_SHOW  (1):  Cursor  einschalten 

CURS_BLINK  (2):  Cursorblinken  einschalten 

CURS_NOBLINK  (3):  Cursorblinken  ausschalten 

CURS_SETRATE  (4):  Blinkrate  auf  “operand”  stellen 

CURS_GETRATE  (5):  Blinkrate  abfragen 

operand:  nur  bei  “CURS_SETR  ATE”  benutzt;  gibt  an,  nach  wie  vielen  Vertical  Blanks 

der  Cursor  einmal  invertiert  wird 
CursconfO:  bei  “CURS_GETRATE”  aktuelle  Blinkrate 
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DMAread  (XBIOS  42)  -  nicht  auf  alien  TOS-Versionen 


Liest  eine  Anzahl  von  Sektoren  von  einem  ACSI-  oder  SCSI-Gerat.  Der  zu  iibertragende 
Speicherbereich  muB  fiir  die  jeweilige  Hardware  beschreibbar  sein  (mehr  dazu  im  Hardwaxeteil). 

In  den  allermeisten  Fallen  ist  es  sinnvoller,  statt  dessen  die  Funktion  “RwabsQ”  zu  verwenden! 


Deklaration  in  C: 

LONG  DMAread  (LONG  sector,  WORD  count,  void  * buffer,  WORD  devno); 


Aufruf  in  Assembler: 


move . w 
pea 

move . w 
move . 1 
move . w 
trap 
lea 


devno,- (sp) 
buffer 
count, - (sp) 
sector, - (sp) 
#$2A, - (sp) 

#1 

$E  (sp) ,  sp 


;  Offset  12 
;  Offset  8 
;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

sector:  erste  Sektomummer 

count.  Anzahl  der  Sektoren 

buffer:  Anfangsadresse  im  Speicher 

devno:  Geratenummer  (0..7:  ACSI-Gerate  0..7,  8..  15:  SCSI-Gerate  0..7,  dariiber: 

reserviert  fiir  kiinftige  Erweiterungen) 

DMAwrite():  liefert  einen  BIOS-Fehlercode  zuriick  (0:  OK) 


Bemerkungen 

Gerate  am  SCSI-Bus  werden  von  dieser  Funktion  per  Handshake  (also  nicht  per  DMA) 
betrieben. 
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DMAwrite  (XBIOS  43)  -  nicht  auf  alien  TOS-Versionen 

Schreibt  eine  Anzahl  von  Sektoren  auf  ein  ACSI-  oder  SCSI-Gerat.  Der  zu  ubertragende 
Speicherbereich  muB  fur  die  jeweilige  Hardware  lesbar  sein  (mehr  dazu  im  Hardwareteil). 

In  den  allermeisten  Fallen  ist  es  sinnvoller,  statt  dessen  die  Funktion  “RwabsO”  zu  verwenden! 

Deklaration  in  C: 

LONG  DMAwrite  (LONG  sector,  WORD  count,  void  *buffer,  WORD  devno) ; 


Aufruf  in  Assembler: 

move . w 

devno, - (sp)  ; 

Offset 

12 

pea 

buffer  ; 

Offset 

8 

move . w 

count, -(sp)  ; 

Offset 

6 

move . 1 

sector, -(sp)  ; 

Offset 

2 

move . w 

#$2B,-(sp) 

Offset 

0 

trap 

#1 

lea 

$E (sp) , sp 

Parameter: 

sector: 

erste  Sektomummer 

count: 

Anzahl  der  Sektoren 

buffer:  Anfangsadresse  im  Speicher 

devno:  Geratenummer  (0..7:  ACSI-Gerate  0..7,  8.. 15:  SCSI-Gerate  0..7,  dariiber: 

reserviert  fiir  kiinftige  Erweiterungen) 

DMAwrite():  liefert  einen  BIOS-Fehlercode  zuriick  (0:  OK) 


Bemerkungen 

Gerate  am  SCSl-Bus  werden  von  dieser  Funktion  per  Handshake  (also  nicht  per  DMA) 
betrieben. 
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Dosound  (XBIOS  32) 


Mit  dieser  Funktion  kann  man  vollautomatisch  eine  Reihe  von  Werten  in  die  Register  des 
Soundchips  schreiben  lassen. 

Deklaration  in  C: 

void  Dosound  (const  char  *ptr) ; 

Aufruf  in  Assembler: 

pea  ptr  ;  Offset  2 

move.w  #$20, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,  sp 

Parameter: 

ptr:  Zeiger  auf  eine  Bytefolge  mit  Soundbefehlen.  Folgende  Befehlscodes  werden  unter- 

stutzt: 

$0x  byte:  Byte  in  Register  x  des  Soundchips  schreiben 

$80  byte:  Byte  in  temporares  Register  laden 

$81  bytel  byte2  byte3  (drei  Byte-Argumente!) 

bytel :  Nummer  des  Soundregisters,  in  das  der  Wert  des  temporaren 

Registers  iibertragen  werden  soli 
byte2:  wird  jeweils  zum  temporaren  Register  addiert 

by  te3 :  Endwert  des  temporaren  Registers,  bei  dem  die  “Schleife”  abge- 

brochen  wird 

$82-$FF  byte:  Anzahl  der  Jiffies  (20  ms),  die  bis  zum  nachsten  Kommando 
vergehen  sollen  (bei  byte  -  0  wird  vollstandig  abgebrochen) 
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EgetPalette  (XBIOS  85)  -  nur  fur  TT- Videohardware 


Liest  einen  zusammenhangenden  Bereich  aus  den  TT-Farbregistem  aus. 


Deklaration  in  C: 

void  EgetPalette  (WORD  colorNum,  WORD  count,  WORD  ^palettePtr) ; 


Aufruf  in  Assembler: 


pea 

move . w 
move . w 
move . w 
trap 
lea 


palettePtr 
count, - (sp) 
colorNum, - (sp) 
#$55, -(sp) 

#14 

$A  (sp)  ,  Sp 


;  Offset  6 
;  Offset  4 
;  Offset  2 
;  Offset  0 


Parameter: 

colorNum:  Nummer  des  ersten  auszulesenden  Farbregisters 
count:  Anzahl  der  auszulesenden  Farbregister 

palettePtr:  Zeiger  auf  zu  ubertragende  Farbtabelle  (mu8  auf  eine  gerade  Adresse  zeigen) 
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EgetShift  (XBIOS  81)  -  nur  fur  TT-Videohardware 

Fragt  den  Wert  des  Shiftmode-Registers  im  Video-Shifter  des  TT  ab. 

Deklaration  in  C: 

WORD  EgetShift  (void) ; 

Aufruf  in  Assembler: 

move.w  #$51,- (sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 

Parameter: 

EgetShift():  Wert  fiir  das  Modus-Register  des  TT-Shifters.  Bitbelegung: 

Bit  15:  Smear-Modus  (siehe  unter  “EsetSmearO”) 

Bit  12:  Hyper  Mono  (siehe  unter  “EsetGrayO”) 

Bit  10..8:  Modus,  wie  er  auch  von  “Getrez()”  zuriickgeliefert  wird 

Bit  3..0:  Nummer  der  Farbregister-Bank  (siehe  unter  “EsetBankQ”) 
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EsetBank  (XBIOS  82)  -  nur  fur  TT-Videohardware 

Die  256  Farbregister  des  IT  sind  in  1 6  verschiedene  Banke  unterteilt.  Mit  diesem  Kommando 
kann  man  die  aktive  Bank  auswahlen. 

Deklaration  in  C: 

WORD  EsetBank  (WORD  bankNum) ; 


Aufruf  in  Assembler: 

move.w  bankNum, - (sp)  ;  Offset  2 

move.w  #$52, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 

bankNum:  Nummer  der  neuen  aktiven  Bank  (0..15).  Bei  einem  negativen  Wert  wird  die 

Banknummer  nicht  geandert. 

EsetBankQ:  bisherige  Banknummer 
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EsetColor  (XBIOS  83)  -  nur  fur  TT- Videohardware 


Setzt  (sofort,  nicht  erst  im  nachsten  Vertical  Blank)  eines  der  256 Farbregister  des  TT-Shifters. 

Deklaration  in  C: 

WORD  EsetColor  (WORD  colorNum,  WORD  color) ; 

Aufruf  in  Assembler: 

move.w  color, -(sp)  ;  Offset  4 

move.w  colorNum, -(sp)  ;  Offset  2 

move.w  #$53, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 

Parameter: 

colorNum:  Nummer  des  zu  verandemden  Farbregisters  (0..255).  Bei  negativen  Werten 

wird  die  eingestellte  Farbe  nicht  verandert. 
color  neue  Farbe 

EsetColor():  bisheriger  Wert 
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EsetGray  (XBIOS  86)  -  nur  fur  TT- Videohardware 


Der  TT-Videochip  kennt  auch  einen  Graustufen-Modus,  in  dem  man  anstelle  von  4096 
Farbtonen  aus  einer  Graustufenpalette  von  256  Tonen  auswahlen  kann.  In  diesem  Modus  wird 
jeweils  nur  das  untere  Byte  eines  Eintrags  in  einem  Farbregister  benutzt. 

Dekiaration  in  C: 

WORD  EsetGray  (WORD  switch) ; 


Aufruf  in  Assembler: 

move.w  switch, - (sp)  ;  Offset  2 

move.w  #$56, -(sp)  ,*  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 

switch:  ungleich  0:  Graustufenmodus  einschalten 

EsetGray():  alter  Wert 
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EsetPalette  (XBIOS  84)  -  nur  fur  TT -Videohardware 


Setzt  (sofort)  einen  zusammenhangenden  Bereich  von  Farbregistem  in  der  Farbpalette  des 
TT-Shifters. 


Deklaration  in  C: 

void  EsetPalette  (WORD  colorNum,  WORD  count,  WORD  *palettePtr) ; 

Aufruf  in  Assembler: 

pea  palettePtr 

move . w  count , - ( sp ) 

move .w  colorNum,-(sp) 

move.w  #$54, -(sp) 

trap  #14 

lea  $A  ( sp) ,  sp 

Parameter: 

colorNum:  Nummer  des  ersten  zu  andemden  Farbregisters 
count:  Anzahl  der  zu  setzenden  Farbregister 

palettePtr:  Zeiger  auf  zu  iibertragende  Farbtabelle  (mu6  auf  eine  gerade  Adresse  zeigen) 


;  Offset  6 
;  Offset  4 
;  Offset  2 
;  Offset  0 


112 


ATARI  Profibuch 


EsetShift  (XBIOS  80)  -  nur  fur  TT-Videohardware 

Setzt  das  Shiftmode-Register  im  Video-Shifter  des  TT. 

Deklaration  in  C: 

WORD  EsetShift  (WORD  shftMode) ; 

Aufruf  in  Assembler: 

move.w  newmode, - (sp)  ;  Offset  2 

move.w  #$50, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 

Parameter: 

shftMode:  Neuer  Wert  fur  das  Modus-Register  des  TT-Shifters.  Bitbelegung: 

Bit  15:  Smear-Modus  (siehe  unter  “EsetSmearO”) 

Bit  12:  Hyper  Mono  (siehe  unter  “EsetGrayO”) 

Bit  10..8:  Modus,  wie  er  auch  von  “GetrezO”  zuruckgeliefert  wird 

Bit  3..0:  Nummer  der  Farbregister-Bank  (siehe  unter  “EsetBankO”) 

EsetShift():  alter  Wert  des  Registers 
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EsetSmear  (XBIOS  87)  -  nur  fur  TT-Videohardware 


Mitdieser  Funktionkannder  Smear-Modus  des  TT-Videobausteins  umgeschaltet  werden,  Im 
Smear-Modus  wird  anstelle  der  Hintergrundfarbe  (Farbe  0)  die  jeweils  zuletzt  dargestellte 
Farbe  gezeichnet. 


Deklaration  in  C: 

WORD  EsetSmear  (WORD  switch) ; 


Aufruf  in  Assembler: 

move.w  switch, -(sp)  ;  Offset  2 

move.w  #$57, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 

switch:  0:  Smear-Modus  aus 

>0:  Smear-Modus  ein 

<0:  nur  den  bisherigen  Wert  abfragen 

EsetSmear():  bisheriger  Wert 
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Flopfmt  (XBIOS  10) 

Formatiert  eine  Spur  auf  einer  Diskette. 

Declaration  in  C: 

WORD  Flopfmt  (void  *buf,  LONG  filler,  WORD  devno,  WORD  spt, 

WORD  trackno,  WORD  sideno,  WORD  interlv,  LONG  magic, 
WORD  virgin) ; 


Aufruf  in  Assembler: 


move . w 

virgin, - (sp) 

/ 

Offset 

24 

move . 1 

magic, - (sp) 

r 

Offset 

20 

move .w 

interlv, -(sp) 

/ 

Offset 

18 

move . w 

sideno, - (sp) 

r 

Offset 

16 

move . w 

trackno, - (sp) 

/ 

Offset 

14 

move . w 

spt, — (sp) 

t 

Offset 

12 

mo  vq . w 

devno,- (sp) 

f 

Offset 

10 

move . 1 

#0,  -  (sp) 

} 

Offset 

6 

pea 

buf 

i 

Offset 

2 

move . w 

#$A,  - (sp) 

t 

Offset 

0 

trap 

#14 

lea 

$1A  (sp) , sp 

Parameter: 

buf:  Zeiger  auf  einen  Speicherbereich,  in  dem  die  Daten  fur  die  Spur  temporar 

gespeichert  werden  konnen  (bei  neun  Sektoren  pro  Spur  mindestens  8  KByte, 
muB  bei  hoheren  Sektorzahlen  entsprechend  vergroBert  werden) 
filler:  bei  den  “alten”  TOS-Versionen  unbenutzt  (0). 

Ab  TOS  1.02  kommt  “filler”  eine  neue  Bedeutung  zu.  Ubergibt  man  als 
“interlv”  -1 ,  dann  wird  “filler”  als  Zeiger  auf  eine  Tabelle  von  Sektomummem 
benutzt  ( 1 6-Bit-Words).  Damit  hat  man  also  die  Moglichkeit,  die  Reihenfolge 
der  Sektoren  auf  der  Spur  frei  zu  wahlen. 
devno:  0:  Laufwerk  A: 

1:  Laufwerk  B: 

spt:  Sektoren  pro  Spur  (normalerweise  9).  Wenn  der  “_FDC”-Cookie  gesetzt  ist, 

sind  auch  18  Sektoren  (“High-Density”)  bzw.  36  Sektoren  (“Extra-High- 
Density”)  erlaubt. 
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Die  Umschaltung  zwischen  den  verschiedenen  Schreibverfahren  findet  bei  13 
(HD)  bzw.  26  (ED)  start. 

trackno:  Nummer  der  Spur  (0..79  oder  ggfs.  etwas  dariiber) 

sideno:  0  oder  1  (nur  bei  doppelseitigen  Disketten) 

interlv:  Bestimmt,  wie  viele  physikalische  Sektoren  jeweils  zwischen  zwei  logischen 

Sektoren  liegen  (noimalerweise  einer) 
magic:  $87654321,  sonst  wird  nicht  formatiert 

virgin:  Dieses  Bitmuster  wird  beim  Formatieren  in  jeden  Sektor  hineingeschrieben 

(normalerweise  $e5e5,  was  jeweils  abwechselnd  gesetzte  Bits  bedeutet).  Die 
oberen  vier  Bits  diirfen  auf  keinen  Fall  gleichzeitig  gesetzt  sein,  da  dieses 
Bitmuster  vom  Disk-Controller  als  Kommando  interpretiert  und  daher  zu 
Chaos  fiihren  wiirde. 

Flopfmt():  0:  alles  o.k. 

Bei  Formatierfehlem  wird  eine  durch  0  abgeschlossene  Liste  der  fehlerhaften 
Sektoren  in  den  Puffer  geschrieben. 

Bemerkungen 

Auch  das  Desktop  nutzt  ab  TOS  1 .02  die  Moglichkeit,  eine  Liste  von  Sektomummem  zu  iiber- 
geben.  Dies  erlaubt  es,  die  Spuren  untereinander  so  zu  “spiralisieren”,  daB  beim  Spurwechsel 
moglichst  wenig  Zeit  mit  dem  Warten  auf  den  “nachsten”  Sektor  vertan  wird. 
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Floprate  (XBIOS  41)  -  erst  ab  TOS  1.04 

Mit  dieser  TOS-Funktion  kann  man  ab  TOS  1 .04  die  Seekraten  (Spurwechselzeiten)  fiir  beide 
Laufwerke  setzen  und  abfragen.  Auf  alteren  ROM-TOS-Versionen  mufi  man  die  vorher 
undokumentierten  Systemvariablen  verwenden: 


TOS-Version 

Laufwerk  A 

Laufwerk  B 

1.00 

$A08 

$A0C 

1.02 

$A4E 

$A52 

Die  Seekrate  kann  folgende  Werte  annehmen: 


Wert 

Seekrate 

0: 

6ms 

1: 

12ms 

2: 

2ms 

3: 

3ms 

Deklaration  in  C: 

WORD  Floprate  (WORD  drive,  WORD  seekrate) ; 

Aufruf  in  Assembler: 

move.w  seekrate, - (sp)  ;  Offset  4 

move.w  drive, -(sp)  ;  Offset  2 

move.w  #$29, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 

Parameter: 

drive:  Nummer  des  Laufwerks  (0:  A,  1:  B) 

seekrate:  neue  Seekrate  oder  -1,  wenn  die  Seekrate  nicht  verandert  werden  soli 

FloprateO:  vorherige  Seekrate 

Bemerkungen 

Auf  der  folgenden  Seite  sehen  Sie  eine  Beispielroutine  zum  portablen  Setzen  der  Seekrate. 
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/*  Portables  Setzen  der  Floppy-Seekrate  fur  alle  TOS-Versionen 
(aufler  RAM-TOS  1.00) . 

Parameter:  genau  wie  bei  XBIOS-Funktion  "FloprateO"  */ 

WORD  SeekRate  {WORD  driv,  WORD  set) 

{ 

LONG  stack; 

WORD  version; 

OSHEADER  *sys; 

/*  Zeiger  auf  OS-Header  holen  */ 
stack  =  Super  (0L) ; 
sys  =  * ( (OSHEADER  **) 0x4f2)  ; 
version  =  sys->os_version; 

Super  { (void  *) stack) ; 

/*  bei  neuem  TOS  einfach  "FloprateO"  aufrufen  V 
if  (version  >=  0x104) 

return  Floprate  (driv,  set) ; 

else 

{ 

/*  sonst  Zeiger  auf  interne  GEMDOS-Variablen 
berechnen  */ 

WORD  *sk,  merk; 

if  (version  ==  0x102) 

sk  =  (WORD  *) 0xa4e; 

else 

sk  =  (WORD  *)0xa08; 

/*  Laufwerk  B:  2  WORDS  dahinter  */ 
if  (driv)  sk  =  &(sk[2]); 
merk  =  *sk; 

/*  Wert  nur  bei  ungleich  -1  eintragen  */ 
if  (set  !=  -1)  *sk  =  set; 


} 


/*  alten  Wert  immer  zuruckliefern  */ 
return  merk; 
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Floprd  (XBIOS  8) 


Liest  einen  oder  mehrere  physikalische  Sektoren  von  einer  Diskette  (vgl.  BIOS-Funktion 
“RwabsO”). 


Deklaration  in  C: 

WORD  Floprd  (void  *buf,  LONG  filler,  WORD  devno,  WORD  sectno, 
WORD  trackno,  WORD  sideno,  WORD  count) ; 


Aufruf  in  Assembler: 

move . w 

count,  -  (sp) 

Offset 

18 

move . w 

sideno, -(sp) 

Offset 

16 

move.w 

trackno, - (sp) 

Offset 

14 

move . w 

sectno, - (sp) 

Offset 

12 

move . w 

devno, -(sp) 

Offset 

10 

move . 1 

#0,  - (sp) 

Offset 

6  (unbenutzt) 

pea 

buffer 

Offset 

2 

move . w 

#8,  - (sp) 

Offset 

0 

trap 

#14 

lea  .. 

$14 (sp) , sp 

Parameter: 


buffer: 

filler: 

devno: 

sectno: 

trackno: 

sideno: 

count: 

Floprd(): 


Zeiger  auf  Speicherbereich  fur  die  eingelesenen  Sektoren 
unbenutzt 

0  (Laufwerk  A:),  1  (Laufwerk  B:) 

Nummer  des  Startsektors  (normalerweise  zwischen  1  und  9) 

Nummer  der  Spur  (normalerweise  zwischen  0  und  79) 

Seite  der  Diskette  (0  bei  einseitigen,  0  oder  1  sonst) 

Anzahl  der  zu  lesenden  Sektoren  (die  alle  auf  der  gleichen  Spur  liegen  miissen) 
0:  mit  Erfolg  abgeschlossen 
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Flopver  (XBIOS  19) 


Liest  eine  Reihe  von  physikalischen  Sektoren  von  der  Diskette  und  vergleicht  mit  einem 
gegebenen  Speicherbereich. 


Deklaration  in  C: 

WORD  Flopver  (void  *buf,  LONG  filler,  WORD  devno,  WORD  sectno, 
WORD  trackno,  WORD  sideno,  WORD  count) 


Aufruf  in  Assembler: 

move.w 

count, - (sp) 

Offset 

18 

move . w 

sideno, - (sp) 

Offset 

16 

move . w 

trackno, - (sp) 

Offset 

14 

move . w 

sectno, - (sp) 

Offset 

12 

move . w 

devno,- (sp) 

Offset 

10 

move . 1 

#0,- (sp) 

Offset 

6  (unbenutzt) 

pea 

buf 

Offset 

2 

move.w 

#$13, -(sp) 

Offset 

0 

trap 

#14 

lea 

$14 (sp) ,sp 

Parameter: 


buf: 

filler: 

devno: 

sectno: 

trackno: 

sideno: 

count: 

Flopver(): 


Adresse  des  zu  vergleichenden  Speicherbereiches 
unbenutzt  (kann  auf  0  gesetzt  werden) 

Nummer  des  Diskettenlaufwerks  (0:  A,  1 :  B) 

Nummer  des  Startsektors  (normalerweise  1..9) 

Nummer  der  Spur  (normalerweise  0..79) 

Diskettenseite  (0..1) 

Anzahl  der  zu  vergleichenden  Sektoren  (der  letzte  Sektor  muB  auf  der  gleichen 
Spur  liegen  wie  der  Startsektor) 

0:  kein  Fehler 

Ansonsten  findet  man  bei  “buf’  eine  (durcb  0  abgeschlossene)  Liste  der  fehler- 
haften  Sektoren. 
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Flopwr  (XBIOS  9) 


Schreibt  einen  oder  mehrere  physikalische  Sektoren  auf  eine  Diskette. 


Deklaration  in  C: 

WORD  Flopwr  (void  *buf,  LONG  filler,  WORD  devno,  WORD  sectno, 
WORD  trackno,  WORD  sideno,  WORD  count) ; 


Aufruf  in  Assembler: 

move . w 

count, - (sp) 

;  ->  24 (sp) 

move . w 

sideno, - (sp) 

;  Offset  16 

move . w 

trackno, - (sp) 

;  Offset  14 

move . w 

sectno, - (sp) 

;  Offset  12 

move . w 

devno, - (sp) 

;  Offset  10 

move . 1 

#0,- (sp) 

;  Offset  6  (unbenutzt) 

pea 

buffer 

;  Offset  2 

move . w 

#9,- (sp) 

;  Offset  0 

trap 

#14 

lea 

$14 (sp) , sp 

Parameter: 

buffer: 

Zeiger  auf  Speicherbereich  mit  den  zu  schreibenden  Sektoren 

filler: 

unbenutzt 

devno: 

0  (Laufwerk  A:),  1  (Laufwerk  B:) 

sectno: 

Nummer  des  Startsektors  (normalerweise  zwischen  1  und  9) 

trackno: 

Nummer  der  Spur  (normalerweise  zwischen  0  und  79) 

sideno: 

Seite  der  Diskette  (0  bei  einseitigen,  0  oder  1  sonst) 

count: 

Anzahl  der  zu  schreibenden  Sektoren  (die  alle  auf  der  gleichen 

miissen) 

Flopwr(): 

0:  mit  Erfolg  abgeschlossen 
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Getrez  (XBIOS  4)  -  nur  fur  ST/STE/TT- Videohardware 

Liefert  die  aktuelle  Bildschirmauflosung. 


Deklaration  in  C: 

WORD  Getrez  (void) ; 


Aufruf  in  Assembler: 


move.w  #4,-(sp) 

trap  #14 

addq.l  #2,sp 


Offset  0 


Parameter: 


Getrez(): 


0:  320  *  200  (vier  Planes) 

1:  640  *  200  (zwei  Planes) 

2:  640  *  400  (ein  Plane) 

4:  640  *  480  (vier  Planes,  nur  beim  TT) 

6:  1280  *  960  (ein  Plane,  nur  beim  TT) 

7  :  320  *  480  (acht  Planes,  nur  beim  TT) 

Alle  anderen  Werte  sind  fur  kiinftige  Erweiterungen  reserviert. 


Bemerkungen 

Sinnvoller  ist  es,  statt  dessen  die  Riickgabewerte  der  VDI-Funktion  “v_opnv  wk()”  auszu  wer- 
ten!  Speziell  dann,  wenn  eine  Grafikkarte  aktiv  ist,  hat  der  Riickgabewert  von  “GetrezO”  de 
facto  keinen  Aussagewert! 
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Liest  aus  der  Hardwareuhr  das  aktuelle  Datum. 


Deklaration  in  C: 

LONG  Gettime  (void) ; 

Aufruf  in  Assembler: 

move.w  #$17, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 

Parameter: 

Gettime():  Aktuelles  Datum: 

Bit  0..4:  Sekunden  (mit  2  zu  multiplizieren) 

Bit  5..  10:  Minuten 

Bit  11. .15:  Stunden 

Bit  16..20:  Tag 

Bit  21. .24:  Monat 

Bit  25. .31:  Jahr  (1980  addieren!) 
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Giaccess  (XBIOS  28) 


Setzt  und  liest  Register  im  General-Instmments-Soundchip. 

Deklaration  in  C: 

char  Giaccess  (char  data,  WORD  regno) ; 


Aufruf  in  Assembler: 


move . w 
move . w 
move . w 
trap 
addq . 1 


regno,  -  (sp) 
data,  -  (sp) 
#$lC,-(sp) 
#14 
#6,  sp 


;  Offset  4 
;  Offset  2 
;  Offset  0 


Parameter: 

data:  beim  Schreibzugriff  wird  dieser  8-Bit-Wert  in  das  entsprechende  Register 

geschrieben 

regno:  Nummer  des  GI-Registers  (0..15).  Beim  Schreibzugriff  wird  zusatzlich  Bit  7 

gesetzt,  so  daB  sich  dabei  die  Werte  128..143  ergeben. 

Wert  des  angegebenen  GI-Registers 


Giacess(): 
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Ikbdws  (XBIOS  25) 


Gibt  eine  Zeichenkette  an  den  IKBD-Chip  aus. 


Deklaration  in  C: 

void  Ikbdws  (WORD  cnt,  const  char  *ptr) ; 


Aufruf  in  Assembler: 

pea  ptr 

move . w  cnt ,  - ( sp) 

move.w  #$19, -(sp) 

trap  #14 

addq.l  #8,sp 


;  Offset  4 
;  Offset  2 
;  Offset  0 


Parameter: 

cnt:  Anzahl  der  auszugebenden  Bytes  minus  1 
ptr:  Zeiger  auf  die  Bytefolge  im  Speicher 
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Initmous  (XBIOS  0) 

Initialisiert  die  Mauszeigerroutinen. 

Deklaration  in  €: 

void  Initmous  (WORD  type,  PARAM  *param,  void  * (*vec)  {)); 

Aufruf  in  Assembler: 

pea  vec 

pea  param 

move.w  type,-(sp) 

move.w  #0,~(sp) 

trap  #14 

lea  12(sp),sp 

Parameter: 

type:  0:  Maus  ausschalten 

1 :  Maus  einschalten,  relativer  Modus 

2:  Maus  einschalten,  absoluter  Modus 

3:  unbenutzt 

4:  Maus  einschalten,  Tastaturemulation 

param:  Zeiger  auf  eine  Struktur  folgenden  Typs: 

typedef  struct 

{ 

BYTE  topmode; 

BYTE  buttons; 

BYTE  xparam; 

BYTE  yparam; 

)  PARAM; 

wobei  die  Strukturelemente  folgende  Bedeutung  haben: 
topmode:  0:  Y  =  0  am  unteren  Rand 

1 :  Y  =  1  am  oberen  Rand 

buttons:  siehe  IKBD-Beschreibung 

xparam, 

yparam:  Zusatzliche  Parameter,  abhangig  vom  ausgewahlten  Modus 


;  Offset  8 
;  Offset  4 
;  Offset  2 
;  Offset  0 
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vec: 


Fur  den  absoluten  Modus  muB  sich  direkt  die  folgende  Struktur  anschlieBen: 


typedef  struct 
{ 


WORD  xmax; 

/* 

Maximale  X-Position  */ 

WORD  ymax; 

/* 

Maximale  Y-Position  */ 

WORD  xinitial; 

/* 

Anfangsposition  X  */ 

WORD  yinitial; 

/* 

Anfangsposition  Y  */ 

}  EXTRA; 

Zeiger  auf  Maustreiberroutine 
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Iorec  (XBIOS  14) 


Liefert  einen  Zeiger  auf  eine  geratespezifische  Informationsstruktur  folgenden  Formats: 


typedef  struct 
{ 

LONG  ibuf; 
WORD  ibufsiz; 
WORD  ibufhd; 
WQRD  ibuftl; 
WORD  ibuflow; 
WORD  ibuf hi; 

}  IOREC; 


/*  Zeiger  auf  den  Puffer  */ 

/*  Lange  des  Puffers  */ 

/*  nachste  Schreibposition  */ 
/*  nachste  Leseposition  */ 

/*  "untere  Wassermarke"  */ 

/*  "obere  Wassermarke"  */ 


Fur  die  serielle  Schnittstelle  schlieBt  sich  direkt  ein  entsprechender  Puffer  fur  die  Ausgabe  an. 

Die  beiden  letzten  Zeiger  werden  nur  fur  die  serielle  Schnittstelle  im  XON/XOFF-  oder  RTS/ 
CTS-Betrieb  genutzt.  Fallt  der  “Zeichenpegel”  im  Puffer  unter  die  “untere  Wassermarke”, 
wird  das  Sendegerat  zum  Senden  weiterer  Zeichen  aufgefordert.  Ubersteigt  der  Pegel  die 
“obere  Wassermarke”,  wird  das  Sendegerat  aufgefordert,  keine  weiteren  Zeichen  zu  senden. 


Deklaration  in  C: 

IOREC  *Iorec  (WORD  devno) ; 


Aufruf  in  Assembler: 

move.w  devno, ~(sp)  ;  Offset  2 

move.w  #$E,-(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 

Parameter: 

devno:  Geratenummer: 

0:  RS  232 

1:  IKBD  (Tastatur) 

2:  MIDI 

Iorec():  Zeiger  auf  IOREC-Struktur 
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Jdisint  (XBIOS  26) 


Spent  den  angegebenen  Interrupt  des  MFP  68901. 

Deklaration  in  C: 

void  Jdisint  (WORD  intno) ; 


Aufruf  in  Assembler: 

move.w  intno, -(sp)  ;  Offset  2 

move.w  #$1A, - (sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 

intno:  Nummer  des  zu  sperrenden  Interrupts  (0..15) 


Jenabint  (XBIOS  27) 


Schaltet  den  angegebenen  Interrupt  des  MFP  68901  ein. 

Deklaration  in  C: 

void  Jenabint  (WORD  intno) ; 


Aufruf  in  Assembler: 

move.w  intno, -(sp)  ;  Offset  2 

move.w  #$1B, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 

intno:  Nummer  des  betreffenden  Interrupts  (0..15) 
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Kbdvbase  (XBIOS  34) 

Liefert  einen  Zeiger  auf  eine  Struktur  folgender  Form: 

typedef  struct 

{ 

void  (*midivec)  ();  /*  Midi-Eingabe  */ 

void  (*vkbderr)  () ;  /*  Tastatur-Fehler  */ 

void  (*vmiderr) () ;  /*  MIDI-Fehler  */ 

void  <*statvec) ();  /*  Status  von  IKBD  lesen  */ 

void  (*mousevec) () ;  /*  Mausabfrage  */ 
void  (*clockvec) () ;  /*  Uhrzeitabfrage  */ 
void  (*joyvec) ();  /*  Joy stickabf rage  */ 

void  (*midisys) ();  /*  MIDI-Systemvektor  */ 

void  (*ikbdsys)  0;  /*  IKBD-Systemvektor  */ 

WORD  drvstat;  /*  IKBD-Treiberstatus  */ 

}  KBDVECS; 

midivec:  Routine,  die  vom  MIDI-Port  empfangene  Bytes  (in  DO)  in  einen  Puffer 

schreibt 

vkbderr,  vmiderr:  werden  beim  Uberlauf  von  Daten  von  der  Tastatur  Oder  vom  MIDI-Port 

aufgerufen 

statvec,  mousevec, 

clockvec,  joyvec:  Zeiger  auf  die  Routinen,  die  die  entsprechenden  Informationspakete 
von  MIDI  oder  IKBD  verarbeiten. 

Die  Adresse  des  “packets”  wird  in  AO  und  auf  dem  Stack  iibergeben. 
Die  Routinen  sollten  mit  einem  RTS  abgeschlossen  sein  und  nicht  langer 
als  1  ms  laufen. 

midisys,  ikbdsys:  werden  beim  Eintreffen  von  Daten  am  entsprechenden  Port  aufgerufen. 

“midisy s”  springt  indirekt  durch  “midivec”;  “ikbdsys”  verzweigt  in  eine 
der  vier  in  Frage  kommenden  Untenroutinen  (s.o.), 

drvstat:  Wenn  diese  Statusvariable  ungleich  0  ist,  dann  verschickt  der  IKBD 

gerade  ein  “packet”. 

Deklaration  in  C: 

KBDVECS  * Kbdvbase  (void) ; 
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Aufruf  in  Assembler: 

move.w  #$22,- (sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 


Parameter: 

Kbdvbase():  Zeiger  auf  KBDVECS-Struktur 
Bemerkungen 

Bevor  man  entweder  Daten  in  eine  der  Routinen  “einspeisen”  Oder  einen  der  Vektoren  andem 
kann,  mu8  man  sichergehen,  daB  momentan  nicht  gerade  ein  “packet”  verschickt  wird.  Dann 
sollte  man  alle  Interrupts  sperren  und  anschlieBend  nochmais  testen,  ob  tatsachlich  kein 
“packet”  mehr  unterwegs  ist.  Erst  dann  darf  man  weiterarbeiten! 
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Kbrate  (XBIOS  35) 


Setzt  die  Tastatur-Wiederholrate  oder  fragt  sie  ab. 

Declaration  in  C: 

WORD  Kbrate  (WORD  initial,  WORD  repeat) ; 

Aufruf  in  Assembler: 

move.w  repeat, -  (sp)  ;  Offset  4 

move.w  initial, -  (sp)  ;  Offset  2 

move.w  #$23, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 


Parameter: 

initial:  Ansprechzeit  bis  zur  ersten  Wiederholung  (initial/(20  ms))  oder  -1  (keine 

Anderung) 

repeat:  Wiederholgeschwindigkeit  (repeat/(20  ms))  oder  -1  (keine  Anderung) 

Kbrate():  Bit  0..7:  bisheriger  Wert  von  “repeat” 

Bit  8..  15:  bisheriger  Wert  von  “initial” 
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Keytbl  (XBIOS  16) 

Setzt  die  Adressen  der  Tastencode-Umwandlungstabellen.  Ein  Code  wird  umgerechnet, 
indem  der  Scancode  der  betreffenden  Taste  als  Index  in  die  Tabelle  (von  ASCD-Zeichen) 
verwendet  wird.  Zuriickgeliefert  wird  ein  Zeiger  auf  eine  Struktur  folgender  Form: 

typedef  struct 
{ 

char  *unshift;  /*  Tabelle  fiir  "normale"  Tastendrucke  */ 
char  *shift;  /*  Tabelle  fiir  Tastendrucke  mit  "Shift”  */ 

char  *capslock;  /*  Tabelle  fur  Tastendrucke  bei  "Capslock"  */ 

}  KEYTAB; 

Deklaration  in  C: 

KEYTAB  *Keytbl  (char  *unshift,  char  * shift,  char  *capslock) ; 

Aufruf  in  Assembler: 

pea  capslock 

pea  shift 

pea  unshift 

move.w  #$10, -(sp) 
trap  #14 

lea  $E(sp),sp 

Parameter: 

unshift:  Zeiger  auf  “unshift”-Tabelle  (oder— 1 ,  wenn  keineneue  Adresse  gesetzt  werden 

soli) 

shift:  Zeiger  auf  “shift”-Tabelle  (oder  -1 ,  wenn  keine  neue  Adresse  gesetzt  werden 

soli) 

capslock:  Zeiger  auf  “capslock”-Tabelle  (oder  -1,  wenn  keine  neue  Adresse  gesetzt 

werden  soli) 

Keytbl():  Zeiger  auf  KEYTAB-Struktur 

Bemerkungen 

Jede  der  Tabellen  hat  nur  128  Eintrage,  obwohl  es  einige  Tastenkombinationen  mit  hoherem 
Scancode  gibt  (siehe  Tabelle). 


;  Offset  10 
;  Offset  6 
;  Offset  2 
;  Offset  0 
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Logbase  (XBIOS  3)  -  nur  fur  ST/STE/TT-Hardware 


Liefert  die  Anfangsadresse  des  logischen  Bildschirmspeichers  (das  ist  derjenige,  der  bei  alien 
Grafikoperationen  angesprochen  wird). 


Deklaration  in  C: 

void  *Logbase  (void) ; 

Aufruf  in  Assembler: 

move.w  #3,-(sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 

Parameter: 

Logbase():  Anfangsadresse  des  logischen  Bildschirmspeichers 
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Metainit  (XBIOS48) 


Mit  dieser  Funktion  kann  man  Mormationen  iiber  die  aktuell  instailierte  Meta-DOS-Version 
(und  die  von  ihr  installierten  Gerate)  erfragen.  Da  nicht  jeder  Meta-DOS  benutzt  und  es 
deshalb  nicht  uberali  installiert  ist,  muS  man  folgendermaBen  vorgehen: 

1 .  METAINFO-Struktur  vollstandig  loschen  (also  16  Nullbytes). 

2.  Metainit()  aufrufen 

3.  Testen,  ob  “version”  noch  immer  einen  Nullzeiger  enthalt  (dann  namlich  ist  Meta-DOS 
nicht  installiert) 

typedef  struct 
{ 

ULONG  drivemap;  /*  Tabelle  mit  Bits  fur  die  Meta-DOS- 

Geratetreiber  "A".."Z"  (Bit  0:  "A")  */ 
char  *version;  /*  Zeichenkette  mit  Namen  und 

Versionsnummer  von  Meta-DOS  */ 

LONG  reserved [2]; 

}  METAINFO; 

Damit  laBt  sich  schon  mal  feststellen,  ob  Meta-DOS  installiert  ist  und  welche  physikalischen 
Geratenummem  belegt  sind.  Diese  Gerate  kann  man  dann  mit  weiteren,  fur  Meta-DOS 
reservierten  XBIOS-Auitufen  (Nummem  48  bis  63)  ansteuem. 


Deklaration  in  C: 

void  Metainit  (METAINFO  ^buffer) ; 

Aufruf  in  Assembler: 

pea  buffer  ;  Offset  2 

move.w  #$30, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 


Parameter: 

buffer:  Zeiger  auf  METAINFO-Struktur,  die  von  Meta-DOS  ausgefiillt  wird 
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Mfpint  (XBIOS  13) 


Setzt  die  Interrupt-Vektoren  des  MFP  68901 .  Dabei  wird  jeweils  der  alte  Wert  tiberschrieben. 


Deklaration  in  C: 

void  Mfpint  (WORD  interno,  void  (*vector)  ()); 


Aufruf  in  Assembler: 

pea  vector 

move.w  interno,- (sp) 
move.w  #$D,-(sp) 
trap  #14 

addq.l  #8,sp 


;  Offset  4 
;  Offset  2 
;  Offset  0 


Parameter: 

interno:  Nummer  des  zu  andemden  Vektors  (0..15) 

vector:  Neue  Adresse  fur  die  betreffende  Interrupt-Routine 
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Midiws  (XBIOS 12) 


Gibt  eine  Bytefolge  auf  dem  MEDI-Port  aus. 


Deklaration  in  C: 

void  Midiws  (WORD  cnt,  cbnst  char  *ptr) ; 


Aufruf  in  Assembler: 

pea  ptr 

move.w  cnt,-(sp) 

move.w  #$C,-(sp) 

trap  #14 

addq.l  #8,sp 


;  Offset  4 
;  Offset  2 
;  Offset  0 


Parameter: 

cnt:  Anzahl  der  auszugebenden  Bytes  minus  1 
ptr:  Zeiger  auf  Bytefolge 
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NVMaccess  (XBIOS  46)  -nur  auf  dem  TT 


Die  Echtzeituhr  des  TT  verfiigt  ilber  50  Bytes  nichtfliichtiges  (“non  volatile”)  RAM,  das  man 
daher  sehr  gut  fiir  Konfigurationszwecke  benutzen  kann.  Die  letzten  beiden  Bytes  werden  als 
Priifsumme  benutzt.  “NVMaccessO”  dient  zur  Verwaltung  dieses  RAMs. 

Die  Belegung  des  NVMs  (“non  volatile  memory”)  wird  von  Atari  festgelegt.  Die  Benutzung 
fiir  nicht  von  Atari  dokumentierte  Zwecke  kann  und  wird  zu  schwerwiegenden  Problemen 
fiihren! 

Bislang  ist  fiber  die  Verwendung  des  NVMs  noch  nicht  entschieden.  Im  Bedarfsfall  sollte  man 
der  zustandigen  Atari-Vertretung  Vorschlage  unterbreiten. 


Deklaration  in  C: 

WORD  NMVaccess  {WORD  op,  WORD  start,  WORD  count,  BYTE  *buffer) ; 


Aufruf  in  Assembler: 


pea 

buffer 

;  Offset 

move.w 

count,- (sp) 

;  Offset 

move . w 

start,  -  (sp) 

;  Offset 

move . w 

op,  -  {sp) 

;  Offset 

move.w 

#$2E,-{sp) 

;  Offset 

lea 

$C(sp) , sp 

Parameter: 

op: 


start: 

count: 

NVMaccess(): 


0:  NVM  auslesen,  dabei  Priifsumme  iiberpriifen 

1:  NVM  beschreiben,  Priifsumme  iiberpriifen  und  neu  setzen 

2:  NVM  initialieren  und  Priifsumme  setzen 

Nummer  des  Startbytes 
Anzahl  der  zu  Ubertragenden  Bytes 
OK  (0):  alles  in  Ordnung 

EBADRQ  (-5):  Argumente  nicht  im  erlaubten  Bereich 

EGENRL(-12):  Priifsumme  war  nicht  konsistent  (beim  Lesen 

werden  die  Bytes  trotzdem  fibertragen) 
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Offgibit  (XBIOS  29) 


Loscht  Bits  im  “PORT  A”-Register  des  Gl-Chips. 

Dekiaration  in  C: 

void  Offgibit  (WORD  bitno) ; 

Aufruf  in  Assembler: 

move.w  bitno, - (sp)  ;  Offset  2 

move.w  #$lD,-(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 

Parameter: 

bitno:  Mit  dieser  Bitmaske  wird  der  aktuelle  Zustand  des  Registers  logisch  undiert. 


Ongibit  (XBIOS  30) 


Setzt  Bits  im  “PORT  A”-Register  des  Gl-Chips. 

Dekiaration  in  C: 

void  Ongibit  (WORD  bitno) ; 

Aufruf  in  Assembler: 

move.w  bitno, -(sp)  ;  Offset  2 

move.w  #$1E, - (sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 

bitno:  Mit  dieser  Maske  wird  der  aktuelle  Zustand  des  Registers  logisch  oderiert. 
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Physbase  (XBIOS  2)  -  nur  fur  ST/STE/TT-Videohardware 

Liefert  die  Anfangsadresse  des  physikalischen  Bildschirmspeichers  (das  ist  genau  der 
Speicherbereich,  den  man  auf  dem  Bildschirm  sieht). 

Deklaration  in  C: 

void  *Physbase  (void) ; 

Aufruf  in  Assembler: 

move.w  #2,-(sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 

Parameter: 

Physbase():  Anfangsadresse  des  physikalischen  Bildschirmspeichers. 
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Protobt  (XBIOS  18) 


Baut  im  Speicher  einen  Bootsektor  auf. 


Deklaration  in  C: 


void  Protobt  (void  *buf,  LONG  serialno,  WORD  disktype, 
WORD  execf lag) ; 


Aufruf  in  Assembler: 

move . w 

execflag, - (sp) 

;  Offset  12 

move . w 

disktype, -  (sp) 

;  Offset  10 

move . 1 

serialno,- (sp) 

;  Offset  6 

pea 

buf 

;  Offset  2 

move . w 

trap 

lea 

#$12, -(sp) 

#14 

$E  (sp) ,sp 

;  Offset  0 

Parameter: 

buf: 

Zeiger  auf  einen  512  Bytes  langen  Puffer,  der  denneuen  Bootsektor 
soli 

serialno: 

-1: 

>=  $01000000: 
sonst: 

gleiche  Seriennummer  wie  beim  letzten  Mai 
zufallige  Seriennummer  berechnen 
neue  Seriennummer 

disktype: 

-1:  Typ  nicht  verandem 

0:  40  Spuren,  einseitig  (180  K) 

1:  40  Spuren,  doppelseitig  (360  K;  MS-DOS-Standardformat) 

2:  80  Spuren,  einseitig  (360  K;  Standard  einseitig) 

3:  80  Spuren,  doppelseitig  (720  K;  Standard  doppelseitig) 

execflag: 


-1: 

0: 

1: 


High-Density 

(nur  wenn  im  “_FDC”-Cookie  der  Wert  fur  HD-Unterstutzung  eingetra- 
gen  ist) 

Extra-High-Density 

(nur  wenn  im  “_FDC”-Cookie  der  Wert  fur  ED-Unterstiitzung  eingetra- 
gen  ist) 
nicht  andem 

Bootsektor  nicht  ausfiihrbar 

Bootsektor  ausfiihrbar  (siehe  Aufbau  von  Bootsektoren) 
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Bemerkungen 

Damit  die  Diskette  auch  auf  MS-DOS-Sy  stemen  lesbar  ist,  muB  man  manuell  diehexadezimalen 
Werte  $E9  $00  $4E  in  die  ersten  drei  Bytes  des  Bootsektors  eintragen. 

“ProtobtO”  neigt  zu  Verschwendung:  auf  einer  normalen  720K-Diskette  wird  Platz  fiir  fiinf 
FAT-Sektoren  angelegt,  obwohl  drei  vollig  reichen  wiirden. 
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Prtblk  (XBIOS  36) 


Ahnelt  der  nonnalen  Hardcopy-Funktion  (von  der  aus  sie  auch  aufgerufen  wird). 
Allerdings  ist  sie  um  einiges  flexibler;  sie  erwartet  einen  Parameterblock  folgender  Form: 


typedef  struct 
/ 

t 

LONG  pb_scrptr; 

/* 

WORD  pb  offset; 

/* 

WORD  pb_width; 

/* 

WORD  pb_height; 

/* 

WORD  pb_left; 

/* 

WORD  pb  right; 

/* 

WORD  pb  screz; 

/* 

WORD  pb  prrez; 

/* 

LONG  pb_colptr; 

/* 

WORD  pbjprtype; 

/* 

WORD  pb_jprport;  /* 

LONG  pb_mask;  /* 

}  PBDEF ; 


Zeiger  auf  Bildschirmanfang  */ 
dazu  zu  addierender  Offset  */ 
Bildschinribreite  in  Punkten  */ 
Bildschirmhohe  in  Punkten  */ 

Linker  Rand  in  Punkten  */ 

Rechter  Rand  in  Punkten  */ 
Auflosung  */ 

Druckertyp  Atari/Epson  */ 

Zeiger  auf  Farbpalette 
(zum  Beispiel  $FF8240)  */ 

0:  Atari  Matrix  monochrom, 

1:  Atari  Matrix  farbig, 

2:  Atari  Typenrad  monochrom, 

3:  Epson  Matrix  monochrom  */ 
Schnittstelle  Centronics/RS  232  */ 
Zeiger  auf  Halbtonmaske  */ 


Insbesondere  muS  man  beachten,  daB  die  Summe  von  “pb_width”,  “pb_left”  und  “pb_right” 
genau  die  tatsachliche  Bildschirmbreite  ergeben  muB. 

Femer  muB  man  vorher  “_dumpflg”  ($4EE)  auf  1  setzen  -  denn  sonst  passiert  iiberhaupt 
nichts.  Der  Druckvorgang  kann  mit  '‘Altemate/Help”  abgebrochen  werden. 

Nach  der  Riickkehr  sollte  man  “_dumpflg”  wieder  auf  -1  setzen. 


Deklaration  in  C: 

void  Prtblk  (PBDEF  *defptr) ; 
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Aufruf  in  Assembler: 

move . w  #  1 , _dumpf lg 

pea  defptr  ;  Offset  2 

move.w  #$24, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 

move . w  # - 1 ,  _dumpf lg 


Parameter: 

defptr:  Zeiger  auf  PBDEF-Struktur 
Bemerkungen 

Gibt  fiber  die  Systemvektoren  “prvjsto”,  “prvjst”,  “prv__auxo”  bzw.  “prv_aux”  aus. 

Die  offizielle  Dokumentation  (“Hitchhiker’s  Guide  to  the  BIOS”)  fiihrt  diese  Funktion  zwar 
auf,  schweigt  sich  allerdings  iiber  alle  Parameter  aus. 
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Puntaes  (XBIOS  39) 


Das  AES  wird  nur  gestartet,  wenn  “os_magic”  im  OSHEADER  auf  die  korrekte  magische 
Zahl  ($8765432 1 )  zeigt.  “PuntaesO”  setzt  dieses  Flag  (sofem  moglich)  zuriick  und  bootet  dann 
das  System  neu, 

Deklaration  in  C: 

void  Puntaes  (void) ; 

Aufruf  in  Assembler: 

move.w  #$27, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 
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Random  (XBIOS 17) 


MitdieserFunktionkannmansicheine24-Bit-Zufallszahlberechnenlassen.DerAnfangswert 
nach  Systeminitialisierung  sollte  stets  unterschiedlich  sein,  da  mit  dem  Wert  des  vertikalen 
Zeilenzahlers  (im  Videochip)  initialisiert  wird. 

Gleichwohl  handelt  es  sich  nicht  um  einenechten  Hardware-Zufallszahlengenerator  (wie  zum 
Beispiel  bei  Ataris  8-Bittem).  Statt  dessen  wird  nach  dem  Algorithmus 

S  =  (S  *  3.1415926...)  +  1 

verfahren.  Zuriickgeliefert  wird  die  Zahl  S  (um  acht  Bits  nach  rechts  verschoben).  Das 
Verhalten  fur  die  gesamte  Zahl  ist  recht  gut,  die  Abfr age  einzelner  Bits  kann  jedoch  gefahrlich 
sein  (im  Sinne  einer  verminderten  “Zufalligkeit”). 

Im  Zweifelsfall  sollte  man  sich  zunachst  eine  Reihe  von  Zahlenwerten  ausgeben  lassen,  die 
“zufallig”  sein  sollen! 


Deklaration  in  C: 

LONG  Random  (void) ; 


Aufruf  in  Assembler: 

move.w  #$11, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 


Parameter: 

Random():  24-Bit-Zufallszahl 
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Rseonf  (XBIOS  15) 

Setzt  Parameter  fur  die  serielle  Schnittsteile.  “Friiher”  setzte  diese  Funktion  einfach  nur  die 
entsprechenden  Register  im  MFP-Baustein. 

Seit  der  Einfiihrung  des  Atari  TT  ist  nicht  mehr  ohne  weiteres  klar,  welcher  Hardwarebaustein 
fur  die  serielle  Schnittsteile  eingesetzt  wird  (siehe  XBIOS -Einfiihrung  und  “BconmapO”). 

Daher  muB  man  “RsconfO”  besonders  vorsichtig  einsetzen.  Das  heiBt: 

1.  Aktuelle  Einstellungen  mit  Rseonf  (-1,  -1,  -1,  -1,  -1,  -1)  abfragen. 

2.  Nur  die  interessanten  Bits  modifizieren. 

3.  Die  neuen  Werte  setzen. 


Dadurch,  daB  die  serielle  Schnittsteile  nicht  mehr  unbedingt  durch  einen  MFP  angesteuert 
wird,  werden  die  benutzbaren  Werte  folgendermaBen  eingeschrankt: 


ucr: 


rsr: 

tsr: 

scr: 


Bit  5..6:  Wortlange  (00:  8, 01 :  7,  10:  6,  1 1 :  5) 

Bit  3. .4:  Stopbits  (01:  1,  10:  1.5,  1 1:  2, 00:  ungiiltig) 

Bit  2:  parity  (0:  nein,  1 :  ja) 

Bit  1 :  0:  odd  parity,  1 :  even  parity  (nur  sinnvoll,  wenn  auch  Bit  2  gesetzt  ist) 

nicht  benutzbar 

Bit  3:  1:  break 

nicht  benutzbar 


Technisch  nicht  mogliche  Werte  miissen  ignoriert  werden. 


Schon  deshalb  sollte  man  sich  nie  darauf  verlassen,  daB  wirklich  alle  Einstellungen  vorgenom- 
men  worden  sind  (sondem  den  Ruckgabewert  inspizieren!). 

Deklaration  in  C: 

ULONG  Rseonf  (WORD  speed,  WORD  flowctl,  WORD  ucr,  WORD  rsr, 

WORD  tsr,  WORD  scr) ; 


BIOS  und  XBIOS 


147 


Aufruf  in  Assembler: 


move . w 

scr, - (sp) 

Offset 

12 

move.w 

tsr,  —  (sp) 

t 

Offset 

10 

move . w 

rsr,- (sp) 

t 

Offset 

8 

move . w 

ucr,- (sp) 

r 

Offset 

6 

move.w 

flowctl,  -  (sp) 

/ 

Offset 

4 

move . w 

speed, - (sp) 

r 

Offset 

2 

move.w 

#$F,  -  (sp) 

r 

Offset 

0 

trap 

#14 

lea 

$E (sp) , sp 

Parameter: 


speed: 


flowed: 


ucr,  tsr,  rsr,  scr: 
Rsconf(): 


-I:  nicht  andem 
0:  19200  Baud 

1 :  9600  Baud 

2:  4800  Baud 

3:  3600  Baud 

4:  2400  Baud 

5:  2000  Baud 

6:  1800  Baud 

7:  1200  Baud 

8:  600  Baud 

9:  300  Baud 

10:  200  Baud 

11:  150  Baud 

12:  134  Baud 

13:  110  Baud 

14:  75  Baud 

15:  50  Baud 

-I:  nicht  andem 
0:  keine  FluGkontrolle 
1 :  XON/XOFF  (CTRL-S,  CTRL-Q) 

2:  RTS/CTS 

3:  RTS/CTS  und  XON/XOFF 

entweder  die  neuen  Werte  fur  die  Register  oder  -1  (nicht  verandem) 
in  gepackter  Form  die  Werte  des  ucr-,  rsr-  und  tsr-Registers  (Bit  31.. 24: 
ucr.  Bit  23., 16:  rsr,  Bit  15. ,8:  tsr,  Bit  7..0:  scr) 
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Bemerkungen 

Ab  TOS  1.04  kann  man  mit  “Rsconf(-2,-l -1,-1 -1)”  die  letzte  eingestellte  Baudrate 
abfragen. 


BIOS  und  XBIOS 


149 


Scrdmp  (XBIOS  20) 


Druckt  den  aktuellen  Bildschirminhalt  aus.  Der  Druckvorgang  kann  durch  Betatigen  von 
“Altemate/Help”  abgebrochen  werden  (siehe  auch  “SetprtO”). 


Deklaration  in  C: 

void  Scrdmp  (void)  ; 

Aufruf  in  Assembler: 

move.w  #$14, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #2,sp 

Bemerkungen 

Springt  iiber  den  Systemvektor  “scr_dump”.  Die  dort  eingetragene  Funktion  mft  normaler- 
weise  die  XBIOS-Funktion  “Prtblk()”  auf. 

Die  Hardcopy-Routine  funktioniert  nur  fur  eine  ausgeschrankte  Auswahl  von  Druckem  (siehe 
“SetprtO”)  und  beim  TT  auch  nicht  in  alien  Auflosungen. 
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Setcolor  (XBIOS  7)  -nur  fiir  ST/STE/TT-Videoliardware 


Setzt  ein  Farbregister  auf  einen  neuen  Wert  oder  fragt  nur  den  Wert  ab. 


Deklaration  in  C: 

WORD  Setcolor  (WORD  colorNum,  .WORD  color)  ,* 


Aufruf  in  Assembler: 


move . w 
move . w 
move.w 
trap 
addq. 1 


color,  -  (sp) 
colorNum, - (sp) 
#7, - (sp) 

#14 
#6,  sp 


Offset  4 
Offset  2 
Offset  0 


Parameter: 


color: 

colorNum: 

Setcolor(): 


Neuer  Farbwert  oder  -1,  falls  das  Register  nicht  geandert  werden  soil 
Nummer  des  anzusprechenden  Farbregisters  (0..15) 

Bisheriger  Wert  des  Farbregisters 
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Setpalette  (XBIOS  6)  -  nur  fur  ST/STE/TT-Videohardware 


Neue  Farbpalette  an  die  Video-Hardware  iibergeben  (geschieht  erst  im  nachsten  Vertical 
Blank). 

Deklaration  in  C: 

void  Setpalette  (WORD  *palettePtr) ; 

Aufruf  in  Assembler: 

pea  palettePtr  ;  Offset  2 

move.w  #6, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 

Parameter: 

palettePtr:  Zeiger  auf  eine  Tabelle  aus  sechzehn  16-Bit-Worten,  die  die  neue  Farbpalette 

enthalten  (wobei  jeweils  die  untersten  zwolf  Bits  fiir  die  RGB-Werte  benutzt 
werden).  MuB  auf  einer  geraden  Adresse  liegen. 

Bemerkungen 

Das  hier  benutzte  Format  wird.bei  ktinftigen  Auflosungen  (z.B.  320  *  480  in  256  Farben  beim 
Atari  TT)  nicht  mehr  ausreichen!  Statt  dessen  verwende  man  besser  die  entsprechenden  VDI- 
Funktionen! 

“Setpalette”  ist  ein  “delayed  action  calF.  Zu  deutsch:  die  Daten  werden  nicht  sofort,  sondem 
erst  etwas  spater  verarbeitet.  Da  nur  ein  Zeiger  auf  die  Farbtabelle  iibergeben  wird,  muB  man 
schon  selbst  dafiir  sorgen,  daB  der  Zeiger  im  nachsten  Vertical  Blank  noch  auf  etwas  Sinn- 
volles  zeigt. 
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Setprt  (XBIOS  33) 


Setzt  oder  liest  die  aktuelle  Druckereinstellung.  Diese  Einstellung  wird  von  fast  alien  anderen 
Betriebssystemteilen  mit  Nichtachtung  gestraft  (Ausnahmen:  “ScrdmpO”  und  “PrtblkO”). 
Beira  BIOS  liegt  das  an  einem  Fehler,  der  leider  in  alien  bekannten  TOS-Versionen 
gleichermafien  vorhanden  ist. 

In  eigenen  Programmen  sollte  man  zumindest  die  Wahl  der  Schnittstelle  (seriell/parallel)  und 
die  Einzelblatt-/Endlospapiereinstellung  auswerten. 


Deklaration  in  C: 

WORD  Setprt  (WORD  config) ; 


Aufruf  in  Assembler: 

move.w  config, - (sp)  ;  Offset  2 

move.w  #$21, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #4,sp 


Parameter: 


config:  —1:  Konfiguration  auslesen 

neues  Konfigurationsbyte: 

Bitbelegung: 

BitO:  Matrixdrucker 
Bit  1 :  monochrom 
Bit  2:  Atari-Drucker  (1280  Punkte) 

Bit  3:  normale  Qualitat 
Bit  4:  Centronics 
Bit  5:  Endlospapier 
alle  weiteren  Bits  sind  zur  Zeit  nicht  benutzt 
Setprt():  aktuelle  Konfiguration 


Typenraddrucker 

farbig 

Epson-Drucker  (960  Punkte) 
hohe  Qualitat  (nur  bei  1280  P.) 
RS  232 

Binzelblattpapier 


Bemerkungen 

Bit  2  ist  eigentlich  nur  fur  die  XBIOS-eigene  Hardcopy-Routine  interessant. 
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Setscreen  (XBIOS5)  -  nur  fur  ST/STE/TT-Videohardware 

Dient  zum  Andem  von  Bildschirmspeicheradressen  und  Auflosung. 


Deklaration  in  C: 

void  Setscreen  (void  *logLoc,  void  *physLoc,  WORD  res) ; 


Aufruf  in  Assembler: 


move . w 
move . 1 
move . 1 
move . w 
trap 
lea 


res,  -  (sp) 
physLoc,  -  (sp) 
logLoc,  - (sp) 
#5, - (sp) 

#14 

$C  (sp) ,  sp 


;  Offset  10 
;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

logLoc:  -1:  Adresse  des  logischen  Bildschirmspeichers  nicht  andem 

sonst:  neue  Anfangsadresse 

physLoc:  -1 :  Adresse  des  physikalischen  Bildschirmspeichers  nicht  andem 

sonst:  neue  Anfangsadresse  (mu6  beim  ST  auf  einer  256-Byte-Grenze  liegen) 
res:  -1:  Auflosung  nicht  andem 

sonst:  neue  Bildauflosung 

Bemerkungen 

Bei  Anderungen  der  Bildauflosung  wird  der  VT52-Emulator  automatisch  initialisiert  (z.B.  der 
Cursor  in  die  linke  obere  Ecke  gesetzt). 

Bitte  anschlieBendmit  “Physbase()”,  “Logbase()”  und  “Getrez()”  uberpriifen,  ob  der  Funktions- 
aufruf  erfolgreich  war:  niemand  garantiert,  daft  man  mit  jedem  Bildschirmtreiber  und  jeder 
Grafikkarte  all  diese  Parameter  verandem  kann! 

Vorsicht,  wenn  gleichzeitig  die  Systemvariable  “screenpt”  benutzt  wird! 
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Settime  (XBIOS  22) 

Setzt  die  Hardware-Uhr  auf  ein  neues  Datum.  Bei  den  Mega-STs  wird  nicht  die  IKBD-Uhr, 
sondem  die  batteriegepufferte  Uhr  gesetzt. 

Deklaration  in  C: 

void. Settime  (LONG  datetime) ; 

Aufruf  in  Assembler: 

move.l  datetime, - (sp)  ;  Offset  2 

move.w  #$16, -(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 


Parameter: 

datetime:  Codiertes  Datum: 

Bit  0..4:  Sekunden  (Wert  0..59  dutch  2  dividieren) 

Bit  5. .10:  Minuten 

Bit  11..15:  Stunden 

Bit  16.. 20:  Tag 

Bit  21. .24:  Monat 

Bit  25. .31:  Jahr  (1980  subtrahieren) 
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Ssbrk  (XBIOS  1) 


Reserviert  Speicherplatz  am  Ende  des  physikalischen  Speicherbereichs  und  kann  nur  vor  der 
Initialisierung  von  GEMDOS  benutzt  werden  (diese  Funktion  ist  bci  samtlichen  ROM-TOS- 
Versionen  nur  eine  Dummy-Routine,  die  iiberhaupt  nichts  bewirkt!). 


Deklaration  in  C: 

LONG  Ssbrk  (WORD  amount) ; 

Aufruf  in  Assembler: 

move.w  amount, ~(sp)  ;  Offset  2 

move.w  #l,-(sp)  ;  Offset  0 

trap  #14 

addq.l  #6,sp 


Parameter: 

amount:  Anzahl  der  zu  reservierenden  Bytes 

Ssbrk():  Anfangsadresse  des  allozierten  Speicherbereichs 
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Supexec  (XBIOS  38) 


Fiihrt  ein  (durch  RTS  abgeschlossenes)  Unterprogramm  im  Supervisor-Modus  aus. 


Deklaration  in  C: 

LONG  Supexec  (LONG  (* codeptr) ()) ; 


Aufruf  in  Assembler: 


pea 

move . w 
trap 
addq. 1 


codeptr 
#$26, -(sp) 
#14 
#6,  sp 


;  Offset  2 
;  Offset  0 


Parameter: 

codeptr:  Anfangsadresse  der  betreffenden  Routine 

Supexec():  Der  Retum-Wert  der  aufgerufenen  Funktion  wird  von  “SupexecQ”  an  den 

Aufrufer  zuriickgereicht. 


Vsync  (XBIOS  37) 

Wartet,  bis  ein  Vertical-BIank-Interrupt  aufgetreten  ist.  Fur  zeitkritische  Abfragen  (beispiels- 
weise  fur  Fine-Scrolling)  sollte  man  besser  direkt  den  Zeilenzahler  im  Shifter  abfragen! 

Deklaration  in  C: 

void  Vsync  (void)  ; 


Aufruf  in  Assembler: 

move.w  #$25, -(sp) 

trap  #14 

addq.l  #2,sp 


;  Offset  0 
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Setzt  und  startet  die  MFP  68901 -Timer. 


Declaration  in  C: 

void  Xbtimer  (WORD  timer,  WORD  control,  WORD  data,  void  (*vec) () ) ; 

Aufruf  in  Assembler: 

pea  vec  ;  Offset  8 

move.w  data,-(sp)  ;  Offset  6 

move.w  control, - (sp)  ;  Offset  4 

move.w  timer, -(sp)  ;  Offset  2 

move.w  #$lF,-(sp)  ;  Offset  0 

trap  #14 

lea  $C(sp),sp 

Parameter: 

timer:  Nummer  des  Timers: 

0:  Timer  A:  kann  fur  eigene  Programme  benutzt  werden 

1:  Timer  B:  Horizontal-Blank-Interrupt 

2:  Timer  C:  200  Hz  Systemtimer 

3:  Timer  D:  Baudraten-Generator 

control,  data:  Werte  fur  die  entsprechenden  Timer-Register 
vec:  Zeiger  auf  die  dazugehorige  Interrupt-Routine 
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Kapitel  2:  GEMDOS 

Einleitung 

Das  erste  System,  auf  dem  GEM  implementiert  wurde,  war  bekanntlich  der  IBM  PCunter  MS- 
DOS.  Als  Ende  1984  GEM  auf  den  Motorol a -Fjrozessor  portiert  wurde,  gab  es  weder  fertige 
STs  noch  Entwicklungswerkzeuge  noch  ein  Betriebssystem,  auf  das  man  hatte  aufbauen 
konnen. 

So  nahmen  die  Entwickler  den  Umweg  Uber  eine  Apple  “Lisa”,  auf  der  CP/M  68K  (ebenfalls 
ein  DOS  von  Digital  Research)  lief.  Wer  das  damalige  Entwicklungspaket  von  Atari  kennt, 
erinnert  sich  sicherlich  noch  an  den  Alcyon-C-Compiler  Oder  “LINK68”  und  “RELMOD” 
(das  CP/M-68K-Programme  in  GEMDOS-Programme  konvertierte).  Aus  verschiedenen 
Grlinden  kam  CP/M  68K  nicht  als  endgiiltiges  Betriebssystem  in  Frage  (ein  Grand  war  das 
fehlende  hierarchische  Dateisystem).  Daher  entschlofi  man  sich  bei  Atari  und  Digital 
Research,  als  Grundlage  fur  GEM  auf  Motorola-Rechnem  einen  vollig  neuen  Unterbau  zu  ent- 
wickeln,  eben  “GEMDOS”  (“GEM  Disk  Operating  System”).  Und  so  entwickelte  Digital- 
Research-Programmierer  Jason  Loveman  in  kiirzester  Zeit  ein  neues  DOS,  das  in  den  meisten 
Details  MS-DOS  2.0  entspricht.  Leider  fiihrte  die  Eile  auch  zu  einer  Fiille  von  Fehlem  und 
Designschwachen,  von  denen  Atari-Programmierer  Allan  Pratt  bis  heute  leider  nur  einige 
beseitigen  konnte.  Problemkinder  waren  und  bleiben  die  Speicherverwaltung  und  die  Ein-/ 
Ausgabeumlenkung. 

Aber  auch  MS-DOS  (zumindest  die  Version  1 .0)  war  nicht  mehr  als  eine  Weiterentwicklung 
vom  CP/M  fur  den  IBM  PC  und  dazu  kompatible  Rechner.  Und  so  stimmen  noch  heute  viele 
GEMDOS-Funktionsnummem  mit  denen  der  CP/M- Versionen  fiirZ80-Systeme  aus  dem  Jahr 
1975  uberein.  Also:  obwohl  es  in  vielen  Belangen  so  aussieht  wie MS-DOS,  istGEMDOS  ein 
eigenes  Betriebssystem  mit  vielen  Tticken  im  Detail.  Oder,  um  es  mit  den  Worten  von  Tim 
Oren  zu  sagen:  “Remember:  it  looks  like  a  duck,  and  quacks  like  a  duck,  but  it’s  not  a  duck!” 
(Professional  GEM,  Folge  15,  “Coping  with  GEMDOS”). 


Dateisystem 

Dateibezeichnungen 

Eine  Dateibezeichnung  besteht  aus  einer  optionalen  Laufwerksangabe,  einer  optionalen 
Pfadangabe  und  dem  eigentlichen  Dateinamen.  Der  Dateiname  besteht  aus  einem  bis  acht 
Zeichen,  gegebenenfalls  gefolgt  von  einem  Punkt  und  drei  weiteren  Zeichen. 
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Erlaubte  Zeichen  sind: 

A  bis  Z,  a  bis  z,  0  bis  9,  _!  @#$%/'&  I  []{} 

Kleine  Buchstaben  werden  automatisch  in  GroBbuchstaben  umgewandelt.  Alle  anderen  Zei¬ 
chen  -  insbesondere  Umlaute  -  sind  nicht  erlaubt  (auch  wenn  das  AES  sie  in  Datei-Eingabe- 
masken  erlaubt). 

Der  Pfadname  besteht  aus  beliebig  vielen  Dateinamen,  jeweils  gefolgt  von  einem  Backslash 
(‘V).  Wird  am  Anfang  des  Dateinamens  ein  Backslash  eingefiigt,  beginnt  der  Pfad  im 
Wurzelverzeichnis  des  Laufwerks,  ansonsten  wird  vom  aktuellen  Verzeichnis  des  Laufwerks 
ausgegangen.  Fehlt  der  Pfadname  ganz,  wird  statt  dessen  das  aktuelle  Verzeichnis  des  Lauf¬ 
werks  benut2t. 

In  Pfadnamen  sind  zwei  besondere  Dateinamen  erlaubt: 
bezeichnet  das  aktuelle  Verzeichnis 

bezeichnet  das  eine  Ebene  iiber  dem  aktuellen  Verzeichnis  liegende  Verzeichnis 

Ein  Pfad  heiBt  relativ,  wenn  er  nicht  mit  dem  Wurzelverzeichnis  beginnt.  Anderenfalls  spricht 
man  von  einem  absoluten  Pfad. 

Vorsicht:  Bei  Anwendung  zu  “komplizierter”  Pfadbezeichnungen  (wie  zum  Beispiel: 
“ .  .  \ \ \ .  \sybex\ .  \pbuch\”)scheinen die GEMDOS-intemen Routinen nicht immer 
korrekt  zu  funktionieren.  Im  Zweifelsfall  sollte  man  eine  eigene  Routinen  vorschalten,  die 
relative  in  absolute  Pfadnamen  konvertieren. 

Die  Laufwerksbezeichnung  besteht  aus  einem  einzelnen  Buchstaben  zwischen  “A”  und  “Z”, 
gefolgt  von  einem  Doppelpunkt.  Fehlt  die  Laufwerksbezeichnung,  wird  das  aktuelle  Laufwerk 
gewahlt. 

GEMDOS  selbst  unterstiitzt  nur  16  verschiedene  logische  Laufwerke  (also  “A”  bis  “P”). 
Durch  Installation  von  Meta-DOS  wird  die  Zahl  der  Laufwerke  auf  26  (also  bis  “Z”)  erweitert. 
Welche  Laufwerke  genau  verfugbar  sind,  stellt  man  am  besten  mit  folgender  Konstruktion 
fest: 

Dsetdrv  (DgetdrvO); 

Der  Gesamtlange  der  Dateibezeichnung  setzt  GEMDOS  selbst  keine  Grenze.  Allerdings  hat 
das  Desktop  eine  Begrenzung  auf  acht  Ordnertiefen.  Die  allermeisten  Programme  gehen 


GEMDOS 


161 


davon  aus,  dafi  128  Zeichen  Lange  ausreichen.  Zusatzlich  gibt  es  spezielle  Dateibezeichnungen 
fur  die  zeichenorientierten  Gerate,  anf  die  man  beispielsweise  mittels  “FopenO”  zugreifen 
kann: 


“CON:”,  “con:” 

Bildschirm  bzw.  Tastatur 

“AUX:’\  “aux:” 

Serielle  Schnittstelle 

“PRN:”,  “pm:” 

Parallele  Schnittstelle 

Das  Desktop  unterstiitzt  zusatzlich  das  Laufwerk  “c:”  (kleingeschrieben)  fiir  ROM-Module. 
Dabei  handelt  es  sich  allerdings  um  kein  echtes  Dateisystem.  Weitere  Informationen  dazu  fin- 
den  Sie  bei  der  Beschreibung  der  Cartridge-Hardware. 

Schluftbemerkung :  Man  sollte  sich  -  wann  immer  moglich  -  nicht  auf  das  genaue  Format  von 
Dateinamen  verlassen  und  insgesamt  keine  Annahmen  iiber 

-  das  Vorhandensein  nicht  erlaubter  Zeichen, 

-  die  Unterscheidung  zwischen  GroB-  und  Kleinschrift  oder 

-  die  maximale  Lange  von  Dateinamen 

machen.  Solche  Vorsichtsmafinahmen  erleichtem  Portierungen  und  Anpassungen  an  neue 
GEMDOS- Versionen  wie  die  Multitasking-Erweiterung  “MiNT  bei  der  zurZeit  (Testversion 
0.8)  Dateinamen  von  bis  zu  1 4  Zeichen  praktisch  beliebiger  Art  moglich  sind  (das  Dateinamens- 
feld  in  der  DTA  ist  dort  nicht  zwingend  Null-terminiert). 


Aktueller  Pfad,  aktuelles  Laufwerk 

GEMDOS  merkt  sich  zu  jedem  Laufwerk  einen  aktuellen  Pfad,  auf  den  sich  alle  Pfadangaben 
stiitzen,  die  nicht  mit  einem  ‘  V  beginnen.  AuBerdem  gibt  es  auch  ein  aktuelles  Laufwerk,  das 
immer  dann  benutzt  wird,  wenn  eine  Laufwerksangabe  fehlt.  Zum  Setzen  und  Abfragen  gibt 
es  “Dgetpath()’\  “DsetpathO”,  “DgetdrvO”  und  “Dsetdrv()”.  Die  aktuellen  Werte  werden  an 
mittels  “Pexec()”  gestartete  Programme  vererbt  und  dabei  gemerkt. 


GEMDOS-Dateisystem 

Das  GEMDOS-Dateisystem  entspricht  weitgehend  dem  in  MS-DOS  2.0benutzten  Dateisystem. 
Wenn  man  beim  Formatieren  der  Disketten  einige  Punkte  beachtet  (siehe  unter  “ProtobtQ”), 
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kann  man  die  Disketten  sogar  mit  einem  MS -DOS -Computer  austauschen  -  selbst  wenn  man 
ein  High-Density-Laufwerk  benutzt. 

Intern  existiert  eine  klare  Arbeitsteilung  zwischen  BIOS  und  GEMDOS.  Das  BIOS  stellt 
Routinen  zum  Lesen  und  Schreiben  (“Rwabs()”),  zum  Erkennen  eines  Medienwechsels 
(“Mediach()”)  und  zur  Abfrage  von  Dateisysteminformationen  (“GetbpbO”)  zu  Verfiigung. 

An  dieser  Stelle  sollte  man  noch  erwahnen,  daB  man  sich  keineswegs  darauf  verlassen  darf, 
daB  GEMDOS  tatsachlich  das  hier  geschilderte  Dateisystem  benutzt. 

Ein  Beispiel:  Wenn  Meta-DOS  eingesetzt  wird,  kann  man  noch  nicht  einmal  davon  ausgehen, 
daB  BIOS-Aufrufe  zum  Lesen  und  Schreiben  benutzt  werden. 

GEMDOS  benutzt  die  ersten  Sektoren  eines  Laufwerks  fur  Verwaltungsinformationen.  Ein 
Laufwerk  besteht  typischerweise  aus  filnf  Teilen:  dem  optionalen  Bootsektor,  zwei  FATs 
(“File  Allocation  Table”),  einem  Wurzelverzeichnis  und  dem  Clusterbereich  (GEMDOS 
verwaltet  die  Sektoren  in  Gruppen  mehrerer  Sektoren,  den  Clustem). 

Die  FAT  beschreibt,  welche  Cluster  belegt  sind,  und  stellt  die  Verkettung  der  einzelnen  Clu¬ 
ster  innerhalb  einer  Datei  her.  Alle  Dateien  und  Unterverzeichnisse  werden  im  Clusterbereich 
abgelegt  und  iiber  die  FAT  verwaltet. 

Nur  das  Wurzelverzeichnis  stellt  in  dieser  Hinsicht  eine  Ausnahme  dar. 

Beim  ersten  Zugriff  auf  ein  Laufwerk  ruft  GEMDOS  die  Funktion  “GetbpbO”  auf. 
Zuriickgeliefert  wird  eine  BPB-Struktur,  aus  der  alle  fur  GEMDOS  interessanten  Informatio- 
nen  extrahiert  werden.  Dasselbe  passiert  iibrigens  auch  nach  einem  Medienwechsel. 


typedef  struct 
{ 

WORD  recsiz; 
WORD  clsiz; 
WORD  clsizb; 
WORD  rdlen; 
WORD  fsiz; 
WORD  fatrec; 
WORD  datrec; 
WORD  numcl ; 
WORD  bflags; 


/*  Bytes  pro  Sektor  */ 

/*  Sektoren  pro  Cluster  (Einheit)  */ 

/*  Bytes  pro  Cluster  */ 

/*  Lange  des  Wurzelverzeichnis  in  Sektoren  */ 
/*  Lange  des  File  Allocation  Table  (FAT)  */ 

/*  Startsektor  der  zweiten  FAT  */ 

/*  Sektornummer  des  ersten  freien  Clusters  */ 
/*  Gesamtzahl  der  Cluster  auf  dem  Medium  */ 

/*  Bitvektor,  zur  Zeit  nur  Bit  0  belegt: 

0  (12-Bit-FAT) ,  1  (16-Bit -FAT)  */ 


}  BPB; 
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“recsiz”  gibt  an,  wie  groB  jeder  einzelne  Sektor  auf  dem  Medium  ist.  Mogliche  Grofien  sind 
512,  1024,  2048  und  4096.  Bei  noch  groBeren  SektorgroBen  kommt  es  in  alien  bekannten 
GEMDOS-Versionen  zu  Problemen  mit  zn  grofien  ClustergroGen. 

“clsiz”  muB  laut  Atari  immer  2  sein.  Andere  Werte  waren  zum  Lesen  mancher  MS-DOS- 
Formate  wiinschenswert,  sind  aber  zur  Zeit  (GEMDOS  0. 19)  angeblich  nicht  moglich  (in  der 
Praxis  scheinen  1-Sektor-Cluster  -  benotigt  fiir  MS-DOS-High-Density-Disketten  -  zu 
funktionieren). 

“clsizb”  ist  die  GroGe  eines  Clusters  in  Bytes  und  somit  eigentlich  eine  Uberfliissige 
Information  (da  aus  “recsiz”  und  “clsiz”  leicht  zu  errechnen). 

“rdlen”  beschreibt  die  Lange  des  Wurzelverzeichnis  in  Sektoren.  Jeder  Verzeichniseintrag 
belegt  32  Bytes,  somit  passen  “(rdlen  *  recsiz)  /  32”  Eintrage  in  das  Verzeichnis. 

Damit  ist  das  Wurzelverzeichnis  im  Gegensatz  zu  Unterverzeichnissen  in  seiner 
Aufnahmefahigkeit  durch  einen  fixen  Wert  beschrankt  (bei  “normalen”  Disketten  liegt  diese 
Zahl  iiblicherweise  bei  112  Eintragen). 

“fsiz”  beschreibt  die  Lange  jeder  einzelnen  FAT  in  Sektoren.  “fatrec”  gibt  die  Nummer  des 
Anfangssektors  der  zweiten  FAT  an.  In  “datrec”  findet  man  die  Sektomummer  des  ersten 
Clusters,  “numcl”  legt  fest,  wieviel  Cluster  auf  dem  Medium  Platz  haben. 

“bflags”  enthdlt  zusatzliche  Informationen  iiber  das  Dateisystem.  Zur  Zeit  ist  nur  das  unterste 
Bit  belegt:  wenn  es  gesetzt  ist,  hat  man  es  mit  16  Bit  groBen  FAT-Eintragen  zu  tun  (sonst  12 
Bit).  NeuereMS-DOS-Versionen  erlauben  auch  32-Bit-FATS  (dort  ist  die  BPB-Struktur  auch 
im  Hinblick  auf  das  “High  Performance  File  System”  von  OS/2  um  zusatzliche  Felder  erwei- 
tert  worden). 

Aus  diesen  Informationen  kann  man  noch  einige  weitere  Werte  berechnen: 

Wenn  es  Bootsektoren  gibt,  dann  belegen  sie  die  Sektoren  0  bis  (fatrec  -  fsiz  -- 1).  Die  erste 
FAT  beginnt  bei  (fatrec  -  fsiz),  und  das  Wurzelverzeichnis  startet  bei  (fatrec  +  fsiz). 

Verzeichniseintrage 

Ein  Verzeichniseintrag  kann  entweder  innerhalb  des  Wurzelverzeichnisses  oder  in  einem 
Unterverzeichnis  auftreten  (ein  Unterverzeichnis  kann  als  Datei  mit  Verzeichniseintragen 
angesehen  werden). 

Jeder  Eintrag  ist  insgesamt  32  Bytes  lang  und  hat  das  folgende  Format: 
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typedef  struct 


char 

dir  name [11]; 

/* 

Name  inkl.  Erweiterung  ohne  Punkt  */ 

BYTE 

dir  attr; 

/* 

Attribut  */ 

BYTE 

dir_dummy [10] ; 

/* 

unbenutzt  */ 

DWORD 

dir  time; 

/* 

Erstel lungs zeit  */ 

UWORD 

dir_date; 

/* 

Erstellungsdatum  */ 

UWORD 

dir  stcl; 

/* 

erster  Cluster  */ 

ULONG 

dir  flen; 

/* 

Lange  der  Datei  */ 

}  DIR; 

“dir_time”,  “dir_date’\  “dir_stcl”  und  “dirjlen”  sind  im  Intel-Format,  das  heiBt  hoher-  und 
niederwertige  Bytes  sind  vertauscht.  Bei  geloschten  Dateien  ist  das  erste  Zeichen  des 
Dateinamens  mit  dem  Wert  $E5  iiberschrieben. 

FAT-Eintrage 

In  der  FAT  finden  sich  Informationen  iiber  jeden  einzelnen  Cluster  des  Speichermediums. 
Dabei  sind  folgende  Falle  moglich: 

-  Der  Cluster  ist  frei. 

Der  Cluster  ist  belegt,  und  der  FAT-Eintrag  enthalt  einen  Verweis  auf  den  nachsten 
Cluster  der  Datei. 

-  Der  Cluster  ist  belegt  und  ist  der  letzte  von  der  Datei  belegte  Cluster. 

-  Der  Cluster  ist  beschadigt  und  fur  weitere  Benutzung  gesperrt.  Viele  Programme  zum 
Formatieren  von  Disketten  bzw.  Partitionieren  von  Festplatten  benutzen  diese  Moglicb- 
keit,  um  als  defekt  erkannte  Sektoren  fiir  eine  Benutzung  zu  sperren. 

FAT-Eintr£tgek6nnen-jenachGro6e  des  Mediums -jeweils  12oder  16BitgroB  sein.  Unter 
neueren  MS-DOS-Versionen  werden  auch  32-Bit-FATs  benutzt,  fiir  GEMDOS  sind  solche 
Formate  allerdings  nicht  ansprechbar. 

Die  ersten  beiden  Eintrage  der  FAT  sind  unbenutzt,  die  eigentliche  Zahlung  beginnt  also  erst 
bei  2.  Dies  zieht  ein  Mifiverstandnis  in  der  Kommunikation  zwischen  BIOS  und  GEMDOS 
nach  sich,  welches  dazu  fiihrt,  daB  die  beiden  letzten  Cluster  eines  Mediums  nicht  benutzt 
wenden  konnen.  GEMDOS -Dateisysteme  werden  von  MS-DOS  allerdings  nur  dann  korrekt 
erkannt,  wenn  sich  im  ersten  Byte  jeder  FAT  eine  Kopie  des  “Mediabytes”  (siehe  BIOS- 
Einfiihrung)  befindet. 
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Die  moglichen  Werte  fur  die  Eintrage: 


12-Bit-FAT 

16-Bit-FAT 

Bedeutung 

$000 

$0000 

Freier  Cluster 

$001 

$0001 

nicht  erlaubt 

$002  -  $FEF 

$0002  -  $7FFF 

Nummer  des  nachsten  Clusters 

$8000  -  $FFEF 

nicht  erlaubt 

$FF0  -  $FF7 

$FFF0  -  $FFF7 

Unbrauchbarer  (defekter)  Cluster 

$FF8  -  $FFF 

$FFF8  -  SFFFF 

Letzter  Sektor  (Dateieende) 

Curiosity  killed  the  FAT... 

Der  Satz  sagt  es  schon:  Manipulationen  am  Dateisystem  sind  eine  hochstgradig  gefahrliche 
Angelegenheit,  Allen  Programmer  die  direkt  das  Dateisystem  manipulieren  (zum  Beispiel 
Harddisk-”Optimierer”)  sollte  man  mit  einer  gehorigen  Portion  MiStrauen  begegnen! 


Dateiattribute 

Die  verschiedenen  Eigenschaften  einer  Datei  werden  liber  das  Attribut-Byte  im  Verzeichnis- 
eintrag  festgelegt.  Dabei  sind  folgende  Bits  definiert  (alle  weiteren  sind  fur  kunftige  GEM- 
DOS-Versionen  reserviert): 


Bit 

Bitmaske 

Bezeichnung 

Erklarung 

0 

0x01 

FAJREADONLY 

Datei  ist  gegen  Uberschreiben  geschiltzt 

1 

0x02 

FA_HIDDEN 

Versteckte  Datei 

2 

0x04 

FA_SYSTEM 

Systemdatei 

3 

0x08 

FA_VOLUME 

Laufwerksname  (Label) 

4 

0x10 

FAjSUBDIR 

Unterverzeichnis 

5 

0x20 

FA_ARCHIVE 

Archiv-Bit 

Schreibgeschutzte  Dateien  konnen  weder  geloscht  werden,  noch  ist  es  moglich,  schreibend 
auf  sie  zuzugreifen.  Versteckte  Dateien  erscheinen  normalerweise  nicht  im  Verzeichnis  (die 
GEM-Dateiauswahlbox  beriicksichtigt  dies,  das  Desktop  nicht).  Das  Attribut  “Systemdatei” 
hat  seinen  Ursprung  bei  MS-DOS  und  kann  am  besten  als  “darf  nicht  verschoben  werden” 
gedeutet  werden.  Einen  Laufwerksnamen  darf  es  auf  jedem  Laufwerk  nur  einmal  geben.  Wei- 
tere  Attribut-Bits  diirfen  nicht  gesetzt  sein  (eine  Routine  zum  Setzen  des  Laufwerksnamens 
ist  unter  “Fcreate()”  angegeben). 
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FA_VOLUME  und  FA_SUBDER  diirfen  niemals  in  Verbindung  mit  anderen  Attributen 
benutzt  werden:  in  solchen  Fallen  ist  das  Verhalten  von  GEMDOS  undefmiert  (zu  deutsch: 
es  kann  funkdonieren,  aber  auch  zur  Detonation  des  Monitors  flihren). 

Das  Archiv-Bit  wird  erst  ab  GEMDOS  0. 1 5  (Rainbow-TOS)  korrekt  benutzt:  es  wird  gesetzt, 
wenn  eine  Datei  neu  ist  Oder  modifiziert  worden  ist  (allerdings  nicht,  wenn  dabei  ihre  Lange 
unverandert  geblieben  ist).  Backupprogramme  konnen  dieses  Bit  benutzen,  um  die  verander- 
ten  Dateien  eines  Laufwerks  zu  finden  und  zu  kopieren.  AnschlieBend  sollte  es  dann  mit 
“FattribO”  zuriickgesetzt  werden.  Altere  GEMDOS-Versionen  haben  das  Archiv-Bit  einfach 
ignoriert.  Einige  Backup-Programme  haben  dies  ausgenutzt,  indem  sie  das  Bit  bei  archivierten 
Dateien  manuell  gesetzt  haben. 


Medienwechsel  (Mediachange) 

Wenn  eine  Diskette  oder  eine  Wechselplatte  (oder  eine  CD...)  gewechselt  wird,  muB 
GEMDOS  natiirlich  dariiber  informiert  werden.  Insbesondere  miissen  dabei  alle  dieses  Lauf- 
werk  betreffenden  Informationen  (Dateien,  aktuelle  Verzeichnisse,  vom  GEMDOS  gepufferte 
Sektoren)  wieder  zuriickgesetzt  werden. 

Intern  lauft  dabei  ein  kompliziertes  Protokoll  zwischen  BIOS  und  GEMDOS  ab.  Hier  ein 
moglicher  Verlauf  eines  Diskettenwechsels: 

1 .  Der  Benutzer  entnimmt  die  Diskette  und  legt  eine  andere  ein. 

2.  GEMDOS  versucht,  mittels  “RwabsO”  einen  Sektor  zu  lesen,  das  BIOS  liefert  den 
Retum-Wert  E_CHNG  (-14)  zuriick. 

3.  GEMDOS  weiB  nun,  daB  das  Medium  gewechselt  worden  ist  (oder  gewechselt  worden 
sein  konnte).  Deshalb  setzt  es  alle  internen  Informationen  iiber  das  Laufwerk  zuriick  und 
ruft  “GetbpbO”  auf,  um  sich  iiber  den  Aufbau  des  neuen  Mediums  zu  informieren. 

Gleichzeitig  wird  damit  dafiir  gesorgt,  daB  das  BIOS  den  Medienwechsel  als  erkannt 
ansieht  und  ihn  beim  nachsten  Zugriff  nicht  mehr  meldet. 

In  den  “Release  Notes”  zum  TOS  1.04  hat  Atari  eine  Beispielroutine  abgedruckt,  die  einen 
solchen  Medienwechsel  erzwingt.  Dies  ist  fur  zweierlei  Arten  von  Programmen  interessant: 

1 .  Programme,  die  unter  Umgehung  von  GEMDOS  direkt  auf  das  Dateisystem  zugreifen 
und  dort  Daten  verandem  (Festplattenpartitionierer,  Formatierprogramme,  Hilfspro- 
gramme  zum  Reparieren  der  Dateisystemstruktur). 
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2.  Programme,  die  aus  jrgendwelchen  Griinden  dazu  gezwungen  sind,  direkt  “GetbpbQ” 
aufzurufen:  ansonsten  konnte  es  passieren,  daB  ein  etwaiger  Medienwechsel  nicht  an 
GEMDOS  gemeldet  wird  und  dadurch  Informationen  auf  dem  Medium  zerstort  werden 
(beispielsweise  dadurch,  daB  noch  Sektoren  vom  “vorherigen”  Medium  gepuffert  sind). 

Ein  Nachteil  sollte  allerdings  nicht  verschwiegen  werden:  Durch  den  Medienwechsel  gehen 
alle  Informationen  iiber  das  betreffcnde  Laufwerk  verloren;  dazu  gehoren  unter  anderem  die 
aktuellen  Verzeichnisse  und  offene  Dateien. 

Daher  sollte  man  diese  Moglichkeit  nur  dann  benutzen,  wenn  es  wirklich  nicht  anders  geht 
und  die  Effekte  fiir  den  Anwender  verstandlich  sind:  wie  zum  Beispiel  im  Desktop  beim 
Driicken  der  ESC-Taste  Oder  innerhalb  eines  Festplattenpartitionierers  nach  dem  Loschen 
einer  gesamten  Partition. 

Nun  zu  der  Beispielroutine:  Sie  basiert  auf  dem  Verbiegen  der  entsprechenden  BIOS-Funk- 
tionen  auf  eigene  Routinen,  die  einen  Medienwechsel  vorspiegeln.  AnschlieBend  wird  eine 
Datei  auf  dem  betreffenden  Laufwerk  geoffnet  und  in  der  Getbpb-Routine  daftir  gesorgt,  daB 
alle  verbogenen  Vektoren  wieder  zuriickgesetzt  werden  (dazu  wird  das  im  Anhang  beschrie- 
bene  XBRA-Verfahren  benutzt). 

;  Erzwingen  eines  Media-Change 

;  basiert  auf  der  in  den  "Rainbow  TOS  Release  Notes"  vom 
;  7.  8.  89  angegebenen  Routine 

;  Binding  fur  TC:  extern  int  cdecl  raediach  (int  drive); 

;  liefert  1  zuriack,  wenn  GEMDOS  nicht  Getbpb  aufgerufen 
;  hat  (Fehler ! ) ,  sonst  0  (OK) 

. globl  mediach 

mediach : 

move.w  4(sp),d0 
movem.l  dl-a6,-(sp) 

move.w  dO,mydev 
add.b  #"A",dO 
move.b  dO,fspec 

loop: 

clr.l  -(sp) 
move.w  #$20, -(sp) 


;  Laufwerksnummer 
;  Register  retten 


;  in  Dateinamen  eintragen 

;  Supervisor-Modus 
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trap 

#1 

addq 

#6,  sp 

move . 1 

dO,  - (sp) 

move . w 

#$20, -(sp)  ;  2.  Aufruf  vorbereiten 

;  alte  Vektoren  retten 

move . 1 

$472 , oldgetbpb 

move . 1 

$47e, oldmediach 

move . 1 

$476,oldrwabs 

move . 1 

#newgetbpb, $472 

move . 1 

fnewmediach,  $47e 

move . 1 

#newrwabs  ,$476 

;  Date! 

auf  dem  Laufwerk  offnen 

clr  .w 

-(sp) 

move . 1 

#fspec,  - (sp) 

move . w 

#$3d,  - (sp) 

trap 

#1 

addq 

#8,  sp 

;  Datei 

wieder  schlieBen 

tst .  1 

dO 

bmi 

noclose 

move . w 

dO, - (sp) 

move . w 

#$3e,-  (sp) 

trap 

#1 

addq 

#4,  sp 

noclose : 

moveq 

#0,d7  ;  Return-Wert  OK 

crop.  1 

#newgetbpb, $472 

bne 

done  ;  Routine  verschwunden? 

moveq 

#l,d7  ;  sonst  ERROR 

move . 1 

o ldgetbpb ,$472 

move . 1 

oldmediach,  $47e 

move . 1 

oldrwabs, $476 
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done: 

trap  #1  ;  User-Modus 

addq  #6,sp 

move .1  d7 , dO 
movem .1  ( sp ) + ,  dl-a6 
rts 

;  newgetbpb:  wenn  es  das  richtige  Laufwerk  ist:  Vektoren 
;  wieder  aushangen.  Auf  jeden  Fall  aber  die  bisherige 
;  Routine  aufrufen 

.dc.b  "XBRAMDCH" 
oldgetbpb : 

.dc.l  1 

newgetbpb : 

move.w  mydev,dO  ;  richtiges  Laufwerk? 
cmp.w  4(sp),d0 
bne  dooldg 

;  Vektoren  entfernen 
move.l  oldgetbpb, $472 
move . 1  oldmediach, $47e 
move . 1  oldrwabs ,$476 

dooldg : 

move . 1  oldgetbpb, aO 
jmp  (aO) 

;  newmediach:  wenn  es  das  richtige  Laufwerk  ist:  2 
;  zuriickliefern,  ansonsten  die  bisherige  Routine 
;  aufrufen 

.dc.b  "XBRAMDCH" 
oldmediach : 

.dc.l  1 

newmediach : 

move.w  mydev,dO  ;  richtiges  Laufwerk? 
cmp.w  4 (sp)  , dO 
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bne  dooldm 

moveq.l  #2,d0  ;  bestimmt  gewechselt ! 

rts 

dooldm: 

move . 1  oldmediach, aO 
jmp  (aO) 

;  newrwabs:  E_CHNG  (-14)  zuruckliefern,  wenn  es 
;  das  richtige  Laufwerk  ist 

.dc.b  "XBRAMDCH" 
oldrwabs : 

.  dc .  1  1 

newrwabs : 

move . w  my dev , dO 

cmp.w  14(sp),d0  ;  Laufwerksnummer? 

bne  dooldr 

moveq.l  #-14, dO 
rts 

dooldr : 

move . 1  oldrwabs ,  aO 
jmp  (aO) 

.data 

fspec: 

.dc.b  "X: \X”, 0 
.bss 

my dev: 

. ds . w  1 

.end 

GEMDOS-Puffer 

GEMDOS  verfugt  liber  eine  einfache  Pufferverwaltung  fiir  einmal  gelesene  Sektoren.  In 
GEMDOS- Version  0.13  (also  vor  TOS 1 .04)  wurden  diese  Puffer  allerdings  nur  sehr  ineffekti  v 
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benutzt  (zum  Beispiel  wurden  die  Pufferinhalte  schon  beim  Schliefien  einer  Datei  “verges- 
sen”).  Intern  werden  die  Puffer  in  zwei  Listen  einfach  verzeigerter  Pufferkontrollblocke 
verwaltet.  Jeder  dieser  BCBs  (“Buffer-Control-Block”)  sieht  folgendermaBen  aus: 


typedef  struct  _bcb 
{ 


struct  _bcb 
WORD 
WORD 
void 
}  BCB; 


*b_link;  /*  Zeiger  auf  den  nachsten  BCB  */ 
b_negl;  /*  auf  -1  initialisieren  */ 
b_private [5] ; 

*b_buf;  /*  Zeiger  auf  eigentlichen  Puffer  */ 


GEMDOS  verwaltet  zwei  getrennte  Listen:  eine  fur  die  FAT  und  das  Wurzelverzeichnis,  die 
zweite  fur  den  Rest  der  Sektoren  (also  exakt  diejenigen,  die  mit  Hilfe  der  ersten  Liste  verwaltet 
werden). 

Normalerweise  wird  bei  der  Systeminitialisierung  nur  fur  je  zwei  Sektoren  Platz  angelegt. 
Eine  Erweiterung  der  Puffer  fiihrt  daher  zu  einer  deutlichen  Beschleunigung  der  GEMDOS- 
Dateifunktionen. 


Seit  AHDI/HDX  3.0  diirfen  Sektoren  auch  groBer  als  512  Bytes  werden  (laBt  sich  mit  der 
BIOS-Funktion  “GetbpbO”  abffagen).  Beim  Hinzufiigen  von  Puffem  muB  man  also  wissen, 
wie  groB  ein  Sektor  maximal  werden  kann.  Da  es  auch  wechselbare  Medien  (Disketten  Oder 
Wechselplatten)  gibt,  istdiese  Frage  gar  nicht  so  leichtzu  beantworten.  AHDI  3.0  stellt  diese 
Information  in  der  “pun_ptr”-Struktur  (siehe  Systemvariablen)  zur  Verfiigung,  und  jeder  Fest- 
plattentreiber,  der  dazu  kompatibel  sein  will,  sollte  tunlichst  genauso  verfahren. 

Auch  wenn  es  schon  genug  andere  Griinde  gibt,  den  franzdsischen  GEMDOS-Ersatz 
“TurboDos”  (GEMDOS  0. 14)  nicht  zu  benutzen:  “TurboDos”  ist  nicht  dazu  in  der  Lage,  Sek¬ 
toren  von  mehr  als  512  Bytes  GroBe  zu  verwalten. 

Die  einfachste  Methode  zur  Erweiterung  der  Pufferliste  ist,  das  von  Atari  daftir  vorgesehene 
Programm  “CACHENNN.PRG”  zu  benutzen.  Man  findet  es  auf  den  Systemdisketten  zu 
Atari-Festplatten  oder  auch  (hoffentlich)  beim  Atari-Fachhandler. 

Viele  andere  Festplattentreiber  haben  diese  Funktion  bereits  fest  eingebaut  -  so  zum  Beispiel 
HUSHI/SCSI-Tool  von  den  Autoren  dieses  Buchs. 

Um  selbst  neue  Puffer  hinzuzufiigen,  muB  man  also  erst  einmal  die  maximal  benotigle  Sektor- 
groBe  kennen.  Dazu  konsultiert  man  die  vom  Festplattentreiber  installierte  PUN_INFO-Struk- 
tur: 
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typedef  struct 

{ 

WORD  puns ; 

BYTE  pun [16]; 

LONG  part_start [16] ; 

LONG  P_cookie; 

LONG  *P_cookptr; 

UWORD  P_version; 

UWORD  P_jnax_sector; 

LONG  re  served [16]; 

}  PUN_INFO; 

PUN_INFO  *getpun  (void) 

{ 

PUN_INFO  *P; 

LONG  oldstack; 
oldstack  =  Super  (OL) ; 

P  =  * ( (PUN_INFO  **) (0x516L) ) ; 

Super  ( (void  *) oldstack) ; 

if  (P)  /*  uberhaupt  gesetzt?  */ 

if  (P->P_cookie  =  0x41484449L)  /*  Cookie  gesetzt?  */ 
if  (P->P_cookptr  ==  &  (P->P_cookie) ) 
if  (P->P_version  >=  0x300) 
return  P; 

return  OL; 

} 

WORD  get size  (void) 

{ 

PUN__INFO  *P  =  getpun  ()  ; 
if  (P) 

return  P->P_max_sector; 

else 

return  512; 

} 

Wie  installiert  man  nun  einen  neuen  Puffer? 


1 .  Geniigend  Speicher  fur  einen  Sektor  (also  “getsizeO”  benutzen)  allozieren. 
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2.  Speicher  ftir  einen  BCB  allozieren. 

3.  Das  “b_negl”-Feld  des  BCBs  auf  -1  setzen. 

4.  Das  “b_bufr”-Feld  des  BCBs  mit  einem  Zeiger  auf  den  Sektorpuffer  fiillen. 

5 .  Je  nachdem,  an  welche  Liste  der  Puffer  angefiigt  werden  soil :  das  “b_link”-Feld  auf  den 
bisherigen  Inhalt  von  $4B2  bzw.  $4B6  setzen  und  die  Adresse  des  “neuen”  BCBs  in  $4B2 
bzw.  $4B6  eintragen. 

Das  Ganze  wird  fur  jeden  weiteren  Puffer  wiederholt. 

Das  Programm  darf  natiirlich  nicht  normal  terminieren,  sondem  mufi  mit  “PtermresQ”  resi¬ 
dent  installiert  werden. 


Kanale 

Dateikennungen 

Alle  Dateien  und  Gerate  werden  iiber  sogenannte  Handles  (Kennungen)  angesprochen,  bei 
denen  es  sich  um  16-Bit-Zahlen  handelt  (sonst  konnte  man  sie  nicht  von  den  32-Bit-Retum- 
Codes  der  Dateifunktionen  unterscheiden). 

Insgesamt  gibt  es  drei  verschiedene  Klassen  von  Handles: 

-  Die  drei  zeichenorientierten  Kanale  “CON:”,  “AUX:”  und  “PRN:”  mit  den  Handles  -1 , 
-2  und  -3.  Diese  Kanale  geben  quasi  direkt  auf  den  dazugehorigen  BIOS-Funktionen 
aus. 

—  Die  sogenannten  Standardkanale,  die  man  mittels  “FforceO”  auch  umlenken  kann: 

stdin  (0)  Standardeingabe 

stdout  (1)  Standardausgabe 

stdaux  (2)  serielle  Schnittstelle 

stdpm  (3)  parallele  Schnittstelle 

Zusatzlich  gibt  es  noch  die  Standardhandles  4  und  5,  die  allerdings  zur  Zeit  von  GEM¬ 
DOS  nicht  benutzt  werden. 


die  Dateihandles  (ab  Handle  6  aufwarts). 
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Ein-/Ausgabeumlenkung 

Wahrend  die  zeichenorientierten  Kaniile  direktmit  dem  BIOS  und  dieeigentlichen  Dateihandles 
direkt  mit  irgendwelchen  geoffneten  Dateien  verbunden  sind,  muB  man  sich  unter  den 
Standardkanalen  eher  Platzhalter  vorstellen. 

Normalerweise  sind  die  Standardkanale  folgendermaBen  belegt: 


Name 

Numrner 

normalerweise  verbunden  mit 

stdin 

0 

CON:  (-1) 

stdout 

1 

CON:  (-1) 

stdaux 

2 

AUX:  (-2) 

stdpm 

3 

PRN:  (-3) 

Die  Belegung  der  Kanale  4  und  5  ist  nicht  definiert. 

Die  Funktion  “Fforce()”  erlaubt  es,  einem  Standardkanal  ein  neues  Ziel  zu  geben.  Mit 
Fforce  (1,  -2) ; 

konnte  man  beispielsweise  alle  Bildschirmausgaben  auf  die  serielle  Schnittstelle  umlenken. 

“FdupO”  macht  Kopien  von  Dateihandles.  Meistens  wird  es  benutzt,  um  nach  erfolgter  Um- 
lenkung  die  alte  Zuordnung  der  Standardkanale  wiederherstellen  zu  konnen.  Das  kann  zum 
Beispiel  so  aussehen: 

WORD  handle,  dup; 

handle  =  Fcreate  ("TMPFILE",  0) ; 

dup  =  Fdup  (1) ;  /*  Kopie  von  stdout  */ 

Fforce  (1,  handle) ;  /*  umlenken  */ 

/*  ...  Kommandos  bei  umgelenkter  Standardausgabe  ausfuhren  */ 
Fclose  (handle) ; 

Fforce  (1,  dup)  ;  /*  Umlenkung  riickgangig  */ 


Das  ist  leider  nur  die  Theorie.  In  der  Praxis  ist  die  Ein-/Ausgabeumlekung  unter  GEMDOS 
(zumindest  bis  einschlieBlich  GEMDOS  0.19)  mit  erheblichen  Fehlem  behaftet: 
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-  Wenn  man  “FdupQ”  anwendet  and  dann  mittels  “Pexec()”  ein  Programm  startet,  kann 
es  zum  Verlust  von  Handles  und  zur  Zerstorung  GEMDOS-intemer  Strukturen  kommen 
(Problem:  GEMDOS  kommt  praktisch  gar  nicht  mit  mehrfach  von  verschiedenen 
Prozessen  geoffneten  Dateien  zurecht). 

-  Vor  GEMDOS  0.15  funktionierten  weder  Umlenkung  auf  den  Drucker  noch  die 
Umlenkung  aller  Funktionen  zur  Zeichenausgabe  (“C....”). 

Ein-/Ausgabeumlenkung  in  Shells 

Vielleicht  das  wichtigste  Merkmal  eines  “reinrassigen”  Tools  in  Kommandoshells  ist  die 
Beschrankung  auf  die  Zeichenkanale  “stdin”  und  “stdout”.  In  der  C-Standardbibliothek 
bezeichnet  man  damit  die  “Dateien”,  die  (mehr  oder  weniger)  fest  mit  dem  Bildschirm  fiir  Ein- 
und  Ausgabe  verbunden  sind.  Auf  GEMDOS-Ebene  handelt  es  sich  um  die  Standardkanale 
0  (stdin)  und  1  (stdout),  die  man  mit  alien  GEMDOS-Funktionen  direkt  benutzen  kann,  ohne 
sie  erst  offnen  zu  mtissen.  Auch  die  GEMDOS-Standardfunktionen  wie  “CconoutO”  oder 
“CconrsO”  benutzen  immer  Kanal  0  und  1. 

Das  Schone  an  den  GEMDOS-Standardkanalen  ist,  da8  man  sie  “umlenken”  kann.  Ein 
Beispiel:  wenn  das  Archivierungsprogramm  ARC  ein  Inhaltsverzeichnis  ausgibt,  benutzt  es 
den  GEMDOS-Kanal  “stdout”  (Kanal  1).  In  den  meisten  Shells  kann  man  nun  die  Ausgabe 
von  “stdout”  umlenken.  Das  sieht  dann  beispielsweise  so  aus: 

ARC  V  TEST. ARC  >FILELIST 

Die  Shell  sieht  dann  das  Kommando  “>FILELIST”  und  wertet  dies  als  Aufforderung,  auf 
“stdout”  vorgenommene  Ausgaben  in  die  Datei  “FILELIST”  zu  schreiben.  Also  wird  diese 
Datei  angelegt,  und  der  Kanal  “stdout”  mittels  der  GEMDOS-Funktion  “Fforce()”  umgeleitet. 
Dabei  sind  auch  Variationen  moglich: 

-  AuBer  einem  Dateinamen  kann  man  auch  jede  Dateibezeichnung  angeben,  die  GEMDOS 
bei  “Fopen()”  versteht,  beispielsweise  also  “AUX:”  (fiir  die  serielle  Schnittstelle)  oder 
“PRN:”  (fiir  die  parallele  Schnittstelle). 

-  Ein  doppeltes  GroBerzeichen  wird  normalerweise  so  verstanden,  daB  die  angegebene 
Datei  nicht  neu  angelegt  wird,  sondem  daB  die  Daten  hinten  an  die  bestehende  Datei 
angehangt  werden  sollen. 

Was  fiir  “stdout”  gilt,  stimmt  auch  fiir  “stdin”.  Der  Komprimierer  ZOO  kennt  zum  Beispiel 
einen  Modus,  bei  dem  die  Namen  der  zu  komprimierenden  Dateien  von  “stdin”  eingelesen 
werden. 
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Man  konnte  damit  beispiels  weise  mit  einem  Editor  eine  Textdatei  FELES.TXT  mit  den  Namen 
der  zu  komprimierenden  Dateien  anlegen  und  dann  mittels 

ZOO  al  ZOOFILE. ZOO  CFILES.TXT 

von  ZOO  verarbeiten  lassen.  Hier  wird  also  ganz  analog  das  Kleinerzeichen  als  Symbol  fur 
die  Eingabeumlenkung  benutzt. 

Unter  UNIX  gibt  es  nun  eine  ganze  Reihe  von  Standardprogrammen,  die  einfach  nur  Zeichen 
von  “stdin”  lesen,  irgendwie  verarbeiten  und  dann  auf  “stdout”  ausgeben.  So  ein  Programm 
nennt  man  dann  “Filter”.  Viele  Programme  machen  dies  davon  abhangig,  ob  man  sie  mit  oder 
ohne  Parameter  aufruft. 

Besonders  praktisch  sind  solche  Programme,  wenn  man  eine  Shell  besitzt,  die  sogenannte 
“Pipes”  erlaubt.  Durch  eine  Pipe  kann  man  die  Standardausgabe  eines  Programms  mit  der 
Standardeingabe  eines  zweiten  Programms  verbinden.  Bei  einem  Multitasking-Betriebsystem 
laufen  die  einzelnen  Programme  dann  sogar  tatsachlich  gleichzeitig  ab. 

Und  wieder  ein  Beispiel: 

Is  I  zoo  al  zoofile 

Der  senkrechte  Balken  ist  das  sogenannte  Pipe-Symbol,  wie  es  jede  UNIX-  und  UNIX-artige 
Shell  versteht.  Die  Ausgabe  des  ersten  Kommandos  (Is)  wird  direkt  als  Eingabe  fur  ZOO 
benutzt. 

Echte  Pipes  sind  unter  GEMDOS  natiirlich  nicht  moglich.  MitHilfe  der  Ein-/Ausgabeumlenkung 
liber  eine  temporare  Datei  kann  man  allerdings  ein  ahnliches  Ergebnis  erzielen: 

Is  >TEMPFILE 
zoo  al  CTEMPFILE 

Pipes  konnen  selbstverstandlich  auch  mehr  als  zwei  Stufen  haben.  Das  Schone  an  diesen 
Mechanismen:  solange  die  Programme  nur  sauber  fiber  “stdin”  und  “stdout”  operieren, 
brauchen  Sie  selbst  niehts  dariiber  zu  wissen:  die  Hauptarbeit  liegt  bei  der  Shell. 

Ein  Konzept  fiir  stderr 

Ganz  problemlos  ist  dies  allerdings  nicht;  nehmen  wir  mal  den  folgenden  Fall: 


ARC  V  ARCHIV. ARC  >OUtput 
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Mai  angenommen,  die  Archivdatei  ARCHIV.ARC  ist  gar  nicht  vorhanden:  Wie  soil  dann 
ARC  dem  Benutzer  mitteilen,  daB  ein  Fehler  vorliegt?  Die  einfache  Losung  unter  UNIX: 
zusatzlich  zum  Standardausgabekanal  “stdout”  gibt  es  den  Standard-Fehler-Kanal  “stderr”, 
auf  dem  man  Fehler  und  Wamungen  ausgeben  kann.  Die  wichtigsten  Eigenschaften  von 
“stderr”: 

-  “stderr”  ist  normalerweise  mit  dem  Bildschirm  verbunden. 

-  Ein  technisches  Detail:  bei  Verwendung  der  C-Standardbibliothek  ist  “stderr”  immer 
ungepuffert  (wahrend  “stdin”  und  “stdout”  zeilenweise  gepuffert  arbeiten). 

-  Unter  UNIX  ist  “stderr”  Standardkanal  2;  die  Umlenkung  in  der  Shell  lauft  mittels  “2>” 
bzw.  “2<“. 

Ein  besonderer  Leckerbissen:  wie  eben  schon  angedeutet,  kann  man  von  “stderr”  auch  Zei- 
chen  lesen.  Wozu  man  das  nun  wieder  braucht?  Das  Standardtool  “more”  best  beispielsweise 
Zeilen  von  “stdin”  und  bietet  diese  seitenweise  (zum  Blattem)  an.  Nur:  woher  soli  “more”  sei¬ 
ne  Tastendriicke  bekommen,  wenn  “stdin”  schon  mit  einer  Datei  verbunden  ist?  Die  einzige 
Moglichkeit  ist,  auch  das  Lesen  von  “stderr”  zu  erlauben! 

Kommen  wir  zu  dem  unvermeidlichen  (?)  Haken  an  der  Sache:  Leider  hat  Atari  im  GEMDOS 
keinen  Standardfehlerkanal  vorgesehen.  Die  Hersteller  der  C-Compilcr  haben  deshalb  ver- 
schiedene  Methoden  ersonnen,  um  einen  Ersatz  anzubieten. 

Da  gabe  es  zunachst  die  Compiler,  die  “stderr”  und  “stdout”  einfach  auf  den  gleichen  Kanal 
lenken,  womit  natiirlich  fast  alle  Vorteile  zunichte  gemacht  werden.  Nicht  zur  Ubemahme 
empfohlen. 

Eine  zweite  Moglichkeit  ist,  “stderr”  fest  mit  dem  Bildschirm  zu  verbinden  (iiber  GEMDOS- 
Kanal  -1).  Damit  sind  zwar  “stdout”  und  “stderr”  voneinander  getrennt,  aber  “stderr”  kann 
dadurch  nicht  mehr  umgelenkt  werden.  Femer  gehen  viele  UNIX-Programme,  die  man  geme 
portieren  mochte  (z.  B.  “compress”),  davon  aus,  dal)  “stderr”  Kanal  2  ist.  Diese  Losung  wird 
meines  Wissens  von  der  Turbo-C-Library  benutzt.  Elegant,  aber  nicht  ganz  problemlos! 

Die  offensichtliche  Losung  ist,  fur  “stderr”  wie  unter  UNIX  Standardkanal  2  zu  benutzen. 
Kanal  2  wird  von  GEMDOS  normalerweise  fur  die  serielle  Schnittstelle  benutzt. 

Allerdings  hat  Atari  bereits  1986  im  “GEMDOS  Reference  Manual”  darauf  hingewiesen,  dal) 
man  besser  direkt  liber  das  BIOS  auf  die  serielle  Schnittstelle  zugreifen  sollte,  Ansonstenkann 
man  auch  einen  der  “freien”  Standardkanale  benutzen  (nachdem  man  ihn  mit  “FforceO”  auf 
die  serielle  Schnittstelle  umgelenkt  hat). 
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Alle  zum  Mark-Williams-C-Compiler  gehorigen  Tools  und  auch  die  von  diesem  Compiler 
erzeugten  Programme  nutzen  fiir  “stderr”  Kanal  2. 

Der  Nachteil:  normalerweise  ist  Kanal  2  eben  mit  der  seriellen  Schnittstelle  verbunden  -  nur 
wenn  man  in  seiner  Shell  Kanal  2  auf  den  Bildschirm  umlenkt,  bekommt  man  eventuelle 
Fehlermeldungen  zu  Gesicht  (davon  sind  auch  die  meisten  GNU-Programme  betroffen), 

Nichtsdestotrotz  gibt  es  keine  bessere  Alternative.  Atari-Programmierer  Allan  Pratt  machte 
daher  folgenden  Vorschlag:  beim  Start  sollte  jedes  Programm  testen,  ob  Kanal  2  bereits  auf 
eine  Datei  umgelenkt  ist.  Dazu  karrn  man  die  Funktion  “isattyO”  (wie  in  der  GEMDOS- 
Funktionsiibersicht  beschrieben)  verwenden. 

Wenn  dem  nicht  so  ist,  sollte  man  mittels  “Fforce  (2,  -1)”  die  Ausgabe  auf  den  Bildschirm 
umlenken. 

Damit  sind  schon  mal  ein  paar  Probleme  gelost.  Startet  man  ein  solches  Programm  vom 
Desktop  oder  von  einer  “unwissenden”  Shell,  dann  wird  die  Ausgabe  von  “stderr”  auf  den 
Bildschirm  umgelenkt. 

Hat  man  eine  intelligente  Shell,  und  mochte  man  “stderr”  in  eine  Datei  umlenken,  dann  geht 
das  auch. 

Ein  kleiner  Haken  bleibt  jedoch.  Ein  Kommando  wie 

ARC  X  TESTFILE  2>PRN: 

also:  “Bitte  gib  Deine  Fehlermeldungen  auf  dem  Drucker  aus”  wird  nicht  richtig  verstanden. 

Aber  auch  dieses  Problem  laBt  sich  leicht  aus  der  Welt  schaffen.  In  jeder  “guten”  Shell  kann 
man  Environmentvariablen  setzen. 

Wenn  der  Startupcode  das  Vorhandensein  der  Environmentvariablen  “STDERR”  als  Auffor- 
derung  wertet,  Kanal  2  einfach  dort  zu  lassen,  wo  er  ist,  sind  alle  Probleme  beseitigt. 

Das  Schone  an  dieser  Methode  im  Uberblick: 

1 .  “stderr”  verhalt  sich  hier  praktisch  genauso  wie  unter  UNIX. 

2.  Mit  einer  guten  Shell  kann  man  mit  “stderr”  alles  machen,  was  man  sich  wiinschen  kann. 

3.  Diese  Methode  kollidiert  nicht  mit  alten  Programmen  und  benotigt  ausschlieBlich 
vorhandene  und  funktionierende  Funktionen  des  GEMDOS. 
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Einleitung 

GEMDOS  verwaltet  den  Speicher  mittels  zweier  verketteter  Listen  (je  eine  fur  freie  und  eine 
fiir  belegte  Speicherblocke).  In  den  existierenden  GEMDOS-Versionen  wird  diese  Liste 
allerdings  in  einem  statischen  Speicherbereich  geftihrt,  so  daB  es  eine  feste  Grenze  fiir  die 
maximale  Zahl  von  freien  und  belegten  Speicherblocken  gibt  (mehr  dazu  bei  der  Erklarung 
des  “GEMDOS-Pools”).  Fiir  jeden  belegten  Block  wird  vermerkt,  welcher  ProzeB  ihn  alloziert 
hat.  Damit  hat  GEMDOS  die  Moglichkeit,  bei  Programmende  alle  angeforderten  Speicher- 
bereiche  freizugeben. 

Zur  Suche  nach  freien  Speicherblocken  benutzt  GEMDOS  ein  “rotating  first-fit”-Verfahren. 
Dabei  bedeutet  “first-fit”,  daB  GEMDOS  immer  den  ersten  ausreichend  groBen  Block  nimmt 
(und  nicht  etwa  denjenigen,  dessen  GroBe  der  angeforderten  am  nachsten  kommt),  “rotating” 
steht  dafiir,  daB  GEMDOS  diese  Suche  nicht  immer  am  Anfang,  sondem  bei  der  letzten 
Fundstelle  beginnt. 

Die  GEMDOS-Speicherverwaltung  ist  speziell  fiir  relativ  wenige,  groBe  Speicherblocke 
geeignet.  Wer  in  seinem  Programm  viele,  kleine  Blocke  braucht,  sollte  den  Speicher  in 
groBeren  Mengen  anfordem  und  dann  selbst  verwalten  (wie  es  die  meisten  C-Bibliotheken  bei 
“mallocO”  machen).  Dies  ist  iibrigens  kein  GEMDOS-eigenes  Problem  -  andere  Betriebs- 
systeme  wie  UNIX  fiinktionieren  genauso. 

Weitere  Hinweise  zur  Speicherverwaltung  finden  sich  bei  der  Erklarung  der  GEMDOS- 
Funktion  “MallocO”.  Eine  Regel  ist  allerdings  so  wichtig,  daB  sie  hier  nochmals  wiederholt 
wird:  “Du  sollst  nicht  auf  Speicherbereiche  zugreifen,  die  Dir  nicht  gehoren!” 


Der  GEMDOS-Pool 

Vorsicht!  In  diesem  Abschnitt  geht  es  urn  hochst  komplexe  Vorgange  tief  im  Innem  des 
GEMDOS ,  fiir  die  man  sich  eigentlich  gar  nicht  interessieren  miiBte  -  ware  da  nicht  eine  beein- 
druckende  Zahl  von  Fehlem,  Patchprogrammen,  Relikten  aus  alter  Zeit  und  anderen  graB- 
lichen  Dingen  im  Spiel. 

Eine  der  Aufgaben  von  GEMDOS  ist  die  Verwaltung  des  Systemspeichers.  Daraus  ergibt  sich 
natiirlich  eine  Einschrankung  fiir  die  Moglichkeiten,  die  GEMDOS  selbst  hat:  anders  als  die 
hoherliegenden  Betriebssystemschichten  AES  und  VDI  kann  GEMDOS  eben  keine  Aufrufe 
von  “MallocO”  tatigen. 
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Nun  hat  GEMDOS  leider  eine  Menge  von  Aufgaben  zu  erledigen,  die  dynamischer  Natur  sind. 
Dazu  gehort  nicht  nur  die  Verwaltung  freier  und  belegter  Speicherblocke,  sondem  auch  die 
Buchfiihrung  iiber  offene  Dateien  oder  aktuelle  Verzeichnisse.  Dabei  sollte  man  nicht 
vergessen,  daB  jeder  GEMDOS-ProzeB  fiir  jedes  GEMDOS -Laufwerk  ein  aktuelles  Verzeich- 
nis  kennt. 

Zur  Unterbringung  solcher  Informationen  verfiigt  GEMDOS  iiber  den  “GEMDOS  Pool”,  der 
(wen  wundert’s?)  eine  fixe  GroBe  hat  und  bei  Bedarf  nicht  automatisch  vergroBert  werden 
kann. 

Wer  schon  mal  eine  Speicherverwaltung  programmiert  hat,  wird  nun  zu  Recht  einwenden,  daB 
man  zumindest  fiir  eine  ganz  normale  Implementation  von  “MallocO”  gar  keinen  eigenen 
Speicher  braucht.  SchlieBlich  miissen  ja  nur  Listen  von  freien  und  belegten  Blocken  gefiilirt 
werden,  und  dazu  konnte  man  eigentlich  problemlos  jeweils  die  ersten  Bytes  eines  Blocks 
miBbrauchen  (dieses  einfache  Verfahren  wurde  auch  von  Kemighan  und  Ritchie,  den 
Schopfem  der  Sprache  C,  publiziert). 

Leider  legt  GEMDOS  seine  Informationen  im  Pool  ab,  und  so  ist  schon  von  daher  die  maxima¬ 
le  Anzahl  von  durch  “MallocO”  allozierten  Speicherblocken  durch  die  GroBe  des  Pools  be- 
schrankt.  Warum  Atari  das  noch  nicht  geandert  hat?  Viele  Programme  verlassen  sich  darauf, 
daB  nacheinander  allozierte  Speicherblocke  auch  an  aufeinanderliegenden  Adressen  liegen  - 
was  natiirlich  nicht  nur  gar  nicht  immer  der  Fall  ist,  sondem  natiirlich  auch  nie  dokumentiert 
war.  Daher  zur  Zeit  diese  Riicksichtnahme  auf  fehlerhafte  Programme  von  gestem,  die  Atari 
hoffentlich  bei  der  nachsten  grofieren  Uberarbeitung  von  GEMDOS  aufgeben  wild. 

Zuriick  zur  Belegung  des  Pools:  Jedes  “aktive”  Verzeichnis  belegt  zwei  Eintrage.  Ein  Ver- 
zeichnis  ist  aktiv,  wenn  es  ein  aktuelles  Verzeichnis  oder  ein  Wurzelverzeichnis  ist  oder  wenn 
es  eine  offene  Datei  oder  ein  aktives  Unterverzeichnis  enthalt.  Wenn  man  eine  Datei  offnet, 
die  innerhalb  einer  zehnfach  verschachtelten  Ordnerhierarchie  steckt,  sind  dadurch  insgesamt 
zehn  Verzeichnisse  aktiv. 

Zu  beachten  ist  dabei,  daB  jedes  Verzeichnis  nur  einmal  im  Pool  auftaucht,  egal  aus  wie  vielen 
Griinden  es  offen  ist.  Zusatzlich  braucht  jede  offene  Datei  einen  Eintrag  und  jeder  freie  oder 
belegte  Speicherblock  1/4  eines  Eintrags. 

Der  “40-Ordner-Fehler” 

Alte  GEMDOS-Versionen  (vor  0.15  im  TOS  1.04)  hatten  nun  ein  groBes  Problem:  War  ein 
Verzeichnis  einmal  aktiv  geworden,  dann  wurde  der  entsprechende  Eintrag  nie  wieder  aus 
dem  GEMDOS-Pool  entfemt.  Und  so  konnte  man  im  TOS  1.00  maximal  40  Ordner  offnen. 
Im  TOS  1.02  (Blitter-TOS)  entscharfte  man  das  Problem,  indem  man  die  GroBe  des  Pools 
vergrofierte  (und  damit  natiirlich  den  freien  Speicherplatz  verminderte). 
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Wie  auBerte  sich  nun  das  Problem?  Einmal  konnte  es  bei  Aufrufen  von  “MallocO”  zu 
Fehlermeldungen  kommen,  obwohl  eigentlich  noch  Speicher  vorhanden  gewesen  ware.  Der 
andere  Effekt  war,  daB  geoffnete  Verzeichnisse  scheinbar  leer  waren,  weil  einfach  nicht  genug 
Speicher  zum  Verwalten  der  Verzeichnisinformationen  da  war. 

Was  ist  nun  bei  Atari  untemommen  worden? 

Zunachst  fiihrte  man  ab  TOS  1 .02  einen  Zeiger  im  ROM-Header  (siehe  “_sysbase”)  ein,  iiber 
den  diese  Liste  nachtraglich  erweitert  werden  kann.  Dieser  Zeiger  (oder  die  fixe  Adresse  im 
TOS  1.00)  wird  vom  Programm  “FOLDRIOO.PRG”  benutzt,  um  den  GEMDOS-Pool  zu 
erweitem.  Fiir  “100”  kann  eine  beliebige  Zahl  eingesetzt  werden  -  “FOLDRIOO.PRG” 
erweitert  den  GEMDOS-Pool  um  200  Eintrage  zur  Aufnahme  von  100  aktiven  Verzeichnis- 
sen.  “FOLDRIOO.PRG”  befindet  sich  auf  der  Systemdiskette  zu  Atari-Festplatten,  in  prak- 
tisch  alien  Mailboxen  und  sollte  auch  bei  jedem  Atari-Handler  zu  bekommen  sein.  Viele 
Harddisktreiber  (“AHDI”,  “HUSHI”  und  andere)  sorgen  bereits  selbsttatig  fiir  eine  Auf- 
stockung  des  Pools. 

In  GEMDOS  0.15  (TOS  1.04)  hat  Atari  viel  verbessert.  Der  Pool  hat  noch  immer  eine  feste 
GroBe,  wird  aber  erheblich  besser  genutzt.  Insbesondere  werden  Eintrage  von  nicht  mehr 
aktiven  Verzeichnissen  wieder  freigegeben,  und  auch  die  Wiederverwendung  freigewordener 
Eintrage  ist  geschickter  geregelt.  Konsequenterweise  hat  man  den  GEMDOS-Pool  auch 
wieder  auf  die  urspriingliche  Lange  zuriickgestutzt. 

Durch  das  Offnen  vieler  Verzeichnisse  kann  man  nun  eigentlich  nicht  mehr  in  Bedrangnis 
kommen,  wohl  aber  durch  allzu  viele  “Malloc()”-Aufrufe.  Es  kann  also  immer  noch  vorkom- 
men,  daB  man  bei  “MallocO”  eine  Fehlermeldung  erhalt,  obwohl  eigentlich  noch  Speicher  da 
ware.  Statt  dessen  sollte  man  natiirlich  eine  Laufzeitbibliothek  benutzen,  die  den  Speicher  in 
Stiicken  von  mindestens  1 6  Kilobyte  per  “MallocO”  anfordert  und  dann  die  Verwaltung  selbst 
erledigt  (allemir bekannten  C-Bibliotheken  funktionieren  so).  Immerhin  erhalt  man  eine  sinn- 
volle  Fehlermeldung,  die  man  eben  nur  richtig  interpretieren  muB. 

Das  Problem  der  aktiven  Verzeichnisse  wird  durch  die  verbesserten  Algorithmen  bereits  stark 
gelindert.  Wexui  tatsachlich  trotzdem  mal  der  GEMDOS-Pool  iiberlauft,  bekommt  man  eine 
Fehlermeldung  auf  den  Bildschirm,  und  das  System  steht: 

***  OUT  OF  INTERNAL  MEMORY: 

***  USE  FOLDRIOO.PRG  TO  GET  MORE. 

***  SYSTEM  HALTED  *** 

Das  ist  zwar  nicht  schon,  aber  besser  als  ein  Weiterarbeiten  ineinem  undefinierten  Systemzustand. 
Der  Tip,  “FOLDR100”  zu  benutzen,  ist  allerdingskaumhilfreich:  nach  menschlichem  Ermes- 
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sen  kann  das  Problem  im  normalen  Betrieb  gar  nicht  auftreten  (es  sei  denn,  man  versucht  tat- 
sachlich,  viele  sehr  tief  geschachtelte  Dateien  zu  offnen).  Der  Grand  ist  mit  sehr  hoher  Wahr- 
scheinlichkeit  eine  Zerstorung  intemer  GEMDOS-Variablen  durch  ein  fehlerhaftes  Pro- 
gramm. 

Ein  solcher  Ubeltater  war  pikanterweise  GEMDOS  selbst  (in  der  Version  0. 1 5 ,  die  man  in  TOS 
1.04  und  TOS  1.06  findet).  Lange  Rede,  kurzer  Sinn:  bei  diesen  TOS-Versionen  sollte  man 
das  Programm  “POOLFIX3.PRG”  im  AUTO-Ordner  haben  (Bezugsquelle:  Systemdiskette, 
Mailboxen,  Atari-Handler). 

Wenn  man  dennoch  die  Fehlermeldung  zu  sehen  bekommt,  dann  liegt  das  meist  daran,  daB 
GEMDOS  abgrundtief  verwirrt  ist.  Selbst  unter  GEMDOS  0. 19  kann  man  solche  Effekte  in 
Abhangigkeit  mit  der  (nicht  vollstandig  korrekt  funktionierenden)  Ein-/Ausgabeumlenkung 
provozieren. 


Alternate  RAM 

Bei  der  Entwicklung  der  TT-Reihe  stand  Atari  vor  einem  grofien  Problem;  Wie  kompatibel 
sollte  die  Hardware  der  neuen  Rechnem  zu  den  “alten”  ST-Modellen  sein?  Erste  Prototypen 
von  68020-Systemen,  die  auf  Ebene  der  Hardware  nicht  vollstandig  kompatibel  waren,  wur- 
den  deshalb  nie  zur  Marktreife  entwickelt. 

Hauptproblem  waren  die  vielen  Programme,  die  aus  verschiedenen  Griinden  direkt 
Hardwarebausteine  des  ST  ansteuem.  In  manchen  Fallen  hatten  die  Programmierer  keine 
andere  Wahl  (Geratetreiber),  in  vielen  Fallen  jedoch  war  es  einfach  die  mangelnde  Voraus- 
sicht  der  Programmierer. 

So  entschloB  sich  Atari,  im  TT  praktisch  samtliche  Bausteine  des  urspriinglichen  ST  beizu- 
behalten:  eine  Entscheidung,  die  nicht  nur  die  Fertigstellung  massiv  verzogert,  sondem  auch 
mit  Sicherheit  die  Kosten  des  Rechners  unnotig  erhoht  hat. 

Nun  war  der  ST  eigentlich  ein  24-Bit-System,  und  die  “alte”  Architektur  ist  nicht  in  der  Lage, 
mit  den  32  Bit  groBen  Speicheradressen  des  TT  zurechtzukommen. 

Daher  verpaBte  man  dem  TT  zwei  verschiedene  Arten  von  Speicher:  das  ST-RAM  (das  immer 
im  24-Bit- AdreBbereich,  also  in  den  ersten  16  MByte  liegt)  und  das  restliche  RAM  -  das 
“Alternate  RAM”. 

Als  Faustregel  gilt:  Die  “alte”  ST-kompatible  Hardware  kann  ausschlieBlich  auf  Adressen  im 
ST-RAM  zugreifen. 
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Dazu  gehoren: 

-  der  Videochip.  Daher  darf  man  “SetscreenO”  nur  fiir  Adressen  im  ST-RAM  benutzen. 
Das  Ganze  stellt  aber  kein  emsthaftes  Problem  dar,  weil  “ordentliche”  Grafikprogramme 
sowieso  nur  ausschlieBlich  iiber  VDI  und  AES  ausgeben  diirfen. 

-  der  DMA-Soundchip:  fiir  diesen  Soundchip  (im  STE  und  TT)  gibt  es  bislang  leider  keine 
Softwareunterstiitzung  durch  das  Betriebssystem. 

-  ACSI-DMA:  der  Direktzugriff  auf  Festplatten  am  ACSI-Port  sollte  sowieso  den  dafiir 
spezialisierten  Treibem  tiberlassen  bleiben.  Die  Laserdrucker  der  SLM-Reihe  sollten 
ausschlieBlich  via  VDI  oder  Diablo-Treiber  angesteuert  werden. 

-  . .  .und  schlieBlich  darf  man  selbstverstandlich  nicht  davon  ausgehen,  daB  -  wie  auf  einem 
68000er-System  -  die  obersten  acht  Bits  einer  Adresse  unbenutzt  sind  und  anderweitig 
benutzt  werden  konnen. 

Samtliches  RAM,  das  nicht  ST-kompatibel  ist,  heiBt  “Alternate”  (also  “anderes”)  RAM.  Wei- 
tere  Informationen  hat  man  nicht.  Im  TT  kann  “Alternate  RAM”  sowohl  das  schnelle  TT- 
RAM  (auf  das  man  per  SCSI-DMA  zugreifen  kann)  als  auch  ganzbesonders  langsames  RAM 
auf  einer  VME-Bus-Karte  sein  (etwa  bei  einer  Grafikkarte) .  “Maddalt()  ”  erlaubt  es,  auch  noch 
nach  der  Systeminitialisierung  Blocke  von  Alternate  RAM  in  dieGEMDOS-Speicherliste  ein- 
zuhangen. 

GEMDOS  verwaltet  ST-RAM  und  Alternate  RAM  in  zwei  vollig  voneinander  getrennten 
Listen.  Wichtige  Folge:  Auf  einem  TT  ist  der  freie  Speicher  bereits  beim  Systemstart  segmen- 
tiert  -  in  zwei  groBe  Blocke  aus  ST-RAM  bzw.  Alternate  RAM. 

GEMDOS  nimmt  sich  dieser  Problematik  mit  zwei  verschiedenen  Strategien  an.  Einerseits 
kann  man  im  Header  einer  Programmdatei  festlegen,  ob  der  Programmcode  im  Alternate 
RAM  liegen  und  ob  Speicher  aus  dem  Alternate  RAM  alloziert  werden  darf  (mehr  dazu 
spater).  Zusatzlich  hat  man  mit  “MxallocO”  eine  genaue  Kontrolle  dariiber,  welche  RAM- Art 
benutzt  wird. 

In  den  letzten  Jahren  hat  sich  die  Qualitat  der  Software  signifikant  verbessert.  Daher  kann  man 
davon  ausgehen,  daB  die  “nSchste”  Rechnerfamilie  von  Atari  auf  Ebene  der  Hardware  nicht 
mehr  voll  kompatibel  sein  wird  (von  der  CPU  aus  der  68000-Familie  abgesehen).  Also: 
keinerlei  direkte  Zugriffe  auf  ST-  oder  TT-Hardware  machen!  Ein  Programm,  das  heute  nicht 
einwandfrei  im  Alternate  RAM  laufen  kann,  wird  auf  der  nachsten  Rechnergeneration  erst 
recht  nicht  funktionieren.  Wer  direkt  die  Hardware  ansprechen  muB,  sollte  dies  immer  iiber 
eine  Treiberschnittstelle  -  zum  Beispiel  iiber  “Meta-DOS”  -  machen! 
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Prozesse 

Was  ist  ein  GEMDOS-Prozeli? 

GEMDOS  ist  kein  Multitasking-System,  das  heifit,  es  kann  nicht  mehr  als  ein  Programm 
gleichzeitig  ausgefiihrt  werden.  Dennoch  sind  die  grundlegenden  Strukturen  dafiir  vorhandem 
jedes  geladene  Programm  wird  von  GEMDOS  als  eigenstandiger  Prme.fi  verwaltet.  Mit  Hilfe 
von  “PexecO”  konnen  weitere  Programme  nachgeladen  und  wie  ein  Unterprogramm  ausge- 
fiihrt  werden.  Wahrenddessen  wird  das  aufrufende  Programm  unterbrochen. 

GEMDOS  merkt  sich  samtlicheprozeBspezifischen  Daten  in  der  Basepage,  einer  Datenstruktur, 
die  automatisch  beim  Programmstart  angelegt  wird.  Zu  den  in  der  Basepage  abgelegten  Infor- 
mationen  gehoren: 

-  Zeiger  auf  die  Basepage-Struktur  des  aufrufenden  Prozesses 

-  Informationen  iiber  die  verschiedenen  Bestandteile  des  Programms  nach  dem  Laden 

-  Informationen  iiber  aktuelles  Laufwerk  und  aktuelle  Verzeichnisse 

-  Informationen  iiber  die  Zuordnung  der  Standardkanale 
Informationen  iiber  die  Tauglichkeit  des  Programms  im  “Alternate  RAM” 

-  Inhalte  der  Register,  die  nicht  von  GEMDOS  verandert  werden  diirfen 

Alle  diese  Informationen  werden  also  fur  jeden  ProzeB  separat  gespeichert  (auch  wenn  einige 
an  nichtdokumentierten  Stellen  der  Basepage  verwahrt  sind).  Beim  Starten  eines  Programms 
werden  sie  als  aktuelle  Einstellungen  an  den  Kindprozefi  weitervererbt. 

Dies  ist  auch  eine  der  ganz  wenigen  Stellen,  an  denen  GEMDOS  iiber  das  Vorbild  MS-DOS 
herausragt:  dort  werden  die  aktuellen  Verzeichnisse  nur  einmal  global  verwaltet.  Die  Folge 
ist,  dab  nach  Start  eines  Programms  aktuelle  Verzeichnisse  und  aktuelles  Laufwerk  verstellt 
sein  konnen. 

Zu  jedem  ProzeB  gibt  es  einen  Eltemprozefi ,  der  ihn  gestartet  hat.  Einzige  Ausnahme  ist  der 
Urprozefi,  der  beim  Aktivieren  von  GEMDOS  angelegt  wird.  Damitergibt  sich  eine  Prozefi- 
hierarchie.  Mit  den  aktuellen  GEMDOS-Versionen  kann  man  nur  neue  Prozesse  erzeugen, 
indem  man  den  aktuellen  ProzeB  bis  zur  Beendigung  des  aufgemfenen  Programms  suspendiert. 
Damitkannman  sich  dieProzeBhierarchie  als  Stapel  vorstellen.  Untereinem  multitaskingfahigen 
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Belricbssystem  wird  das  Ganze  eher  wie  ein  von  einem  Wurzelprozefi  ausgehender  Baum 
aussehen. 

GEMDOS  kennt  immer  nur  einen  aktuellen  Prozefi.  Dazu  gibt  es  im  GEMDOS -Irmeren  die 
Zeigervariable  “act_pd”,  die  auf  die  entsprechende  Basepage-Struktur  zeigt.  “act_pd”  ist 
keine  echte  Systemvariable,  sondem  vielmehr  eine  lokale  Variable  von  GEMDOS. 

ZurErmittlung  ihrer  Position  gibt  es  von  Atari  ein  Programmbeispiel  (Quelle:  “Rainbow  TOS 
Release  Notes”),  das  wir  hier  in  abgewandelter  Form  abdrucken: 

/*  Ermittle  Adresse  der  GEMDOS-Variable  act_pd.  Die  Funktion 
liefert  also  einen  Zeiger  auf  einen  BASEPAGE-Zeiger . 

Ab  TOS  1.02  enthalt  der  ROM-Header  den  Zeiger.  In  TOS  1.00  liegt 
der  Zeiger  bei  Adresse  $602C,  es  sei  denn,  es  handelt  sich  urn 
ein  spanisches  TOS  (dann  bei  $8730  - 

Wichtiger  Hinweis:  funktioniert  unter  Urastanden  nicht  mit 
gepatchten  Versionen  von  TOS  1.00  */ 

BASEPAGE  *  *GetRun  (void) 

{ 

LONG  savessp  =  Super  (OL) ; 

OSHEADER  *0  =  * ( (OSHEADER  **) (0x4f2L) ) ; 

Super  ((void  *)  savessp); 

0  =  0->os__beg;  /*  wegen  Fehlers  in  alter  AHDI-Version  */ 

if  (0->os_version  <  0x102) 

{ 

if  ( (0->os_conf  »  1)  ==  4)  /*  PAL-Modus  wegshiften  */ 

return  ((BASEPAGE  **)0x873c);  /*  Spanisches  TOS  1.0  */ 
else 

return  ((BASEPAGE  **)0x602c); 

} 

else 

return  0->p_run; 

1 

Prinzipiell  ist  es  damit  moglich,  zwischen  zwei  parallel  laufenden  GEMDOS  -Prozessen  hin- 
und  herzuschalten.  Doch  Vorsicht:  Diese  Variable  darf  laut  Atari  aufkeinen  Fall  verandert 
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werden.  Probleme  mit  kiinftigen  multitaskingfahigen  GEMDOS-Versionen  waren  vor- 
programmiert! 

Die  Basepage 

Die  Basepage  ist  insgesamt  256  Bytes  lang  und  hat  folgende  Struktur: 

typedef  struct  basepage 

{ 

void  *p_lowtpa;  /*  Anfangsadresse  der  TPA  (Offset  0)  */ 
void  *p_hitpa;  /*  Erstes  Byte  nach  dem  Ende  der  TPA 

(Offset  4)  */ 

void  *p_tbase;  /*  Anfangsadresse  des  Programmcodes  (TEXT- 

Abschnitt)  (Offset  8)  */ 

LONG  p_tlen;  /*  Lange  des  Programmcodes  (Offset  12)  */ 

void  *p_dbase;  /*  Adresse  des  Bereichs  fur 

vorinitialisierte  Daten  (DATA-Abschnitt ) 
(Offset  16)  */ 

LONG  p_dlen;  /*  Lange  des  Datenabschnitts  (Offset  20)  */ 

void  *p_bbase;  /*  Adresse  des  Variablenbereichs  (BSS- 

Abschnitt)  (Offset  24)  */ 

LONG  p_blen;  /*  Lange  des  Variablenbereichs  (Offset  28)  */ 
DTA  *p_dta;  /*  Zeiger  auf  Default -DTA  (Vorsicht!  Zeigt 

erst  in  die  Kommandozeile)  (Offset  32)  */ 

struct  basepage 

*p_parent;  /*  Zeigt  auf  die  Basepage  (BASEPAGE)  des 

aufrufenden  Prozesses  (Offset  36)  */ 
LONG  p_resrvd0;  /*  reserviert  */ 

CHAR  *p_env;  /*  Adresse  der  Environment-Strings 

(Offset  44)  */ 

CHAR  p_resrvdl [80] ;  /*  reserviert  */ 

CHAR  p_cmdlin [128] ;  /*  Kommandozeile  (dabei  wird  im  ersten 

Byte  die  Anzahl  der  Zeichen  einge- 
setzt.  Die  maximale  Lange  der 
Kommandozeile  belauft  sich 
erstaunlicherweise  nicht  auf  127, 
sondern  auf  124  Zeichen.) 

(Offset  128)  */ 


}  BASEPAGE; 
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Wichtiger  Hinweis:  der  Zeiger  “p_parent”  ist  zwar  offiziell  dokumentiert,  sollte  aber  nicht 
dazu  miBbraucht  werden,  in  den  Speicherbereich  des  Aufrufers  zu  schauen. 

Dies  ware  ein  eklatanter  VerstoB  gegen  die  Regel:  “Du  sollst  nur  auf  Speicher  zugreifen,  der 
Dir  selbst  gehort”. 


TPA  und  Programmstart 

Die  TPA  (“Transient  Program  Area”)  kommt  beim  Laden  eines  Programms  ins  Spiel.  Die 
folgenden  Informationen  zum  Ladevorgang  beschreiben  den  (dokumentierten)  IST-Zustand 
von  GEMDOS. 

Manche  Details  konnten  sick  allerdings  in  kiinftigen  GEMDOS -Versionen  andem. 

-  Beim  Programmstart  wird  der  groBte  zusammenhangende  Speicherbereich  alloziert.  Die 
Basepage  wird  in  den  ersten  256  Bytes  der  TPA  angelegt. 

-  AnsehlieBend  werden  alien  zu  “vererbenden”  Informationen  aus  der  Basepage  des  auf- 
rufenden  Programms  iibertragen.  Der  neuerzeugte  ProzeB  wird  als  Inhaber  des  durch  die 
TPA  belegten  Speicherblocks  eingetragen.  Damit  “gehort”  der  durch  die  TPA  belegte 
Speicher  dem  gestarteten  Programm. 

-  AnsehlieBend  wird  der  Header  der  Programmdatei  ausgewertet  (eine  detaillierte  Schil- 
derung  des  Programmformats  folgt  spater). 

Die  Programmdatei  wird  geladen  und  die  verbleibenden  Felder  in  der  Basepage  gesetzt. 
Je  nach  Programmtyp  wird  das  BSS-Segment  oder  der  ganze  verbleibende  Rest  der  TPA 
geloscht. 

-  Dann  bekommt  der  neue  ProzeB  einen  eigenen  Stack,  der  direkt  am  Ende  der  TPA 
beginnt  (und  bekanntlich  nach  unten  -  also  nach  den  niedrigeren  Adressen  hin  -  wachst). 

-  Als  Parameter  werden  eine  Null  (LONG)  und  die  Anfangsadresse  der  Basepage  auf  dem 
Stack  iibergeben. 

-  Zuletzt  wird  der  neue  ProzeB  zum  aktuellen  ProzeB  gemacht  und  durch  einen  Sprung  zum 
ersten  Byte  des  Textsegments  aktiviert. 

Den  Aufbau  der  TPA  entnehmen  Sie  bitte  der  Abbildung  auf  der  folgenden  Seite. 
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Stack 


Variablenbereich  (BSS) 


Datenbereich  (DATA) 


Programmcode  (TEXT) 


Basepage 


High  TPA  (pjiitpa) 


p_bbase 

p_dbase 

p_tbase 

Low  TPA  (p_lowta) 


Je  nach  Speicheraufteilung  beim  Programmstart  kann  es  also  ohne  weiteres  passieren,  dal)  der 
gesamte  freie  Speicher  fiir  das  Programm  reserviert  worden  ist.  Das  darf  natiirlich  nicht  so 
bleiben: 

-  Viele  Betriebssystemfunktionen  (VDI,  “fsel_input()”,  “PexecO”)  verbrauchen  selbst 
Speicher! 

-  Unter  einem  multitaskingfahigen  Betriebssystem  ist  es  ausgesprochen  unpopular,  den 
gesamten  freien  Speicherplatz  des  Systems  zu  blockieren.  Bereits  jetzt  gibt  es  einige 
TOS-Erweiterungen,  unter  denen  dies  zu  beriicksichtigen  ist  (beispielsweise  das  “Multi- 
GEM”  der  Maxon  GmbH). 

Die  Abhilfe  ist  einfach: 

1 .  Eigenen  Stack  einrichten. 

2.  UberflUssigen  Speicher  wieder  freigeben. 

3.  Bei  Bedarf  innerhalb  des  Programms  per  “MallocQ”  Speicher  nachfordem. 

Beim  Einrichten  des  eigenen  Stacks  hat  man  verschiedene  Moglichkeiten.  Einerseits  kann 
man  von  Beginn  an  ein  entsprechend  groBes  Stuck  der  BSS  freihalten.  Andererseits  kann  man 
sich  natiirlich  auch  einen  Teil  der  “freien”  TPA  abknapsen.  In  beiden  Fallen  sollte  man  aber 
daran  denken,  daB  der  Stack  zu  niedrigeren  Adressen  hin  wachst  und  der  Stack-Pointer  daher 
zu  Beginn  auf  das  Ende  des  freigehaltenen  Speicherblocks  zeigen  muB! 
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Die  TPA  hat  nunmehr  diese  Aufteilung  (ob  der  Stack  in  oder  iiber  der  BSS  liegt,  spielt  in 
diesem  Zusammenhang  keine  Rolle): 

High  TPA  (pjiitpa) 

Stack-Pointer 


p_bbase 

p„dbase 

p_tbase 

Low  TPA  (p_lowta) 


freigewordener  Speicher 


Stack 


Variablenbereich  (BSS) 


Datenbereich  (DATA) 


Programmcode  (TEXT) 


Basepage 


Nun  muB  noch  der  freigewordene  Speicher  an  GEMDOS  zuriickgegeben  werden.  Kein  Pro¬ 
blem,  da  ja  der  durch  die  TPA  belegte  Speicherplatz  dem  Programm  selbst  gehort: 

1 ,  Man  berechne,  wieviel  Speicherplatz  man  braucht.  Dazu  summiere  man  die  Lange  der 
Basepage  (256),  des  Text-,  Data-  und  BSS-Segments  sowie  gegebenfalls  des  Stacks  auf. 
Die  Langen  sind  in  der  Basepage  angegeben,  deren  Anfangsadresse  als  Parameter  auf 
dem  Stack  (4(sp))  mitgeteilt  wird. 

2.  Der  so  erhaltene  Wert  ist  die  Anzahl  der  Bytes,  auf  die  die  TPA  nun  mit  “MshrinkO”  ge- 
schrumpft  werden  kann. 

Und  so  konnte  der  Code  am  Beginn  des  Textsegments  aussehen: 


;  Startup  und  Prozeflbeendigung 
;  Assembler:  Madmac 


.text 

move . 1 

4 (sp) , aO 

lea 

My Stack, sp 

move . 1 

#$100, dO 

add.l 

$c(a0)  ,d0 

add.l 

$14 (aO)  ,d0 

add.l 

$lc (aO) ,d0 

Zeiger  auf  BASEPAGE-Struktur 
Stack-Pointer  setzen 
Lange  der  Basepage 
Lange  Text -Segment 
Lange  Daten- Segment 
Lange  BSS 
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move . 1 

dO,  - (sp) 

r 

Ergebnis  auf  den  Stack 

move . 1 

a0,-  (sp) 

} 

BASEPAGE -Adresse  auf  den  Stack 

clr  .w 

-  (sp) 

r 

Fullparameter 

move . w 

#$4a, - (sp) 

t 

GEMDOS  Mshrink 

trap 

#1 

f 

GEMDOS-Trap 

lea 

$c(sp)  ,sp 

/ 

Stack  aufraumen 

jsr 

main 

r 

Hauptprogramm  aufrufen 

move.w 

dO,- (sp) 

7 

Return-Wert  des  Programms 

move . w 

#$4c,~ (sp) 

r 

GEMDOS  Pterm 

trap 

#1 

} 

GEMDOS-Trap 

.bss 

. ds.l  1000 

t 

4000  Bytes  Stack 

MyStack: 

.ds. 1  2 

Damit  ware  dann  die  Anpassung  der  TPA  beendet: 


Stack-Pointer 


p_bbase 
p_dbase 
p_tbase 

Low  TPA  (pjowta) 

GEMDOS  kartn  den  so  freigegebenen  Speicher  nun  wieder  fur  andere  Zwecke  nutzen  -  zum 
Beispiel  zum  Starten  weiterer  Programme  Oder  um  Speicheranforderungen  mittels  “MallocO” 
zu  bedienen. 

Nach  Beendigung  des  eigenen  Programms  wird  dann  die  gesamte  TPA  wieder  freigegeben. 
Es  sei  noch  auf  zwei  Sonderfalle  hingewiesen: 

TSR-Programme  (“Terminate  und  Stay  Resident”)  sind  eine  beliebte  Methode,  um  Betriebs- 
systemerweiterungen  oder  -veranderungen  vorzunehmen.  Beispiele  sind“GDOS”  (Betriebs- 


Stack 


Variablenbereich  (BSS) 


Datenbereich  (DATA) 


Programmcode  (TEXT) 


Basepage 
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systemerganzung  bzw.  -vervollstandigung),  “Meta-DOS”  (Betriebssystemerweiterang)  Oder 
“POOLFIX3”  (Betriebssystenimodifikation).  Besonderes  Kennzeichen  von  TSR-Program- 
men  ist,  daB  sie  Betriebssystem-Vektoren  modifizieren  und  dann  resident  im  Speicher  veran- 
kert  werden.  Daftir  gibt  es  die  Funktion  “PtermresO”,  die  ein  Programm  beendet,  dabei  aber 
einen  bestimmten  Anted  der  TPA  nicht  wieder  freigibt.  Die  Anzahl  der  zu  schiitzenden  Bytes 
kann  man  genauso  wie  fur  “MshrinkO”  berechnen. 

Wer  die  BASEPAGE-Struktur  aufmerksam  angesehen  hat,  wird  festgestellt  haben,  daB  die 
drei  Programmsegmente  gar  nicht  unbedingt  in  aufeinanderfolgenden  AdreBbereichen  liegen 
miissen.  Damit  ware  es  prinzipiell  denkbar,  das  Textsegment  im  ROM  und  diebeiden  anderen 
Segmente  im  RAM  abzulegen. 

Dazu  muB  man  allerdings  bei  Programmstart  die  Zeiger  aus  der  Basepage  beachten  und  nur 
indirekt  iiber  die  Zeiger  auf  Variablen  zugreifen.  Wegen  der  eher  geringen  Bedeutung  ROM- 
gestiitzter  Programme  bieten  leider  nur  wenige  Programmiersprachen  die  Moglichkeit,  solche 
Programme  zu  erzeugen. 


Environment 

Auch  die  Environment-Strings  sind  ein  Erbe  von  MS-DOS.  Man  beachte,  daB  es  mehrere 
Environment-Strings  geben  kann,  denn  “p_env”  zeigt  auf  eine  Liste  von  Strings,  die  mit  einer 
“0”  abgeschlossen  ist  (am  Ende  der  Strings  stehen  also  zwei  Nullen  hintereinander). 

Bei  jedem  Programmstart  mittels  “PexecO”  wird  eine  Kopie  des  aktuellen  Environments 
gemacht  und  dem  gestarteten  Programm  iibergeben.  Mochte  man  dabei  ein  geandertes 
Environment  iibergeben,  dann  muB  man  selbst  eine  erweiterte  Kopie  anlegen  und  bei 
“Pexec()”  einen  Zeiger  darauf  iibergeben.  Das  Environment  von  Parent- Prozessen  kann  nicht 
verandert  werden. 

GEM  hat  ein  eigenes  Environment,  das  beim  Starten  der  AES  nach  Ausfiihrung  der 
Programme  im  AUTO-Ordner  festgelegt  wird  (weitere  Informationen  dazu  bei  der  AES- 
Funktion  “shel„envm()”). 

Das  Standardformat  fiir  einen  Environment-String  sieht  so  aus: 

VARIABIE=Wert 

Variablenname  und  Wert  sind  also  durch  ein  Gleichheitszeichen  voneinander  getrennt.  Die 
einzige  erlaubte  Ausnahme  gibt  es  beim  ARGV-Verfahren  zur  Ubergabe  erweiterter  Kom- 
mandozeilen. 
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Das  ARGV-Verfahren 

DasARGV-VerfahrenzurUbergabeerweiterterKommandozeilenistnachlanger(kontroverser) 
Diskussion  im  Herbst  1989  von  Ken  Badertscher  (Atari  Sunnyvale)  offiziell  spezifiziert 
worden  (Ken  Badertscher,  “GEMDOS  Extended  Argument  (ARGV)  Specification”,  in: 
INFO- ATARI  16  in  Digest  595/89,  (2.  November  1989)).  Es  bietet  folgende  Vorteile  gegen- 
liber  den  herkommlichen  Kommandozeilen: 

-  Die  Anzahl  und  GroBe  der  Parameter  ist  praktisch  nur  durch  den  freien  Speicher 
begrenzt. 

-  Einzelne  Parameter  diirfen  auch  Leerzeichen  enthalten  (in  der  normalen  Kommandozeile 
sind  die  einzelnen  Parameter  untereinander  durch  Leerzeichen  getrennt). 

-  Als  “nullter”  Parameter  kann  der  Name  (mit  Pfad)  des  gestarteten  Programms  iibergeben 
werden.  Das  erlaubt  es,  in  C-Programmen  “argv[0]”  zu  setzen  und  denNamen,  unter  dem 
das  Programm  gestartet  worden  ist,  festzustellen. 

Und  so  funktioniert  das  Ganze:  Die  Ubergabe  der  erweiterten  Kommandozeile  erfolgt  iiber 
das  Environment.  Die  Environmentvariable  ARGV  (grab  geschrieben!)  zeigt  an,  dafi  dieses 
Verfahren  benutzt  wird.  ARGV  kann  einen  beliebigen  Wert  haben,  allein  seine  Anwesenheit 
ist  entscheidend.  ARGV  muB  die  letzte  Environmentvariable  sein,  damit  das  aufgerufene 
Programm  den  “vorderen”  Teil  als  sein  normales  Environment  weiterbenutzen  kann. 

Die  erweitertete  Kommandozeile  wird  als  Folge  von  Null-terminierten  Strings  hinter  ARGV 
ins  Environment  geschrieben.  Der  erste  String  (entspricht  dem  bislang  nicht  benutzten 
argvfO])  enthalt  den  Namen  des  gestarteten  Programms,  wie  man  ihn  auch  an  “Pexec()” 
iibergibt. 

Die  weiteren  Strings  enthalten  die  einzelnen  Parameter,  in  denen  auch  Leerzeichen  auftau- 
chen  diirfen.  Das  Ende  der  Liste  wird  durch  eine  doppelte  0  gekennzeichnet  (wie  bei  einem 
“normalen”  Environment).  Leider  heiBt  das  auch:  leere  Parameter  konnen  nicht  iibergeben 
werden  (es  gibt  tatsachlich  Falle,  in  denen  man  so  etwas  braucht!). 

Zusatzlich  iibergibt  man  bei  Pexec()  als  Langenbyte  (erstes  Byte  in  der  Kommandozeile)  den 
Wert  127,  der  wegen  der  existierenden  Langenbeschrankung  auf  125  Bytes  bislang  nicht 
angenommen  werden  konnte. 

Der  Langenwert  von  127  ermoglicht  es  dem  aufgerufenen  Programm,  sicherzustellen,  dafi  die 
im  Environment  iibergebenen  Werte  tatsachlich  giiltig  sind  und  nicht  etwa  von  einem  Pro¬ 
gramm,  das  den  ARGV-Standard  nicht  kannte,  iibriggelassen  wurden. 
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ARGV  beim  Aufrufer 

Um  via  ARGV -Parameter  iibergeben  zu  konnen,  muB  zunachst  ein  neues  Environment  fiir  das 
aufzurufende  Programm  angelegt  werden.  Dazu  berechnet  man  beispielsweise  die  Lange  des 
bereits  vorhandenen  Environments,  addiert  die  Lange  der  Kommandozeile  und  alloziert  ent- 
sprechend  viele  Bytes.  Dann  wird  das  bestehende  Environment  kopiert  (dabei  gegebenenfalls 
eine  bereits  bestehende  ARGV-Variable  entfemt),  die  neue  Variable  ARGV  und  die  Kom- 
mandozeilenparameter  nacheinander  angehangt  (immer  Null-terminiert).  Eine  letzte  0 
schlieBt  dann  das  Environment  legal  ab.  Beim  Aufruf  mittels  “Pexee()”  iibergibt  man  im  Lan- 
genbyte  der  Kommandozeile  den  Wert  127. 

ARGV  beim  gestarteten  Programm 

Zunachst  muB  man  iiberpriifen,  ob  im  Environment  die  Variable  “ARGV”  auftritt.  1st  dies  der 
Fall,  und  ist  das  Kommandozeilen-Langenbyte  127,  dann  findet  man  nach  der  ersten  0  nach 
“ARGV”  (denn  “  ARGV”kann  ja  einen  Werthaben)  die  einzelnenKommandozeilenparameter. 
Nachdem  der  Startupcode  die  Argument-Zeiger  (in  C:  argv[i])  gesetzt  hat,  sollte  noch  der  erste 
Buchstabe  von  “  ARGV”  auf  0  gesetzt  werden  -  nun  hat  das  Environment  wieder  die  Standard- 
form. 


Programmformat  unter  GEMDOS 

Das  GEMDOS -Programmformat  hebt  sich  erheblich  von  dem  einfacherer  Betriebssysteme 
wie  CP/M  oder  Atari-DOS  (8-Bit)  ab,  da  beim  Programm  start  das  Programm  an  eine  beliebige 
freie  Stelle  des  Speichers  geladen  wird  und  dort  ablauffahig  sein  mufi.  Dazu  werden  nicht  die 
MC68K-spezifischen  Adressierungsarten  fiir  indirekte  Adressierung  verwendet,  sondem  das 
geladene  Programm  kurzerhand  fiir  die  entsprechende  Stelle  reloziert.  Daher  enthalt  eine 
GEMDOS-Programmdatei  (wie  sie  mit  “Pexec()”  gestartet  wird)  zusatzlich  noch  Informatio- 
nen  fiir  den  Relozierungsvorgang.  AuGerdem  kann  man  zu  Debugging-Zwecken  auch  die 
Symbole  (Labels)  in  die  endgiiltige  Datei  iibemehmen.  Alle  dazu  notwendigen  Informationen 
stellt  im  Normalfall  der  Linker  bereit,  so  dafi  der  Programmierer  selten  damit  in  Beriihrung 
kommt. 

Eine  GEMDOS-Programmdatei  besteht  also  aus  den  aufeinanderfolgenden  Komponenten: 

-  Dateikopf 

-  Text-,  DATA-  und  BSS-Abschnitt 

-  eventuell  Symboltabelle 

-  eventuell  Relozierungstabelle 
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Der  Datei-Kopf  hat  folgende  Form: 


typedef  struct 
{ 

WORD  ph_branch; 

LONG  ph_tlen; 

LONG  ph_dlen; 

LONG  ph_blen; 

LONG  ph_slen; 

LONG  ph_resl; 

LONG  ph_prgflags; 
WORD  ph_absflag; 

}  PH; 


/*  Branch  an  den  Anfang  des  Programms 
(0x601A)  */ 

/*  Lange  des  TEXT-Abschnitts  */ 

/*  Lange  des  DATA-Abschnitts  */ 

/*  Lange  des  BSS-Abschnitts  */ 

/*  Lange  der  Symboltabelle  */ 

/*  reserviert;  mull  0  sein  */ 

/*  spezielle  Flags  */ 

/*  0:  Relozierungsinformationen  vorhanden  */ 


Im  Feld  “ph_prgflags”  kann  man  weitere  spezielle  Flags  angeben: 

Fastload-FIag 

Normalerweise  loscht  GEMDOS  bei  “Pexec()”  die  gesamte  angelegte  TPA.  Das  kann  bei 
entsprechend  viel  RAM  ziemlich  viel  Zeit  in  Anspruch  nehmen  (vor  TOS  1 .02  war  zu  allem 
UberfluB  die  Loschroutine  besonders  langsam).  Wenn  man  Bit  0  in  “ph_prgflags”  setzt,  wird 
lediglich  dieBSS  vorinitialisiert.  Programme,  die  da  von  ausgehen,  daG  allozierte  Speicherblocke 
auch  tatsachlich  leer  sind,  fallen  dann  allerdings  auf  die  Nase  (ein  Zeichen  fiir  unsaubere  Pro- 
grammierung!).  Doeh  Vorsicht:  Anscheinend  begehen  auch  Teile  des  Betriebssystems  diesen 
Fehler,  daher  sollte  man  bei  mindestens  einem  Auto-Ordner-Programm  und  einem  Accessory 
das  Fastload-Bit  nicht  setzen! 


TT-Speicher 

Beim  TT  kann  man  nicht  mit  alien  Speicherbereichen  das  tun,  was  man  vom  ST  gewohnt  ist. 
Beispiels  weise  kann  die  Video-Hardware  und  die  ACSI-DMA  nur  auf  das  ST-RAM  zugreifen 
(mehr  dazu  bei  der  Hardware).  Daher  gibt  es  einen  Mechanismus,  mit  dem  man  GEMDOS 
fiir  ein  bestimmtes  Programm  vorgeben  kann,  wohin  es  geladen  werden  soli  und  von  wo  aus 
Malloc()-Anforderungen  bedient  werden  sollen.  Wenn  man  Bit  1  in  “ph_prgflags”  setzt,  heifit 
das  fiir  GEMDOS :  Dieses  Programm  darf  in  das  schnelle  Alternate  RAM  geladen  werden.  Ein 
gesetztes  Bit  2  signalisiert:  Auch  Malloc()-Anforderungen  dieses  Programms  diirfen  aus  dem 
Alternate  RAM  bedient  werden. 


Eine  besondere  Situation  ergibt  sich,  wenn  im  Programmkopf  angegeben  ist,  daB  das 
Programm  in  das  Alternate  RAM  geladen  werden  darf,  jedoch  im  ST -RAM  mehr  Speicher  als 
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im  Alternate  RAM  frei  ist.  Fiir  diesen  Fall  kann  man  festlegen,  wieviel  Alternate  RAM 
“genug”  fiir  das  Programm  ist.  Das  TPA-GroBen-Feld  liegt  in  den  obersten  vier  Bits  von 
“ph_prgflags”.  Seine  16  moglichen  Werte  legen  in  Schritten  zu  128  KByte  den  benotigten 
Speicher  fest  (0  steht  dabei  fur  128  KByte,  15  fiir  2  MByte).  Zum  so  ermittelten  Wert  wird 
auBerdem  noch  die  Summe  der  drei  Programmsegmente  (Code,  Daten  und  BSS)  addiert. 

Ein  sauber  geschriebenes  Programm  reserviert  sich  nach  dem  Programmstart  in  der  TPA 
lediglich  Platz  fiir  den  Stack  (Beispiel:  der  Startup-Code  von  Turbo-C).  Bei  solchen 
Programmen  ist  das  TPA-GroBen-Feld  nur  dann  von  Interesse,  wenn  ein  ganz  besonders 
groBer  Stack  benotigt  wird.  Anders  bei  Programmen,  die  den  groBten  Teil  der  TPA  fiir  sich 
behalten  und  nicht  wieder  mittels  “MshrinkO”  an  GEMDOS  zuriickgeben. 


Symboltabelle 

Eine  Symboltabelle  im  Digital-Research-Format  besteht  aus  jeweils  14  Bytes  langen  Eintra- 
gen,  die  aus  dem  Symbolnamen  (bis  zu  maximal  acht  Bytes;  nur  bei  kiirzeren  Namen  mit  0 
abgeschlossen!!),  dem  Symboltyp  (zwei  Bytes)  und  dem  eigentlichen  Symbolwert  (vier 
Bytes)  besteht.  Folgende  Symboltypen  werden  untersttitzt: 


Wert 

Symboltyp 

$0100 

in  der  BSS 

$0200 

im  Programmtext 

$0280 

TEXT  FILE  -  Start  eines  Objektmoduls  (nur  mit  “ALN”) 

$O2C0 

TEXT  FILE  ARCHIVE  -  Start  einer  Library  (nur  mit  “ALN”) 

$0400 

im  DATA-Bereich 

$0800 

External 

$1000 

Register 

$2000 

Globales  Symbol 

$4000 

Equated 

$8000 

Defined 

Viele  Programmiersprachen  benutzen  allerdings  ein  eigenes  Symbolformat  (Mark-Williams- 
C,  Turbo-C  2.0). 

Die  Relozierungsinformationen 

Nach  dem  Ladevorgang  wird  das  Programm  automatisch  reloziert.  Dabei  ist  nur  die 
Relozierung  von  32-Bit-Werten  (also  Adressen)  moglich.  Vor  GEMDOS  0.15  durften  die 
Relozierungsinformationen  maximal  32  Kbyte  einnehmen. 
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GEMDOS  kennt  Programmdateien  mit  und  ohne  Relozierungsinformationen.  Zur  Unter- 
scheidung  dient  das  Feld  “ph_absflag”  im  Programmkopf .  Nur  wenn  es  0  ist,  wird  die  folgende 
Relozierungstabelle  ausgewertet. 

Alte  GEMDOS-Versionen  (vor  0. 1 5)  gehen  mit  solchen  Dateien  allerdings  nicht  ganz  korrekt 
um,  daher  empfiehlt  Atari,  statt  dessen  Dateien  mit  leerer  Relozierungstabelle  (siehe  unten) 
zu  verwenden. 

Die  Relozierungstabelle  beginnt  mit  einem  32-Bit-Wert,  der  den  Offset  des  ersten  zu  relozie- 
renden  Wertes  relativ  zum  Beginn  des  Textsegments  kennzeichnet. 

Fiir  alle  folgenden  Offsets  (zwischen  den  zu  relozierenden  Werten)  werden  einzelne  Bytes 
benutzt.  Auch  ftir  Abstande  iiber  dem  Betrag  eines  Bytes  (255)  ist  gesorgt:  wird  ais  Offset  eine 
1  gefunden,  was  naturlich  aufgmnd  derEigenheiten  des  MC68Kausgeschlossen  ist,  wird  auto- 
matisch  zum  Offset  254  addiert. 

Fiir  besonders  groBe  Abstande  zwischen  zu  relozierenden  Werten  kann  dieser  Vorgang  auch 
mehrfach  wiederholt  werden.  Ist  die  Relozierungstabelle  leer,  dann  findet  man  als  ersten 
Long-Wert  eine  0. 


Weitere  Standardformate 

Sehr  ahnlich  wie  eine  Programmdatei  sieht  eine  Objektdatei  im  Digital-Research-Format  aus: 

typedef  struct 
{ 

WORD  magic; 

LONG  tsize; 

LONG  dsize; 

LONG  bsize; 

LONG  ssize; 

CHAR  reserved [ 10 ] ; 

}  OSHEADER; 

SchlieBlich  noch  das  Format  fiir  das  DR-Format  fiir  Archivdateien  (oder  auch  Bibliotheken): 
eine  Archivdatei  enthalt  normalerweise  weitere  Objektdateien  (kann  aber  auch  beliebige 
andere  Dateien  enthalten).  Der  Dateikopf  besteht  lediglich  aus  dem  Word  $FF65. 

Es  folgen  beliebig  viele  Dateien,  jeweils  eingeleitet  mit  einer  ARHEADER-Struktur.  Das 
Ende  der  Archivdatei  wird  durch  $0000  gekennzeichnet. 


/*  $601A  */ 

/*  GroBe  des  Textsegments  */ 
/*  GroBe  des  DATA-Segments  */ 
/*  GroBe  der  BSS  */ 

/*  GroBe  der  Symboltabelle  */ 
/*  alle  auf  0  setzen  */ 
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typedef  struct 
{ 


CHAR 

a  fname[14] ; 

/* 

LONG 

a  modti; 

/* 

BYTE 

a_userid; 

/* 

BYTE 

a_gid; 

/* 

WORD 

a_f  imode; 

/* 

LONG 

a  fsize; 

/* 

WORD 

reserved; 

/* 

Dateiname  */ 

Zeitpunkt  des  letzten  Zugriffs  */ 
nicht  benutzt  */ 
nicht  benutzt  */ 

Filemodus  */ 

Dateilange  */ 

0  */ 


}  ARHEADER; 


GEMDOS-Vektoren 

DieProzessoren  der68000er-Reihekennen  256  Vektoren,  die  fiir  Dinge  wieTraps,  Exceptions 
oder  Interrupts  von  I/O-Bausteinen  verwendet  werden, 

Ihre  Adressen  liegen  in  den  ersten  1024  Bytes  des  AdreBraums  (genaugenommen  sind  es  nur 
die  Vektoren  2  bis  255,  und  die  Vektoren  beginnen  erst  bei  Adresse  8...). 

Zusatzlich  sind  fiir  GEMDOS  acht  logische  Vektoren  (256  bis  263)  definiert.  Ihre  Adressen 
liegen  bei  Adresse  $400  (1024),  sollten  aber  immer  nur  mit  “SetexcQ”  verdndert  werden  -  ihre 
tatsachliche  Adresse  muB  nicht  bei  $400  liegen!  Am  Ende  jeder  Routine  sollte  zu  der  Adresse 
gesprungen  werden,  die  “SetexcO”  als  bisherigen  Inhalt  des  entsprechenden  Vektors  zuriick- 
geliefert  hat. 

Derzeit  sind  nur  die  ersten  drei  Vektoren  benutzt  -  alle  anderen  sind  fiir  kiinftige  Benutzung 
durch  GEMDOS  reserviert. 

Vektor  256:  Systemtimer  (etv  timer) 

Dieser  Vektor  wird  periodisch  aufgerufen.  Bei  alien  bisher  bekannten  Maschinen  tritt  der 
Aufruf  50mal  pro  Sekunde  auf  (intern  wird  dazu  der  200-Hz-Timer  benutzt) .  Darauf  sollte  man 
sich  allerdings  nicht  verlassen,  erhalt  man  doch  als  einzigen  Parameter  auf  dem  Stack  (4(sp)) 
die  Anzahl  der  vergangenen  Millisekunden. 

Hier  install  ierte  Routinen  sollten  moglichst  kurz  gehalten  werden  -  immerhin  beeinflussen  sie 
die  Gesamtleistung  des  Rechners.  Um  das  Retten  der  Register  kummert  sich  das  System  selbst, 
daher  darf  man  alle  Prozessorregister  benutzen. 

GEMDOS  benutzt  den  Systemtimer,  um  eine  eigene  Uhr  zu  fiihren. 
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Vektor  257:  Critical  Error  Handler  (etv_critic) 

Dieser  Vektor  gehort  eigentlich  eher  zum  BIOS  -  aber  da  ihn  Atari  auch  unter  den  GEMDOS- 
Vektoren  fuhrt  (GEMDOS  Reference  Manual),  haben  wir  ihn  auch  hier  dokumentiert. 

Das  BIOS  benutzt  diesen  Vektor,  urn  auf  kritische  Fehler  zu  reagieren.  Kritisch  sind  Fehler, 
die  auf  Probleme  mit  der  Hardware  (zum  Beispiel  nicht  lesbare  Sektoren)  zurtickzufiihren 
sind. 

Wer  nur  ein  Diskettenlaufwerk  hat,  weiB,  daB  das  BIOS  Zugriffe  auf  Laufwerk  “B:”  selbst 
abfangt  und  den  Benutzer  zum  Einlegen  der  entsprechenden  Diskette  auffordert.  Auch  dieser 
Mechanismus  wird  mit  Hilfe  des  Critical  Error  Handlers  realisiert:  man  hat  einfach  den  Zu- 
stand  “andere  Diskette  muB  eingelegf  werden”  als  BIOS-Fehler  definiert. 

Als  ersten  Parameter  auf  dem  Stack  (also  bei  4(sp))  erlialt  man  die  Fehlernummer  (als  1 6-Bit- 
Wort).  Bei  der  Ruckkehr  aus  dem  Handler  darf  Register  DO  folgende  Werte  enthalten: 


Wert  in  dO 

Bedeutung 

$00010000 

Zugriff  wiederholen  (“Retry”) 

$00000000 

Fehler  ignorieren 

$FFFFFFXX 

Mit  BIOS-Fehler  abbrechen  (der  Fehler  wird  dann  im  Normalfall  an 
GEMDOS  weitergereicht) 

Der  Handler  darf  die  Register  D3  bis  D7  und  A3  bis  A6  verandem.  Aufrufe  von  GEMDOS- 
oder  AES-Funktionen  sind  nicht  erlaubt.  Begriindung:  GEMDOS  ist  nicht  re-entrant,  und  der 
Fehler  konnte  von  einem  GEMDOS-Aufruf  ausgelost  worden  sein. 

Aufrufe  von  AES-Funktionen  konnten  zu  einer  AES-ProzeB-Umschaltung  fiihren  -  und  wer 
weiB  schon,  ob  der  andere  AES-ProzeB  nicht  vielleicht  als  nachstes  einen  GEMDOS-Aufruf 
vomimmt? 

Der  Critical-Error-Handler  in  alteren  GEM-Versionen  (vor  3.0)  hat  leider  einen  Fehler,  der 
in  ungiinstigen  Fallen  zum  Systemabsturz  fiihren  kann:  wahrend  die  Alert-Box  zu  sehen  ist, 
ist  das  AES-Prozefi-Switching  nicht  unterbunden.  Daher  konnte  wd.hr enddessen  ein  Pro- 
gramm  per  Timer-Event  zum  Zuge  kommen  und  selbst  wieder  einen  GEMDOS-Aufruf  ta- 
tigen. 

Ist  die  auf  dem  Stack  iibergebene  Fehlernummer  “-1”  (also  die  Fehlernummer  fur  “allgemeine 
Fehler”),  und  ist  der  installierte  Handler  der  des  AES,  dann  werden  noch  einige  zusatzliche 
Werte  auf  dem  Stack  benutzt  (dies  ist  nicht  offiziell  dokumentiert!): 
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Stack-Offset  Bedeutung 

8(sp)  Laufwerksnumxner  (0  ist  A:  etc) 

6(sp)  BIOS-Fehlemummer 

Und  hier  ein  Beispiel  fiir  einen  Critical  Error  Handler,  wie  man  ihn  in  rein  textorientierten  Pro 
grammen  (ohne  GEM  und  Maus)  benutzen  kann,  und  der  dem  von  MS-DOS  ahnelt: 

;  toscrit.s 

;  Critical-Error  Handler  fur  Programme  ohne  Maus! 

;  30.09.89 

.globl  toscritic 
.text 

toscritic: 


lea 

Message, aO 

f 

Fehlermeldung  ausgeben 

bsr 

Print It 

move  - 1 

#$20002, -(sp) 

trap 

#13 

r 

Bconin  von  CON: 

addq.l 

#4,  sp 

and.w 

#$5f ,d0 

cmp.b 

#"A",d0 

beq 

I  st  A 

cmp.b 

#"R",d0 

beq 

IstR 

cmp.b 

#"I",dO 

bne 

toscritic 

r 

keine  der  drei  Tasten  ->  von  vorne 

clr .  1 

dO 

f 

Fehler  ignorieren 

rts 

move.w 

4 (sp) ,d0 

r 

Fehlernummer  an  GEMDOS  melden 

ext.l 

dO 

rts 

moveq 

#l,d0 

r 

Retry  zuriickmelden 

swap 

dO 

rts 
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Printlt:  ;  zeichenweise  per  BIOS  ausgeben 

clr.l  dO 
move.b  (a0)+,d0 
tst.b  dO 
beq  endprint 

move.l  a0,-(sp) 
move.w  d0,-(sp) 
move.w  #$2,-(sp) 
move.w  #$3,-(sp) 
trap  #13 
addq.l  #6,sp 
move.l  (sp)+,a0 
bra  Printlt 
endprint : 

rts 

.data 

Message : 

.dc.b  13,10  ;  Zeilenvorschub 

.dc.b  "BIOS-Brror:  (A)bort,  (R)etry,  or  (l)gnore?",0 

Vektor  258:  Terminate  Handler  (etv_term) 

Dieser  Vektor  wird  vor  ProzeBbeendigungeinmal  durchsprungen  (Merke:  Programme,  die  per 
GEMDOS  auf  der  Konsole  ausgeben,  konnen  mit  CTRL-C  abgebrochen  werden).  Dies  ist  mit- 
hin  die  geeignete  Stelle,  urn  gegebenenfalls  installierte  Funktionen  wieder  zu  deinstallieren. 
Nicht  moglich  ist  es  hingegen,  irgendwelche  GEMDOS-Aufrufe  zu  machen  (GEMDOS  ist 
nicht  re-entrant,  und  an  dieser  Stelle  steckt  man  mitten  in  einem  GEMDOS-Aufruf)  oder  gar 
die  Beendigung  des  Programms  sauber  zu  verhindem. 


GEMDOS-Erweiterungen 

GEMDOS  hat  eine  in  vielerlei  Hinsicht  altmodische  Architektur,  die  Erweiterungen  recht 
schwer  macht.  Atari  hat  sich  dieses  Problems  mit  zweierlei  Konzepten  angenommen: 

Netzwerk-Standard  und  File-Locking 

Aus  den  oben  genannten  Griinden  ist  es  ein  schwieriges  Unterfangen,  Netzwerksoftware  auf 
GEMDOS-Basis  zu  entwickeln.  Lange  Zeit  kam  erschwerend  hinzu,  daB  es  keinerlei  Standard 
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in  Hinsicht  auf  die  zu  implementierenden  Funktionsaufrufe  gab.  Damit  ist  seit  Friihjahr  1991 
SchluB:  Atari  hat  die  entsprechenden  unter  MS-DOS  iiblichen  Definitionen  iibemommen 
(siehe  in  der  Befehlsreferenz).  Sie  sind  genau  dann  verfiigbar,  wenn  der  “_FLK”-Cookie 
gesetzt  ist.  Ein  “_NET”-Cookie  informiert  tiber  die  An wesenheit  eines  Netzwerks  (nicht  jedes 
Netzwerkbeherrscht  File-Locking,  und  File-Locking  kann  auch  ohneNetzwerk  wichtig  sein). 

Meta-DOS 

Meta-DOS  ist  eine  GEMDOS-Erweiterung,  die  die  Installation  vielfaltiger  Geratetreiber 
erlaubt.  Dabei  wird  zwischen  physikalischen  Treibem  (die  man  iiber  erweiterte  XBIOS- 
Aufrufe  steuem  kann)  und  logischen  Treibem  (die  das  Dateisystem  ubemehmen)  unterschie- 
den. 

In  Hinsicht  auf  GEMDOS-Aufrufe  verhalt  sich  Meta-DOS  fast  transparent.  Bekannte  Ein- 
schrankungen  bzw.  Unterschiede  (Stand:  Meta-DOS  1.7)  sind: 

-  die  Laufwerksnummer  darf  bis  “Z:”  gehen 

-  die  Umlenkung  der  Standardkanale  auf  von  Meta-DOS  verwaltete  Dateien  ist  nicht 
moglich 

-  Datei-Locking  wird  nicht  unterstiitzt 

Meta-DOS  kann  von  Entwicklern  direkt  von  Atari  bezogen  werden  und  soli  kxinftig  alien  Arten 
von  GEMDOS -Treibem  (CD-ROM,  fremde  Dateisysteme,  Netzwerke)  als  Basis  dienen. 

Bei  Interesse  sollten  man  sich  beim  Softwaresupport  der  jeweiligen  Atari-Niederlassung 
melden.  Die  Linzenzbedingungen  entsprechen  denen  von  GDOS  (einmalige  Zahlung  einer 
eher  symbolischen  Summe). 


GEMDOS  mit  Multitasking 

Aufgrund  der  an  sich  giinstigen  Ausgangsbasis  haben  sich  auch  unabhangige  Entwickler  der 
Weiterentwicklung  vom  GEMDOS  angenommen.  Schon  seit  langer  Zeit  gibt  es  “Micro- 
RTX”  von  Beckemeyer  Development  Tools,  das  GEMDOS  in  ein  Echzeit-Multitasking- 
System  (also  mit  moglichst  kurzen  und  garantierten  ProzeBwechselzeiten)  zu  verwandeln 
sucht. 

Ein  anderer  Versuch  ist  “MiNT”  (“MiNT  is  Not  TOS”)  von  Eric  Smith,  das  als  “offenes” 
Projekt  (jeder  kann  die  C-Quelltexte  bekommen)  entsteht.  “MiNT”  versucht,  moglichst  viele 
Eigenschaften  von  UNIX  nachzubilden  (Signale,  Pipes  etc). 
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GEMDOS-Bindings 

Ebenso  wie  BIOS  und  XBIOS  empfangt  auch  GEMDOS  seine  Parameter  auf  dem  Stack. 
Dabei  wird  das  letzte  Argument  aus  der  Parameterliste  als  erstes  auf  den  Stack  gelegt. 

SchlieBlich  wird  durch  die  Anweisung  “TRAP  #1”  der  GEMDOS-Trap-Dispatcher  aktiviert. 

Funktionsergebnisse  werden  im  Prozessorregister  DO  zurilckgeliefert.  GEMDOS  zerstort  die 
Register  D0-D2  und  A0-A2.  N ur  bei  den  Registem  D3-D7  und  A3- A7  darf  man  sich  darauf 
verlassen,  daB  sie  nicht  verandert  werden. 

Vorsicht  bei  Aufrufen  mit  fehlerhaften  Parametem!  GEMDOS  1st  mit  Sicherheit  der  instabil- 
ste  Teil  von  TOS  und  ist  auBerst  leicht  mit  fehlerhaften  Eingabedaten  zu  verwirren  (“Garbage 
in  ->  Crash!”). 


Fehlermeldungen 

GEMDOS-Fehlermeldungen  sind  negative  LONG-Werte  zwischen  -32  und  -127.  Bei  den 
einzelnen  Funktionen  sind  mogliche  Fehlercodes  angegeben. 

Man  sollte  sich  allerdings  nicht  darauf verlassen,  daB  auch  wirklich  nurdiese  Fehlermeldungen 
auftreten  konnen!  Neben  den  folgenden  Fehlermeldungen  konnen  auch  alle  BIOS-Return- 
Codes  zuriickgeliefert  werden! 


0:  E  OK  (“OK  (no  error)”) 

Funktion  erfolgreich  ausgefiihrt  (kein  Fehler  aufgetreten). 

-32:  EINVFN  (“Invalid  function  number”) 

Unbekannte  Funktionsnummer.  Man  erhalt  diese  Meldung,  wenn  man  eine  undefinierte 
GEMDOS-Funktion  aufruft(unter  MS-DOS:  Fehlercode  1). 

-33:  EFILNF  (“File  not  found”) 

Datei  nicht  gefunden  (unter  MS-DOS:  Fehlercode  2). 

-34:  EPTHNF  (“Path  not  found”) 

Angesprochener  Ordner  nicht  gefunden  (unter  MS-DOS:  Fehlercode  3). 
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-35:  ENHNDL  (“Handle  pool  exhausted”) 

Keine  Dateihandles  mehr  (zu  viele  Dateien  geoffnet,  unter  MS-DOS:  Fehlercode  4). 

-36:  EACCDN  (“Access  denied”) 

Zugriff  nicht  erlaubt  (unter  MS-DOS:  Fehlercode  5). 

-37:  EIHNDL  (“Invalid  handle”) 

Das  Dateihandle  war  nicht  korrekt  (unter  MS-DOS:  Fehlercode  6). 

-39:  ENSMEM  (“Insufficient  memory”) 

Nicht  geniigend  Speicher  vorhanden  (unter  MS-DOS:  Fehlercode  8). 

-40:  EIMBA  (“Invalid  memory  block  address”) 

Die  Adresse  des  Speicherblocks  war  nicht  giiltig  (unter  MS-DOS:  Fehlercode  9). 

-46:  EDRIVE  (“Invalid  drive  specification”) 

Die  Laufwerksbezeichnung  war  ungiiltig  (unter  MS-DOS:  Fehlercode  15). 

-^48:  ENSAME  (“Not  the  same  drive”) 

Dateien  sind  auf  verschiedenen  logischen  Laufwerken. 

-49:  ENMFIL  (“No  more  files”) 

Es  konnen  keine  Dateien  mehr  geoffnet  werden  (unter  MS-DOS:  Fehlercode  18). 

-58:  ELOCKED  (“Record  is  locked”) 

Es  wurde  versucht,  auf  einen  gelockten  Bereich  einer  Datei  zuzugreifen  (nur  im  Zusammen- 
hang  mit  einer  Netzwerk-GEMDOS-Version). 


-59:  ENSLOCK  (“No  such  lock”) 

Es  wurde  versucht,  einen  nicht  existierenden  Lock  (falscher  Offset  oder/und  falsche  Lange) 
zu  entfemen  (nur  im  Zusammenhang  mit  einer  Netzwerk-GEMDOS-Version). 
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—64:  ERANGE  (“Range  error”) 

Dateizeiger  in  ungultigem  Bereich. 

-65:  EINTRN  (“GEMDOS  internal  error”) 

Interner  Fehler  im  GEMDOS  (hoffentlich  passiert’s  nie!). 

-66:  EPLFMT  (“Invalid  executable  file  format”) 

Das  angesprochene  Programm  hat  nicht  das  korrekte  Format,  ura  geladen  zu  werden. 

-67:  EGSBF  (“Memory  block  growth  failure”) 

Es  wurde  versucht,  einen  allozierten  Speicherblock  zu  vergroBem. 
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GEMDOS-Referenz 


Cauxin  (GEMDOS  3)  -  Read  character  from  standard  AUX: 


Mit  dieser  Funktion  kann  man  Zeichen  von  Standardkanal  2  (das  ist  normalerweise  die  serielle 
Schnittstelle)  empfangen  (dabei  wird  gegebenenfalls  so  lange  gewartet,  bis  ein  Zeichen  an  der 
Schnittstelle  vollstandig  eingetroffen  ist!). 

Atari  empfiehlt  iibrigens  zu  diesem  Zweck  die  Verwendung  der  entsprechenden  BIOS- 
Funktion. 


Declaration  in  C: 

WORD  Cauxin  (void) ; 

Aufruf  in  Assembler: 

move.w  #3,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Cauxin():  Empfangenes  Zeichen 

Bemerkungen 

Bei  Ein-/Ausgabeumlenkung  wird  zur  Zeit  beim  Dateiende  ein  undefiniertes  Zeichen 
zuriickgegeben. 
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!  Cauxis  (GEMDOS  18)  -  Check  status  of  standard  AUX:  input 

Mit  dieser  Funktion  konnen  Sie  feststellen,  ob  von  der  seriellen  Schnittstelle  (d.h.  vom 
Standardkanal  2)  ein  Zeichen  empfangen  werden  kann. 

Atari  empfiehlt  die  Verwendung  der  entsprechenden  BIOS -Funktion, 

Deklaration  in  C: 

WORD  Cauxis  (void) ; 


Aufruf  in  Assembler: 

move.w  #$12, -(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Cauxis():  -1:  Zeichen  ist  verfiigbar 

0:  Es  liegt  kein  Zeichen  vor 

Bemerkungen 

Arbeitet  bei  Ein-/Ausgabeumlenkung  erst  ab  GEMDOS- Version  0.15  korrekt. 
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Cauxos  (GEMDOS  19)  -  Check  status  of  standard  AUX:  output 

Priift,  ob  iiber  die  serielle  Schnittstelle  (Standardkanal  2)  ein  Zeichen  ausgegeben  werden  kann 
oder  nicht. 

Atari  empfiehlt  die  Verwendung  der  entsprechenden  BIOS-Funktion. 

Deklaration  in  C: 

WORD  Cauxos  (void) ; 

Aufruf  in  Assembler: 

move.w  #$13, - (sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

CauxosO:  -1:  Zeichen  kann  ausgegeben  werden 

0:  Zeichen  kann  nicht  ausgegeben  werden 
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Cauxout  (GEMDOS  4)  -  Write  character  to  standard  AUX: 


Zeichen  wird  auf  Standardkanal  2  (dem  seriellen  Port)  ausgegeben. 
Atari  empfiehlt  die  Verwendung  der  entsprechenden  BIOS-Funktion. 

Deklaration  in  C: 

void  Cauxout  (WORD  c) ; 

Aufruf  in  Assembler: 

move.w  c, -(sp)  ;  Offset  2 

move.w  #4,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #4,sp 


Parameter: 

c:  Auszugebendes  Zeichen  (ASCII-Code  in  Bits  0..7,  alle  anderen  Bits  auf  0  setzen). 
Bemerkungen 

Arbeitet  bei  Ein-/Ausgabeumlenkung  erst  ab  GEMDOS-Version  0.15  korrekt. 
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Cconin  (GEMDOS  1)  -  Read  character  from  standard  input 


Ein  Zeichen  wird  von  stdin  (also  Standardkanal  0)  gelesen  (sobald  eines  vorliegt).  1st  stdin  die 
Tastatur,  dann  wird  in  den  Bits  0..7  der  ASCII-Code  der  gedriickten  Taste  und  in  den  Bits 

16.. 23  der  Scan-Code  zuriickgeliefert. 

Durch  Setzen  von  Bit  3  der  Systemvariablen  “conterm”  kann  man  veranlassen,  daB  in  den  Bits 

24.. 31  der  Wert  von  “KbshiftO”  zuriickgegeben  wird. 

Deklaration  in  C; 

LONG  Cconin  (void) ; 

Aufruf  in  Assembler: 

raove.w  #l,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Cconin():  eingelesenes  Zeichen 

Bemerkungen 

Man  hat  weder  die  Moglichkeit  festzustellen,  ob  I/O-Redirection  stattfindet,  noch  die,  das 
Dateiende  zu  erkennen.  Daher  definieren  viele  C-Bibliotheken  analog  zu  MS-DOS  den 
ASCII-Code  26  (also  <Ctrl><Z>)  als  Zeichen  fur  das  Dateiende. 
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Cconis  (GEMDOS  11)  -  Check  status  of  standard  input 


Diese  Funktion  iiberpriift,  ob  von  stdin  (Standardkarial  0,  normalerweise  die  Tastatur)  ein 
Zeichen  eingelesen  werden  kann. 

Deklaration  in  C: 

WORD  Cconis  (void) ; 

Aufruf  in  Assembler: 

move.w  #$B, -(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Cconis():  0:  Zeichen  nicht  verfiigbar 

-1:  Zeichen  verfiigbar 


Cconos  (GEMDOS  16)  -  Check  status  of  standard  output 

Liefert  den  Ausgabestatus  von  stdout  (Standardkanal  1,  normalerweise  der  Bildschirm). 

Deklaration  in  C: 

WORD  Cconos  (void) ; 

Aufruf  in  Assembler: 

move.w  #$10, -(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Cconos():  1  (o.k.)  oder  0  (Es  kann  kein  Zeichen  ausgegeben  werden) 

Bemerkungen 

Arbeitet  bei  Ein-/Ausgabeumlenkung  erst  ab  GEMDOS-Version  0.15  korrekt. 
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Cconout  (GEMDOS  2)  -  Write  character  to  standard  output 


Ein  Zeichen  wird  auf  stdout  (Handle  1,  normalerweise  der  Bildschirm)  ausgegeben. 


Deklaration  in  C: 

void  Cconout  (WORD  c) ; 


Aufruf  in  Assembler: 

move.w  c,  -  (sp) 

move.w  #2,-(sp) 

trap  #1 

addq.l  #4,sp 


;  Offset  2 
;  Offset  0 


Parameter: 

c:  Auszugebendes  Zeichen  als  16-Bit-Wort  (ASCH-Code  in  Bits  0..7,  alle  anderen  Bits 
miissen  0  sein) 

Bemerkungen 

Arbeitet  bei  Ein-/Ausgabeumlenkung  erst  ab  GEMDOS-Version  0.15  korrekt. 
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Cconrs  (GEMDOS  10)  -  Read  edited  data  from  standard  input 


Mit  dieser  Funktion  kann  eine  ganze  Zeichenkette  vom  Standardeingabekanal,  im  Normalfall 
also  der  Tastatur,  gelesen  werden. 

Dazu  schreibt  man  in  das  erste  Element  der  LINE-Struktur  die  Anzahl  der  einzulesenden 
Zeichen  (vermindert  um  1  ).“Cconrs()”  bricht  die  Eingabe  in  dem  Moment  ab,  in  dem  der  An- 
wender  “Return”  drtickt  oder  die  Maximallange  uberschritten  wird. 

Ein  eventuelles  Dateiende  wird  nicht  erkannt!  Umlaute  (genauer:  Zeichen  mit  ASCII-Code 
grofier  als  127)  werden  erst  ab  GEMDOS-Version  0.15  korrekt  behandelt. 


Eingabefunktionen: 

<Retum>,  CTRL-J 
<Backspace>,  CTRL-H 
CTRL-U,  CTRL-X 
CTRL-R 
CTRL-C 


Ende  der  Eingabe 
Letztes  Zeichen  loschen 
Ganze  Zeile  loschen 
Zeile  neu  eingeben 

Programm  abbrechen  (siehe  dazu  auch  “etvjerm”) 


Deklaration  in  C: 


/*  maximale  Lange  der  Eingabe  */ 

/*  tatsachliche  Lange,  Offset  1  */ 
/*  eingelesene  Zeichen,  Offset  2  */ 


void  Cconrs  (LINE  *buf) ; 


typedef  struct 
{ 

BYTE  maxlen; 

BYTE  actuallen; 
CHAR  buffer [255] ; 
}  LINE; 


Aufruf  in  Assembler: 

pea  buf  ;  Offset  2 

move.w  #$A, -(sp)  ;  Offset  0 

trap  #1 

adaq.l  #6,sp 
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Parameter: 

buf->maxlen:  Anzahl  der  einzulesenden  Zeichen  (-1) 

buf->actuallen:  Tatsachlieh  gelesene  Zeichen 

buf->buffer.  Die  eingelesene  Zeichenkette 

Bemerkungen 

Gelesene  Zeichen  werden  selbst  dann  auf  dem  Bildschirm  ausgegeben,  wenn  die 
Standardausgabe  auf  eine  Datei  umgelenkt  worden  war. 
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Cconws  (GEMDOS  9)  -  W 

rite  string  to  standard  output 

Mit  dieser  Funktion  kann  eine  ganze  Zeichenkette  auf  stdout  (also  normalerweise  dem 
Bildschirm)  ausgegeben  werden.  Als  Endmarke  fur  den  String  wird  -  wie  gewohnt  -  die  0 
verwendet. 

Deklaration  in  C: 

void  Cconws  (const  char  *str) ; 


Aufruf  in  Assembler: 

pea  str  ;  Offset  2 

move.w  #9,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #6,sp 


Parameter: 

str:  auszugebende  Zeichenkette  (muft  mit  0  abgeschlossen  sein) 

Bemerkungen 

Einige  Dokumentationen  (auch  zuriickliegende  Auflagen  des  Profibuchs)  geben  als 
Riickgabewerte  die  Anzahl  der  ausgegebenen  Zeichen  an.  Dieses  Verhalten  ist  jedoch  offiziell 
nicht  dokumentiert  und  sollte  daher  nicht  ausgenutzt  werden! 
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Cnecin  (GEMDOS  8)  -  Read  character  from  standard  input,  no  echo 


Entspricht  “CrawcinO”  mit  der  Ausnahme,  daB  Steuerzeichen  (<CtrlxS>  Bildschirmausgabe 
stoppen,  <CtrlxQ>  Bildschirmausgabe  fortsetzen,  <CtrlxCC  Abbruch  usw.)  korrekt  inter- 
pretiert  werden. 


Deklaration  in  C: 

LONG  Cnecin  (void) ; 


Aufruf  in  Assembler: 

move.w  #8,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 


Parameter: 

CnecinQ:  das  eingelesene  Zeichen 
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Cprnos  (GEMDOS  17)  -  Check  status  of  standard  PRN: 


Liefert  den  Ausgabestatus  der  parallelen  Schnittstelle  (Standardkanal  3). 

Es  empfiehlt  sich  dringend,  diese  Funktion  vor  jeder  Druckausgabe  zu  nutzen,  da  bis  zum 
Erkennen  des  Drucker-’Timeouts”  eine  halbe  Ewigkeit  (ungefahr  eine  halbe  Minute)  vergeht 
und  die  Geduld  der  Anwender  meist  sehr  eingeschrankt  ist. 


Deklaration  in  C: 

WORD  Cprnos  (void) ; 


Aufruf  in  Assembler: 

move.w  #$il,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Cpmos():  0:  Drucker  nicht  empfangsbereit 

-1:  Drucker  empfangsbereit 
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Cprnout  (GEMDOS  5)  -  Write  character  to  standard  PRN: 


Ein  Zeichen  wird  auf  Standardkanal  3  (dem  Drucker)  ausgegeben.  Dabei  werden  die  iiber 
“Setprt()”  vorgenommenen  Einstellungen  (die  man  zum  Beispiel  iiber  das  Kontrollfeld 
vomehmen  kann)  aufgrund  eines  Fehlers  in  alien  bekannten  TOS-Versionen  nicht beriicksich- 
tigt. 

Es  empfiehlt  sich,  vorher  mittels  “CpmosO”  festzustellen,  ob  der  Drucker  iiberhaupt  Zeichen 
empfangen  kann. 


Deklaration  in  C: 

WORD  Cprnout  (WORD  c) ; 


Aufruf  in  Assembler: 

move.w  c,-(sp)  ;  Offset  2 

move.w  #5,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #4,sp 


Parameter: 


c:  auszugebendes  Zeichen  in  Bits  0..7,  alle  anderen  Bits  miissen  auf  0  gesetzt  sein 

Cpmout();  Es  wird  der  Rilckgabewert  der  entsprechenden  BIOS-Fuhktion  zuriickgeliefert 
(0:  o.k.,  sonst:  Fehler).  Der  ist  allerdings  nur  dann  definiert,  wenn  tatsachlich 
auf  die  parallele  Schnittstelle  ausgegeben  wurde! 

Bemerkungen 

Arbeitet  bei  Ein-/Ausgabeumlenkung  erst  ab  GEMDOS-Version  0.15  korrekt. 
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Crawcin  (GEMDOS  7)  -  Raw  input  from  standard  input 

Ein  Zeichen  wird  von  stdin  (der  Tastatur)  gelesen,  ohne  dab  es  dabei  sofort  auf  dem  Bildschirm 
ausgegeben  wird.  <CtrIxC>  wird  dabei  ignoriert, 

Deklaration  in  C: 

LONG  Crawcin  (void) ; 

Aufruf  in  Assembler: 

move.w  #7,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Crawcin():  das  eingelesene  Zeichen 


Bemerkungen 

Bei  Ein-/Ausgabeumlenkung  wird  zur  Zeit  beim  Dateiende  ein  undefiniertes  Zeichen 
zuriickgegeben. 
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Cravvio  (GEMDOS  6)  -  Raw  I/O  to  standard  input/output 


Dies  ist  eine  Vielzweckfunktion  zur  Ein-  und  Ausgabe  auf  stdin  (Tastatur)  und  stdout  (Bild- 
schirm).  <CtrlxC>  wird  dabei  ignoriert. 


Deklaration  in  C: 

LONG  Crawio  (WORD  w) ; 


Aufruf  in  Assembler: 

move.w  w,-(sp) 

move.w  #6,-(sp) 

trap  #1 

addq.l  #4,sp 


;  Offset  2 
;  Offset  0 


Parameter: 

w:  $FF:  Zeichen  von  stdin  einlesen  (entspricht  “Cconin()”) 

sonst:  Zeichen  auf  stdout  ausgeben  (entspricht  “CconoutO”) 

Crawio():  (fur  w=$FF)  das  eingelesene  Zeichen  wie  bei  “CconinO”  oder  0  (kein  Zeichen 

verfiigbar). 


Bemerkungen 

Arbeitet  bei  Ein-/Ausgabeumlenkung  erst  ab  GEMDOS-Version  0.15  korrekt. 
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Dcreate  (GEMDOS  57)  -  Create  directory 


Legt  neue  Ordner  (Subdirectories)  an. 


Deklaration  in  C: 

WORD  Dcreate  (const  char  *pathname) ; 

Aufruf  in  Assembler: 

pea  pathname  ;  Offset  2 

move.w  #$39, ~(sp)  ;  Offset  0 

trap  #1 

addq.l  #6,sp 


Parameter: 

pathname:  Zeiger  auf  einen  giiltigen  Ordnemamen 

Dcreate():  einige  niogliche  Retum-Werte: 

OK  (0):  alles  in  Ordnung 

EPTHNF  (-34):  Ordner  nicht  gefunden 

EACCDN  (-36):  Zugriff  verwehrt 

Bemerkungen 

Vor  GEMDOS  0. 15  machte  “DcreateO”  praktisch  keine  Fehlerbehandlung.  Dadurch  konnte 
sogar  im  schlimmsten  Fall  das  Datei  system  in  Mitleidenschaft  gezogen  werden.  Ebensowenig 
wurde  vorher  gepriift,  ob  es  nicht  bereits  eine  Datei  mit  gleichem  Namen  gibt  (die  Datei  wurde 
dann  einfach  geloscht). 
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Ddelete  (GEMDOS  58)  -  Delete  directory 

Loscht  einen  Ordner  (der  dazu  leer  sein  muB). 


Deklaration  in  C: 

WORD  Ddelete  (const  char  *pathname) ; 

Aufruf  in  Assembler: 

pea  pathname  ;  Offset  2 

move.w  #$3A, -(sp)  ;  Offset  0 

trap  #1 

addq.l  #6,sp 


Parameter: 


pathname: 

DdeleteQ: 


Zeiger  auf  den  entsprechenden  Ordnemamen. 
einige  mogliche  Return-Werte: 


OK  (0): 

EPTHNF  (-34): 
EACCDN  (-36): 

EINTRN  (-65): 


alles  in  Ordnung 
Ordner  nicht  gefunden 

Zugriff  verwehrt  (Ordner  enthalt  Dateien,  die  vorher 
einzeln  geloscht  werden  miissen) 

Intemer  Fehler  (?) 


Bemerkungen 

Vor  GEMDOS  0. 15  funktionierte  ein  “DcreateO”  unmittelbar  gefolgt  von  einem  “DdeleteO” 
nicht  (erst  ein  weiterer  Aufruf  von  “DdeleteQ”  fflhrte  zum  gewlinschten  Ergebnis). 
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Dfree  (GEMDOS  54)  -  Get  drive  free  space 


Mit  “DfreeO”  kann  man  diverse  Informationen  Uber  ein  bestimmtes  logisches  Laufwerk 
erfragen.  Die  Informationen  werden  in  einer  DISKINFO-Struktur  abgelegt: 

typedef  struct 

{ 

LONG  b_free;  /*  Anzahl  der  freien  Cluster  */ 

LONG  b_total;  /*  Gesamtzahl  der  Cluster  */ 

LONG  b_secsiz;  /*  Bytes  pro  Sektor  */ 

LONG  b_clsiz;  /*  Sektoren  pro  Cluster  /* 

}  DISKINFO; 


Declaration  in  C: 

LONG  Dfree  (DISKINFO  *buf ,  WORD  drv) ; 


Aufruf  in  Assembler: 


move . w 
pea 

move . w 
trap 
addq. 1 


drv,- (sp) 
buf 

#$36, -(sp) 
#1 

#8,  sp 


;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

drv:  0:  aktuelles  Laufwerk 

1:  A: 

2:  B:  (usw.) 

buf:  Anfangsadresse  des  DISKINFO-Puffers 

Dfree():  einige  mogliche  Retum-Werte: 

OK  (0):  alles  in  Ordnung 

Bemerkungen 

Auf  GEMDOS- Versionen  vor  0. 1 5  (“Rainbow-TOS”)  war  diese  Funktion  lacherlich  langsam. 
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Dgetdrv  (GEMDOS  25)  -  Get  default  drive 


Liefert  die  Nummer  des  aktuellen  Laufwerks. 

Deklaration  in  C: 

WORD  Dgetdrv  (void) ; 

Aufruf  in  Assembler: 

move.w  #$19, -(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Dgetdrv():  0:  Laufwerk  A: 

1:  Laufwerk  B: 

2:  Laufwerk  C: 

usw. 
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Liefert  den  Pfadnamen  fiir  das  aktuelle  Teilverzeichnis. 


Es  ist  eine  konzeptionelle  Schwache  des  GEMDOS,  daB  die  maximale  Lange  von  Verzeich- 
nisnamen  nicht  begrenzt  ist,  aber  auch  nicht  vorher  abgefragt  werden  kann. 

Ursache  fiir  dieses  merkwtirdige  Verhalten  ist,  daB  GEMDOS  erst  bei  “Dgetpath()”  den 
vollstandigen  Pfad  zusammenkopiert.  Es  bleibt  also  nichts  anderes  iibrig,  als  “DgetpathO” 
einen  “ausreichend”  langen  Puffer  zu  ubergeben. 

Ein  sinnvoller  Wert  diirfte  beispielsweise  256  Zeichen  sein,  da  das  Desktop  selbst  auch  keine 
langeren  Pfade  verwalten  kann. 

Deklaration  in  C: 

WORD  Dgetpath  (char  *buf ,  WORD  driveno) ; 

Aufruf  in  Assembler: 

move . w  driveno, - ( sp) 

pea  buf 

move.w  #$47, -(sp) 

trap  #1 

addq.l  #8,sp 

Parameter: 

buf:  Zeiger  auf  einen  Puffer,  der  nach  dem  Aufruf  den  aktuellen  Zugriffspfad  enthalt 

drv:  0:  aktuelles  Laufwerk 

1:  A: 

2:  B: 

usw. 

Dgetpath():  einige  mogliche  Retum-Werte: 

OK  (0):  alles  in  Ordnung 

EDRIVE  (-46):  Falsche  Laufwerksnummer 


;  Offset  6 
;  Offset  2 
;  Offset  0 
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Dsetdrv  (GEMDOS  14)  -  Set  default  drive 


Die  Nummer  des  aktuellen  Laufwerks  wird  gesetzt. 


Deklaration  in  C: 

LONG  Dsetdrv  (WORD  drv) ; 

Aufruf  in  Assembler: 

move.w  drv, -(sp)  ;  Offset  2 
move.w  #$E, - (sp)  ;  Offset  0 

trap  #1 

addq.l  #4,sp 


Parameter: 

drv:  Nummer  des  neuen  aktuellen  Laufwerks  (0:  A,  1:  B...) 

Dsetdrv():  Bitvektor  mit  den  vorhandenen  Laufwerken  (Bit  0:  A:,...) 

Bemerkungen 

Vorsicht!  Bei  vielen  Compilem  ist  der  Retum-Wert  dieser  Funktion  falschlich  als  “WORD” 
deklariert. 

Und  noch  einmal  Vorsicht!  GEMDOS  macht  bei  dieser  Funktion  iiberhaupt  keine 
Plausibilitatstests,  so  dal3  eine  falsche  Laufwerksnummer  (auBerhalb  des  erlaubten  Bereichs) 
zu  schweren  Schaden  in  GEMDOS-intemen  Strukturen  fiihren  kann! 

Einen  Bitvektor  mit  den  von  GEMDOS  unterstiitzen  Laufwerken  beschafft  man  sich  am 
besten  mit: 

Dsetdrv  (Dgetdrv  ()); 

Zur  Zeit  ist  der  zuriickgelieferte  Bitvektor  das  Resultat  des  BIOS-Aufrufs  “DrvmapO”.  Dies 
ist  jedoch  nicht  dokumentiert  und  konnte  sich  ohne  weiteres  eines  Tages  andem. 
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Dsetpath  (GEMDOS  59)  -  Set  current  directory 


Setzt  den  neuen  aktuellen  Zugriffspfad  fur  das  aktuelle  Laufwerk.  GEMDOS  merkt  sich  fur 
jedes  logische  Laufwerk  einen  aktuellen  Zugriffspfad.  “DsetpathO”  sollte  nur  fur  das  aktuelle 
Laufwerk  benutzt  werden.  Zum  Setzen  des  aktuellen  Pfades  auf  einem  anderen  Laufwerk 
sollte  man  etwa  folgende  Sequenz  benutzen: 

1 .  Aktuelles  Laufwerk  abfragen 

2.  Gewiinschtes  Laufwerk  setzen 

3.  Pfad  fur  das  Laufwerk  setzen 

4.  Gemerktes  Laufwerk  wieder  zum  aktuellen  Laufwerk  machen 


Deklaration  in  C: 

WORD  Dsetpath  (const  char  *path) ; 


Aufruf  in  Assembler: 


pea 

move . w 
trap 
addq.  1 


path 

#$3B,  -  (sp) 
#1 

#6,  sp 


;  Offset  2 
;  Offset  0 


Parameter: 

path:  Pfadname  fur  den  neuen  aktuellen  Zugriffspfad 

Dsetpath():  einige  mdgliche  Return- Werte: 

OK  (0):  alles  in  Ordnung 

EPTHNF  (-34):  Ordner  nicht  gefunden 

Bemerkungen 

Auf  alterenGEMDOS-Versionen  fiihrtdas  haufige  Setzen  nichtexistenterPfade  zu  GEMDOS- 
intemen  Storungen  (Verlust  von  Pfadkontrollstrukturen).  Mogliche  Folge  ist,  daB  selbst 

Dsetpath  ("\\") ;  /*  Pfad  auf  Wurzelverzeichnis  setzen  */ 


zu  einem  Fehler  fiihrt. 
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Fattrib  (GEMDOS  67)  -  Get/Set  file  attributes 

Liest  oder  setzt  die  Dateiattribute  einer  Datei, 

Deklaration  in  C: 

WORD  Fattrib  (const  char  *fname,  WORD  wflag,  WORD  attribs) ; 

Aufruf  in  Assembler: 

move.w  attribs, -  (sp) 
move . w  wflag, - (sp) 

pea  fname 

move.w  #$43, -(sp) 

trap  #1 

lea  $A(sp),sp 

Parameter: 

fname:  Dateiname  der  betreffenden  Datei  (ggfs.  mit  Zugriffspfad,  sonst  im  aktuellen 

Teilverzeichnis) 

wflag:  0:  die  aktuellen  Attribute  werden  nur  ausgelesen  und  zuriickgeliefert 

(attribs  wird  ignoriert) 

1 :  die  Dateiattribute  der  angegebenen  Datei  werden  auf  den  in  attribs  ange- 

gebenen  Wert  gesetzt 
attribs:  Dateiattribute: 

Bit  0:  Datei  schreibgeschiitzt 
Bit  1 :  Datei  versteckt  (“hidden”) 

Bit  2:  Systemdatei 

Bit  3:  Diskettenname 

Bit  4:  Teilverzeichnis  (Ordner) 

Bit  5:  Archiv-Bit 

Fattrib():  die  bisherigen  Dateiattribute  oder: 

EFILNF  (-33):  Datei  nicht  gefunden 
EPTHNF  (-34):  Ordner  nicht  gefunden 
oder  eine  andere  Fehletmeldung 


;  Offset  8 
;  Offset  6 
;  Offset  2 
;  Offset  0 
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Fclose  (GEMDOS  62)  -  Close  file 

SchlieBt  eine  mit  “Fopen()”  oder  “FcreateO”  geoffnete  Datei. 

Deklaration  in  C: 

WORD  Fclose  (WORD  handle) ; 

Aufruf  in  Assembler: 

move.w  handle, ~(sp)  ;  Offset  2 

move.w  #$3E,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #4,sp 

Parameter: 

handle:  Kennung  der  zu  schlieBenden  Datei 

Fclose():  einige  mogliche  Retum-Werte: 

OK  (0):  alles  in  Ordnung 

EIHNDL  (-37):  Dateikennung  war  falsch! 


Bemerkungen 

Was  beim  SchlieBen  von  Standardkanalen  passiert,  ist  erst  ab  GEMDOS  0. 1 5  definiert:  es  wird 
wieder  der  urspriingliche  zeichenorientierte  Kanal  eingesetzt. 
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Fcreate  (GEMDOS  60)  -  Create  file 

Unter  GEMDOS  gibt  es  zwei  Moglichkeiten,  eine  Datei  zum  Schreiben  zu  offnen:  mit 
“FcreateO”  kann  man  eine  vollig  neue  Datei  erzeugen.  Existiert  dabei  bereits  eine  Datei  mit 
diesem  Namen,  wird  sie  dabei  uberschrieben.  Mit  “FopenO”  dagegen  kann  man  nur  bereits 
existierende  Dateien  offnen. 

Die  Moral  von  der  Geschicht’:  Ausgabedateien  offnet  man  mit  “FopenO”  nicht! 

Deklaration  in  C: 

WORD  Fcreate  {const  char  *fnaine,  WORD  attribs) ; 

Aufruf  in  Assembler: 

raove.w  attribs, -  (sp) 

pea  fname 

move.w  #$3C,-(sp) 

trap  #1 

addq.i  #8,sp 

Parameter: 

fname:  Zeiger  auf  den  Dateinamen  (dabei  kann  auch  der  Zugriffspfad  angegeben 

werden,  ansonsten  wird  das  aktuelle  Teilverzeichnis  benutzt). 
attribs:  Bit  0:  Datei  schreibgeschiitzt 

Bit  1 :  Versteckte  Datei 
Bit  2:  Systemdatei 

Bit  3:  Diskettenname  (sollte  auf  jeder  Diskette  nur  einmal  vorhanden  sein!) 
Fcreate():  Kennung  der  Datei  oder 

EPTHNF  (-34):  Zugriffspfad  war  nicht  korrekt 

ENHNDL  (-35):  Keine  freien  Dateikennungen  (handles)  mehr 
EACCDN  (-36):  Kein  Schreibzugriff  moglich 

oder  eine  andere  Fehlermeldung 

Bemerkungen 

Vorsicht  bei  der  Benutzung  von  Wildcards:  eine  Dateiangabe  wie  “TEST*.*”  wird  von 
GEMDOS  intern  zunachst  zu  “TEST????.???”  expandiert.  Unter  diesem  (nicht  erlaubten) 
Namen  wird  die  Datei  dann  auch  tatsachlich  angelegt! 


;  Offset  6 
;  Offset  2 
;  Offset  0 
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Bei  Verwendung  eines  netzwerkfahigen  GEMDOS  (Cookie  “_FLK”  testen!)  ist  die  Datei 
exklusiv  fiir  den  anlegenden  ProzeB  zuganglich. 

Den  Diskettennamen  kann  man  folgendermaften  neu  setzen: 

IF  GEMDOS-Version  <0.15 

IF  Volume-Label  schon  vorhanden 

Datei  gleichen  Namens  mit  FcreateO  anlegen,  mit  Fclose  () 
schlieften  und  mit  Fdelete()  wieder  loschen 
END  IF 
ENDIF 

Diskettennamen  mit  FcreateO  anlegen  und  das  zuriickgelieferte 
Handle  mit  Fclose ( )  wieder  f reigeben . 
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Fdatime  (GEMDOS  87)  -  Get/Set  file  timestamp 


Setzt  Oder  ermittelt  Uhrzeit  und  Datum  der  Erstellung  einer  Datei  (die  man  zuvor  mit 
“Fopen()”  Oder  “FcreateO”  gedffnet  hat).  Zur  Zeitiibergabe  wird  folgende  Struktur  benutzt: 

typedef  struct 
{ 

UWORD  time;  /*  Zeit  wie  in  "Tgettime"  */ 

UWORD  date;  /*  Datum  wie  in  "Tgetdate"  */ 

}  DOSTIME; 

Deklaration  in  C: 

void  Fdatime  (DOSTIME  *timeptr,  WORD  handle,  WORD  wflag) ; 


Aufruf  in  Assembler: 


move . w 

move.w 

pea 

move.w 

trap 

lea 


wflag,- (sp) 
handle,  - (sp) 
timeptr 
#$57, -(sp) 

#1 

$A(sp) ,sp 


;  Offset  8 
;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

handle:  Dateikennung  der  betreffenden  Datei 

timeptr:  Zeiger  auf  eine  DOSTIME-Struktur 

wflag:  0:  Aktuelle  Werte  in  DOSTIME-Struktur  iibertragen 

1:  Werte  aus  DOSTIME-Struktur  in  Directory  eintragen 


Bemerkungen 

Wegen  einiger  Fehler  in  alten  GEMDOS-Versionen  sollte  man  “FdatimeO”  stets  auf  folgende 
Art  und  Weise  benutzen: 

1 .  Datei  offnen 

2.  “FdatimeO”  aufrufen 


3.  Datei  sofort  wieder  schlieBen 
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Fdelete  (GEMDOS  65)  -  Delete  file 

Loscht  die  angegebene  Datei. 

Deklaration  in  C: 

WORD  Fdelete  (const  char  *fname) ; 

Aufruf  in  Assembler: 

pea  fname 

move.w  #$41, -(sp) 

trap  #1 

addq.l  #6,sp 

Parameter: 

fname:  Name  der  betreffenden  Datei  (evtl.  mit  Zugriffspfad) 

Fdelete():  einige  mogliche  Retum-Werte: 

OK  (0):  alles  in  Ordnung 

EFELNF  (-33):  Datei  nicht  gefunden 

EACCDN  (-36):  Zugriff  verwehrt  (Datei  schreibgeschiitzt?) 

Bemerkungen 

Es  ist  nicht  moglich,  geoffnete  Dateien  zu  loschen  -es  sei  denn,  man  selbst  ist  der  einzige  Pro- 
zeB,  der  die  Datei  geoffnet  hat.  In  diesem  Fall  wird  die  Datei  erst  geschlossen  und  dann  ge- 
loscht.  Leidertrittdabei  einFehlerauf:  Die  Dateikennung  wird  nicht  wieder  freigegeben  .Also: 
geoffnete  Dateien  nicht  loschen! 


;  Offset  2 
;  Offset  0 
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Fdup  (GEMDOS  69)  -  Duplicate  file  handle 


Fur  den  angegebenen  Standardkanal  (0.  .5)  wird  eine  zweite  Kennung  (handle)  geliefert  (siebe 
auch  “FforceO”). 

In  alien  bekannten  GEMDOS-Versionen  (bis  einschlielMich  0. 1 9)  treten  Fehler  auf,  wenn  nach 
“FdupO”  noch  ein  Programm  mittels  “PexecQ”  gestartet  wird. 


Deklaration  in  C: 

WORD  Fdup  (WORD  handle) ; 


Aufruf  in  Assembler: 

move.w  handle, -(sp)  ;  Offset  2 

move.w  #$45, -(sp)  ;  Offset  0 

trap  #1 

addq.l  #4,sp 


Parameter: 

stdhandle:  Nummer  des  Standardkanals: 

0:  Tastatur  (stdin) 

1:  Bildscbirm  (stdout) 

2:  Serielle  Schnittstelle  (stdaux) 

3:  Parallele  Schnittstelle  (stdpm) 

Fdup():  Neue  Kennung  Oder: 

ENHNDL  (-35):  keine  freien  Kermungen  mehr 

EIHNDL  (-37):  falsche  Kennung  (handle) 

oder  eine  andere  Fehlermeldung 
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Fforce  (GEMDOS  70)  -  Force  file  handle 


Der  Schlussel  zur  “Input/Output-Redirection”:  biegt  einen  Standardkanal  (0..5)  auf  einen 
beliebigen  anderen  Kanal  um. 


Dekiaration  in  C: 

WORD  Fforce  (WORD  stdh,  WORD  nonstdh) ; 


Aufruf  in  Assembler: 

move . w  nonstdh , - ( sp ) 

move.w  stdh, - (sp) 

move.w  #$46, -(sp) 

trap  #1 

addq.l  #6,sp 


;  Offset  4 
;  Offset  2 
;  Offset  0 


Parameter: 


stdh: 


nonstdh: 


FforceQ: 


Nummer  des  umzuleitenden  Kanals: 

0:  Tastatur  (stdin) 

I :  Bildschirm  (stdout) 

2:  Serielle  Schnittstelle  (stdaux) 

3:  Parallele  Schnittstelle  (stdpm) 

Nummer  des  ersetzenden  Kanals  (muB  vorher  mit  “FopenO”  Oder  “FcreateO” 
geoffnet  worden  sein.  Mit  “FdupO”  kann  man  ein  “nonstdhandle”  fiir  einen 
Standardkanal  besorgen).  Mit  “Fforce  (1,  Fdup  (3))”  konnte  man  also  beispiels- 
weise  alle  Bildschirmausgaben  an  den  Dracker  umleiten! 
einige  mogliche  Retum-Werte: 

OK  (0):  alles  in  Ordnung 

EIHNDL  (-37):  Falsche  Kennung  (handle) 
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Fgetdta  (GEMDOS  47)  -  Get  DTA 


Liefert  die  Anfangsadresse  der  aktuellen  DTA  (Siehe  auch  unter  “Fsfirst()”  und  “Fsnext()”>: 

typedef  struct 
{ 


BYTE  d_reserved[21] ; 

/* 

fiirs  GEMDOS  reserviert  */ 

BYTE  d  attrib; 

/* 

Dateiattribut  */ 

UWORD  d_time; 

/* 

Uhrzeit  */ 

DWORD  d_date; 

/* 

Datum  */ 

LONG  d_length; 

/* 

Dateilange  */ 

char  d  f name [14]; 

/* 

Dateiname  */ 

}  DTA; 

Deklaration  in  C: 

DTA  *Fgetdta  (void) ; 

Aufruf  in  Assembler: 

move.w  #$2F,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 


Parameter: 

FgetdtaQ:  Zeiger  auf  die  aktuelle  DTA 
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Flock  (GEMDOS  92)  -  Lock  file 


Diese  Funktion  ist  nur  unter  einem  netzwerkfahigen  GEMDOS  (“_FLK”~Cookie  testen!) 
verfiigbar. 

Sie  dient  dazu,  Teile  von  Dateien  gegen  den  Zugriff  von  anderen  Prozessen  (Benutzem)  zu 
schiitzen. 


Deklaration  in  C: 

LONG  Flock  (WORD  handle,  WORD  mode,  LONG  start,  LONG  length) ; 


Aufruf  in  Assembler: 

move . 1  length , - ( sp ) 

move.l  start, -(sp) 

move . w  mode , - ( sp) 

move . w  handle , - ( sp ) 

move.w  #$5C, -(sp) 

trap  #1 

lea  $C(sp),sp 


;  Offset  10 
;  Offset  6 
;  Offset  4 
;  Offset  2 
;  Offset  0 


Parameter: 

handle:  Kennung  der  betreffenden  Datei 

mode:  0:  “length”  Bytes  ab  Position  “start”  blockieren  (“locken”) 

1 :  Blockierung  aufheben.  “length”  und  “start”  miissen  exakt  zu  einer  exi- 

stierenden  Blockierung  passen! 
start:  Startposition  in  der  Datei 

length:  Anzahl  der  Bytes 

Flock():  einige  mogliche  Retum-Werte: 

OK  (0):  alles  in  Ordnung 

BLOCKED  (-58):  Blockierung  (Lock)  bereits  vorhanden 

(Dateiausschnitt  ist  bereits  blockiert  bzw.  iiberlappt  ei- 
nen  blockierten  Ausschnitt.) 

ENSLOCK  (-59):  Entsprechende  Blockierung  existiert  nicht 

(Es  wurde  versucht,  eine  nicht  vorhandene  Blockierung 
aufzuheben.) 


Bemerkungen 

Siehe  Hinweise  zum  Atari-Netzwerkstandard  in  der  GEMDOS-Einfiihrung. 
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Fopen  (GEMDOS  61)  -  Open  file 


Offnet  (existierende)  Dateien.  Dazu  gehoren  auch  die  folgenden  zeichenorientierten  Gerate: 

PRN:  Parallele  Schnittstejle  (liefert  handle  -3) 

AUX:  Serielle  Schnittstelle  (liefert  handle  -2) 

CON:  Konsole  (liefert  handle  -1) 

Fur  die  wichtigsten  Gerate  gibt  es  auBerdem  auch  schon  Standardkanalnummem,  so  daB  man 
“Fopen()”  iiberhaupt  nicht  aufzurufen  braucht: 

0:  Tastatur  (stdin) 

1 :  Bildschirm  (stdout) 

2:  Serielle  Schnittstelle  (stdaux) 

3:  Parallele  Schnittstelle  (stdpm) 

Laut  Atari  sind  die  Standardkanalnummem  4  und  5  auch  reserviert  -  wofiir  ist  zur  Zeit  nicht 
bekannt.  “Normale”  Kanalnummem  fiir  Dateien  beginnen  bei  6. 


Deklaration  in  C: 

WORD  Fopen  (const  char  *fname,  WORD  mode) ; 


Aufruf  in  Assembler: 


move . w 
pea 
move . w 
trap 
addq . 1 


mode,  - (sp) 
fname 
#$3D,  - (sp) 
#1 

#8,  sp 


;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

fname:  Dateiname  der  zu  offnenden  Datei  (evtl.  mit  Zugriffspfad,  sonst  wird  im 

aktuellen  Teilverzeichnis  gesucht) 
mode:  0:  nur  lesen 

1:  nurschreiben 

2:  lesen  und  schreiben 

Fopen():  Entweder  die  Datei-Kennung  (handle)  oder 

EFILFN  (-33):  Datei  nicht  gefunden 
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ENHDNL  (-35):  keine  freien  Datei-Kennungen 
EACCDN  (-36):  Zugriff  nicht  erlaubt 
Oder  eine  andere  Fehlemummer 


Bemerkungen 

Unter  einem  GEMDOS  mil  File-Locking-Erweiterungen  (“_FLK”-Ccokie  testen!)  gelten 
zusatzlich  folgende  Definitionen: 

Der  mode-Parameter  ist  als  Bitvektor  mit  folgender  Belegung  definiert: 

Bit  7:  Vererbungs-Flag 

Bit  4..6:  Sharing-Modus 

Bit  3:  reserviert  (auf  Null  setzen) 

Bit  0..2:  Zugriffsmodus 

Der  Zugriffsmodus  entspricht  dem  normalen  Modusparameter  unter  Standard-GEMDOS: 

0  (binar  000):  nur  lesen 

1  (binar  001):  nurschreiben 

2  (binar  010):  lesen  und  schreiben 


Der  Sharing-Modus  legt  fest,  auf  welche  Art  andere  Prozesse  auf  die  Datei  zugreifen  diirfen, 
wenn  sie  erst  einmal  geoffnet  ist: 


0  (binar  000): 

1  (binar  001): 

2  (binar  010): 

3  (binar  Oil): 

4  (binar  100): 


Kompatiblitatsmodus  (logischerweise  der  Modus,  der  von  Programmen 
benutzt  wird,  die  nichts  von  den  Netzwerkerweiterungen  wissen) 

Lesen  und  Schreiben  verbieten  (die  Datei  darf  kein  zweites  Mai  geoffnet 
werden) 

Schreiben  verbieten  (die  Datei  darf  nur  noch  zum  Lesen  geoffnet 
werden) 

Lesen  verbieten  (die  Datei  darf  nur  noch  zum  Schreiben  geoffnet 
werden) 

Alles  ist  erlaubt 


Beim  zweiten  Versuch,  die  Datei  zu  bffnen,  wird  dann  iiberpriift,  ob  sich  der  verlangte  Modus 
mit  dem  bereits  aktiven  Modus  unter  einen  Hut  bringen  lafit. 

Fur  im  Kompatibilitatsmodus  geoffnete  Dateien  gelten  folgende  Regelungen: 
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-  Die  Datei  kann  anschlieBend  nur  noch  vom  gleichen  ProzeB  geoffnet  werden  -  und  auch 
nur  ebenfalls  wieder  im  Kompabilitatsmodus. 

-  Die  Ausnahme  von  der  Regel :  Wird  eine  schreibgeschiitzte  Datei  im  Kompabilitatsmodus 
zum  Lesen  geoffnet,  dann  wird  automatisch  Sharing-Modus  2  (“Schxeiben  verbieten”) 
angenommen. 

Achtung:  Das  File-Locking  kann  beratend  implementiert  sein  (“advisory  file  locking”),  d.h., 
daB  es  moglich  sein  kann,  auf  Bereiche  trotz  eines  vorgenommenen  Lockings  zuzu- 
greifen.  Programme,  die  File-Locking  benutzen,  sollten  daher  vor  einem  Zugriff 
selbst  einen  Lock  setzen  und  diesen  unmittelbar  nach  dem  Zugriff  wieder  freige- 
ben.  So  ist  garantiert,  daB  etwaige  Locks  anderer  Seiten  respektiert  werden. 
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Fread  (GEMDOS  63)  -  Read  from  file 


Liest  eine  bestimmte  Anzahl  von  Bytes  aus  einer  Datei  an  eine  gegebene  Adresse. 


Deklaration  in  C: 

LONG  Fread  (WORD  handle,  LONG  count,  void  *buffer) ; 


Aufruf  in  Assembler: 

pea  buffer  ;  Offset  8 

move.l  count, -(sp)  ;  Offset  4 

move.w  handle, -(sp)  ;  Offset  2 

move.w  #$3F,-(sp)  ;  Offset  0 

trap  #1 

lea  $C(sp),sp 


Parameter: 

handle:  Dateikennung  der  betreffenden  Datei 

count:  Anzahl  der  zu  lesenden  Bytes 

buffer:  Anfangsadresse  des  Puffers 

Fread():  Entweder  die  Gesamtzahl  der  tatsachlich  gelesenen  Bytes  (Vorsicht  bei  Uber- 

priifung  -  das  ist  ein  LONG- Wert;  0  bedeutet  Dateieende)  Oder 
EIHNDL  (-37):  Dateikennung  falsch 

ELOCKED  (-58):  Dateiausschnitt  ist  blockiert 
oder  eine  andere  Fehlermeldung 

Bemerkungen 

In  GEMDOS-Versionen  vor  0.15  (“Rainbow-TOS”)  kommt  es  zum  Systemhalt,  wenn  man 
als  “count”  0  ubergibt.  Beim  Lesen  von  Standardkanalen  diiifen  maximal  16383  Zeichen  gele- 
sen  werden. 
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Frename  (GEMDOS  86)  -  Rename  file 


Eine  Datei  wird  umbenannt.  Der  neue  Name  darf  auch  einen  kompletten  Zugriffspfad 
innerhalb  des  betreffenden  logischen  Laufwerks  enthalten  -  die  Datei  wird  dann  verschoben 
(“gemoved”)! 


Deklaration  in  C: 

WORD  Frename  (const  char  *oldname,  const  char  *newname) ; 


Aufruf  in  Assembler: 

pea  newname  ;  Offset  8 

pea  oldname  ;  Offset  4 

move.w  #0,-(sp)  ;  Offset  2 

move.w  #$56, -(sp)  ;  Offset  0 

trap  #1 

lea  $C(sp),sp 


Parameter: 

Zeiger  auf  bisherigen  Dateinamen 
Zeiger  auf  neuen  Dateinamen  (ggfs.  mit  Zugriffspfad) 

OK  (0):  alles  in  Ordnung 

EPTHNF  (-34):  Ordner  nicht  gefunden 

EACCDN  (-36):  Zugriff  verwehrt  (Datei  schreibgeschiitzt) 

ENSAME  (-48):  nicht  auf  dem  gleichen  logischen  Laufwerk 
Oder  eine  andere  Fehlermeldung 

Bemerkungen 

Ab  GEMDOS  0.15  kann  man  mit  dieser  Funktion  auch  Ordner  umbenennen  (allerdings  nicht 
in  der  Ordnerhierarchie  verschieben). 

Man  sollte  nicht  versuchen,  eine  Datei  umzubenennen,  die  bereits  geoffnet  ist  (es  gelten  die 
gleichen  Griinde  wie  bei  “FdeleteO”). 


oldname: 

newname: 

Frename(): 
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Fseek  (GEMDOS  66)  -  Seek  file  pointer 


Mit  “FseekQ”  kann  der  Zeiger  fur  Zugriffe  innerhalb  einer  Datei  neu  gesetzt  werden  (sehr 
praktisch  beispielsweise  beim  Uberspringen  von  Dateiteilen). 


Deklaration  in  C: 

LONG  Fseek  (LONG  offset,  WORD  handle,  WORD  seekmode) ; 


Aufruf  in  Assembler: 


move .  w 
move .  w 
move . 1 
move . w 
trap 
lea 


seekmode, - (sp) 
handle, - (sp) 
offset, -  (sp 
#$42, -(sp) 

#1 

$A(sp)  ,  sp 


;  Offset  8 
;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

offset:  Anzahl  von  Bytes,  die  iibersprungen  werden  sollen 

handle:  Dateikennung  der  betreffenden  Datei 

seekmode:  0:  positionieren  ab  Dateistart 

1 :  ab  aktueller  Position 

2:  ab  Dateiende 

Fseek():  Neue  absolute  Position  in  der  Datei,  oder 

EIHNDL  (-37):  falsche  Datei-Kennung  (handle) 

Bemerkungen 

Mit  “Fseek()”kann  man  auchfeststellen,  ob  eine  Ein-/Ausgabeumlenkung  auf  den  Bildschirm 
vorliegt: 

WORD  isatty  (WORD  handle) 

{  ■ 

LONG  oldoffset,  rc; 

oldoffset  =  Fseek  (0L,  handle,  1) ; 

rc  =  Fseek  (1L,  handle,  0) ; 

Fseek  (oldoffset,  handle,  0) ; 
return  (rc  !=  1) ; 


} 
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Leider  klappt  diese  Methode  nicht,  wenn  die  betreffende  Datei  leer  ist.  Dieser  Fall  tritt  haufig 
in  Shells  mit  Ein-/Ausgabeumlenkung  (bzw.  Pipes)  auf.  Abhilfe  fur  die  Shell:  Ausgabe- 
umlenkung  immer  nur  fur  nicht-leere  Dateien  machen.  Bei  Ausgabedateien  immer  gleich  ein 
<Ctrl><Z>  (End-Of-File,  ASCII  26)  hineinschreiben  und  mit  “FseekO”  wieder  an  den  Datei- 
anfang  zuriickgehen. 
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Fsetdta  (GEMDOS  26)  -Set  DTA 


Setzt  die  Anfangsadresse  der  aktuellen  DTA  (wird  von  “FsfirstO”  und  “FsnextO”  benutzt): 

typedef  struct 
{ 


BYTE  d  reserved [21] ; 

/* 

flirs  GEMDOS  reserviert  */ 

BYTE  d_attrib; 

/* 

Dateiattribut  */ 

UWORD  d_time; 

/* 

Uhrzeit  */ 

UWORD  d_date; 

/* 

Datum  */ 

LONG  d_length; 

/* 

Dateilange  */ 

char  d  f name [14]; 

/* 

Dateiname  */ 

}  DTA; 

Deklaration  in  C: 

void  Fsetdta  (DTA  *ptr) ; 

Aufruf  in  Assembler: 

pea  ptr  ;  Offset  2 

move.w  #$1A, - (sp)  ;  Offset  0 

trap  #1 

addq.l  #6,sp 


Parameter: 

ptr:  Anfangsadresse  der  neuen  DTA 

Bemerkungen 

Bei  Programmstart  wird  die  DTA  ab  Offset  $80  (128)  in  der  Basepage  eingerichtet  (das  ist  am 
Anfang  der  Kommandozeile...)! 
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Fsfirst  (GEMDOS  78)  -  Search  first 


Diese  Funktion  erlaubt  es,  Informationen  uber  Dateien  zu  erfragen.  Die  zu  iibergebende  Datei- 
spezifikation  darf  eine  beliebige  Dateibezeichnung  (also  mit  Laufwerk  oder  ohne,  mit  absolu- 
tem  oder  relativem  Pfad)  enthalten. 

Je  nach  Wert  wixd  dann  in  dem  angegebenen  Verzeichnis  oder  im  aktuellen  Verzeichnis  ge- 
sucht. 

Die  Dateibezeichnung  darf  auch  einen  unvollstandigen  Dateinamen  enthalten.  Als  Platzhalter 
(Wildcards)  kommen  dabei  das  “?”  (steht  fiir  einen  beliebigen  Buchstaben)  und  das  (steht 
fur  mehrere  beliebige  Buchstaben  auBer  dem  Punkt)  zum  Einsatz. 

“Fsfirst()”  liefert  Informationen  iiber  die  erste  Datei,  auf  die  das  Muster  paGt  (Informationen 
Uber  weitere  Dateien  kann  man  dann  mit  “FsnextO”  erfragen). 

Einige  wichtige  Hinweise: 

-  Wildcards  durfen  nur  im  eigentlichen  Dateinamen,  nicht  aber  im  Pfadnamen  auftauchen. 

-  Die  GEMDOS-intemen  Routinen  zur  Wildcard-Suche  sind  nicht  ganz  fehlerfrei  (so  pafit 
“A*.**”  beispielsweise  auf  jede  Datei).  Im  Zweifelsfall  ist  es  sicherer,  die  Auswertung 
selbst  zu  machen  und  GEMDOS  nach  (alle  Dateien)  suchen  zu  lassen.  Nicht 
umsonst  verfahren  die  AES  in  der  Dateiauswahlbox  genauso. 

Wenn  der  angegebene  Pfad  nicht  existiert,  erhalt  man  nicht  etwa  eine  Fehlermeldung, 
sondem  es  werden  lediglich  keine  Dateien  gefunden. 

Das  zu  suchende  Dateiattribut  kann  uber  “attribs”  angegeben  werden.  Dabei  werden  nachein- 
ander  folgende  Regeln  ausgewertet: 

1 .  Falls  “attribs”  8  ist,  erscheint  die  Datei  nur  dann,  wenn  ihr  Attributbyte  auch  den  Wert 
8  hat  (zu  deutsch:  wenn  man  das  Bit  fur  Diskettennamen  gesetzt  hat,  werden  auch  nur 
die  Diskettennamen  zuruckgeliefert!). 

2.  Wenn  das  Dateiattribut  “Archiv”  und  “schreibgeschutzt”  enthalt  oder  wenn  es  0  ist,  er¬ 
scheint  die  Datei. 

3.  Wenn  es  Attributbits  gibt,  die  sowohl  im  Dateiattribut  als  auch  in  “attribs”  gesetzt  sind, 
erscheint  die  Datei. 
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Das  klingt  nicht  nur  kompliziert  -  das  ist  es  auch,  Daher  ein  Biick  in  die  C-Routine  im 
GEMDOS,  die  fiir  die  Auswertung  zustandig  ist  (vielen  Dank  an  Atari  fur  die  Offenlegung 
dieser  Zeilen!).  Sei  “da”  das  Dateiattribut  der  untersuchten  Datei: 

if  (  ((da  !  =  0)  &&  (attribs  !=  8))  II  ( (attribs  |  0x21)  &  da))) 


/*  Datei  anzeigen  */ 

} 

Folge :  Versteckte  Dateien  und  Systemdateien  werden  nur  dann  korrekt  als  solche  behandelt, 
wenn  bei  ihnen  nicht  das  “Schreibschutz”-  oder  das  “ Archiv”-Bit  gesetzt  ist  (noch  ein  Grund, 
die  Auswertung  selbst  vorzunehmen...).  Verzeichnisse  und  Diskettennamen  erscheinen  nur 
dann,  wenn  auch  das  passende  Bit  in  “attribs”  gesetzt  ist.  Welche  Bits  muB  man  nun  setzen, 
um  alle  Dateien  und  Ordner,  nicht  aber  die  Diskettennamen  zu  bekommen?  Dazu  nochmal 
die  symbolischen  Konstanten: 


#define 

FA_RDONLY 

0x01 

♦define 

FA__HIDDEN 

0x02 

♦define 

FA__SYSTEM 

0x04 

♦define 

FA_LABEL 

0x08 

♦define 

FAJDIREC 

0x10 

♦define 

FA__ARCH 

0x20 

♦define 

FA_ATTRIB 

(FA_DIREC I FA_RDONLY | FA  HIDDEN | FA  SYSTEM) 

Mit  “FA  ATTRIB”  (0x17)  als  Attributmuster  bekommt  man  also  alle  “interessanten” 
Dateien.  Das  Ergebnis  wird  in  der  DTA  (“Disk  Transfer  Address”)  abgelegt,  deren  Adresse 
man  mit  “FgetdtaO”  lesen  und  mit  “FsetdtaO”  verandem  kann: 


typedef  struct 

{ 

BYTE  d_reserved[21] ; 
BYTE  d_attrib; 

UWOED  d_time; 

UWORD  djdate; 

LONG  d_length; 
char  d_fname[14j; 

}  DTA; 


/*  fiirs  GEMDOS  reserviert  */ 
/*  Dateiattribut  */ 

/*  Uhrzeit  */ 

/*  Datum  */ 

/*  Dateilange  */ 

/*  Dateiname  */ 


Deklaration  in  C: 

WORD  Fs first  (const  char  *fspec,  WORD  attribs) ; 


GEMDOS 


247 


Aufruf  in  Assembler: 

move . w  attribs, - (sp) 

pea  fspec 

move.w  #$4E,-(sp) 

trap  #1 

addq.l  #8,sp 


;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

fspec:  Zeiger  auf  den  Dateinamen 

attribs:  Jeweils  fur  den  gesuchten  Dateityp  das  entsprechende  Bit  setzen: 

Bit  0:  Datei  schreibgeschiitzt 
Bit  1 :  Datei  versteckt  (“hidden”) 

Bit  2:  Systemdatei 

Bit  3:  Diskettenname  (“volume  name”) 

Bit  4:  Teiiverzeichnis  (Ordner) 

Bit  5:  Archiv-Bit 

Fsfirst():  einige  mogliche  Return- Werte: 

OK  (0) :  alles  in  Ordnung 

EFILNP  (-33):  Datei  nicht  gefunden 

ENMF1L  (-49):  Keine  weiteren  Dateien 
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Fsnext  (GEMDOS  79) 

-  Search  next 

Setzt  die  mit  “FsfirstO”  begonnene  Suche  fort. 

Deklaration  in  C: 

WORD  Fsnext  (void) ; 

Aufruf  in  Assembler: 

move.w  #$4F,-(sp) 

trap  #1 

addq.l  #2,sp 

;  Offset  0 

Parameter: 

FsnextO:  OK  (0): 

alles  in  Ordnung 

ENMFIL  (-49): 

Keine  weiteren  Dateien! 
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Fwrite  (GEMDOS  64)  -  Write  to  file 


Schreibt  eine  Anzahl  von  Bytes  aus  einem  Puffer  in  eine  gegebene  Datei. 

Deklaration  in  C: 

LONG  Fwrite  (WORD  handle, 

LONG  count,  void  *buffer) ; 

Aufruf  in  Assembler: 

pea 

buffer 

;  Offset  8 

move . 1 

count,  -  (sp) 

;  Offset  4 

move . w 

handle, - (sp) 

;  Offset  2 

move . w 

#$40, - (sp) 

;  Offset  0 

trap 

#1 

lea 

$C (sp) , sp 

Parameter: 

handle: 

Dateikennung  der  betreffenden  Datei 

count: 

Anzahl  der  zu  schreibenden  Bytes 

buf: 

Anfangsadresse  des  Puffers 

FwriteQ: 

Entweder  die  Gesamtzahl  der  tatsachlich  geschriebenen  Bytes  (wichtig,  falls 
der  Platz  auf  der  Diskette  nicht  gereicht  hat)  oder 

EACCDN  (-36): 

Zugriff  verwehrt  (Datei  schreibgeschiitzt?) 

EIHNDL  (-37): 

Falsche  Dateikennung 

ELOCKED  (-58): 

Dateiausschnitt  ist  blockiert 

Oder  eine  andere  Fehlermeldung 
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Maddalt  (GEMDOS  20)  -  Inform  GEMDOS  of  “alternative”  memory 


Mit  diesem  Aufruf  (erhaltlich  ab  GEMDOS  0.19)  kann  man  einen  Block  von  “Alternate 
RAM”  in  die  GEMDOS-Speicherliste  aufnehmen  lassen.  GEMDOS  verwaltetden  Block dann 
ganz  so,  wie  alles  andere  “Alternate  RAM”,  das  bereits  beim  Systemstart  gefunden  wurde.  1st 
der  Block  einmal  installiert,  kann  er  GEMDOS  nicht  wieder  weggenommen  werden. 

MoglicheAnwendung:  VME-Bus-Karten  fur  den  TT,deren  SpeicherfiirGEMDOS  zuganglich 
gemacht  werden  soli  (das  kann,  aber  muB  nicht  eine  Speichererweiterungskarte  sein:  auch  fur 
uberfliissiges  RAM  auf  einer  Grafikkarte  kann  das  sinnvoll  sein).  Logischerweise  darf  der 
Aufruf  nur  einmal  pro  Block  stattfinden  (am  besten  also  im  AUTO-Ordner). 


Deklaration  in  C: 

LONG  Maddalt  (void  * start,  LONG  size) ; 


Aufruf  in  Assembler: 

move.l  size,-(sp) 

move . 1  start , - ( sp) 
move.w  #$14,- (sp) 

trap  #1 

lea  $A(sp),sp 


Offset  6 
Offset  2 
Offset  0 


Parameter: 

start:  Anfangsadresse  des  Speicherbereichs 

size:  Lange  des  Speicherbereichs 

Maddalt():  0  (alles  o.k.)  oder  eine  Fehlermeldung 
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Malloc  (GEMDOS  72)  -  Allocate  memory 


Reserviert  Speicherplatz  oder  berechnet  verfugbaren  Speicherplatz, 


Deklaration  in  C: 

void  *Malloc  (LONG  amount) ; 


Aufruf  in  Assembler: 


move .  1 
move . w 
trap 
addq.l 


amount,  -  (sp) 
#$48,  - (sp) 

#1 

#6,  sp 


;  Offset  2 
;  Offset  0 


Parameter: 

amount:  -1:  Berechne  LSnge  des  grbBten  verfugbaren  Speicherblocks 

sonst:  Anzahl  der  zu  reservierenden  Bytes  (muB  eine  positive  Zahl  sein, 
ansonsten  wird  es  zu  Fehlverhalten  von  GEMDOS  kommen!) 
Malloc():  ftir  amount  =  -1:  Lange  des  groBten  verfugbaren  Speicherblocks 

sonst:  Anfangsadresse  des  reservierten  Speicherbereiches  (oder 

im  Fehlerfall  0) 


Bemerkungett 

Bei  Programmstart  wird  der  groBte  verfiigbare  Speicherblock  fur  das  gestartete  Programm 
alloziert.  Im  Programm  muB  man  also  erst  “MshrinkO”  benutzen,  bevor  man  “MallocO” 
wieder  sinnvoll  anwenden  kann. 

GEMDOS  unterstiitztnureine  begrenzte  Anzahl  von  allozierten  Speicherblocken  (ausprobie- 
ren!).  Daher  sollte  man  diese  Funktion  nicht  allzu  haufig  (etwa  30mal)  innerhalb  eines  Pro¬ 
grammes  verwenden,  sondem  statt  dessen  groBere  Speicherblocke  (von  mindestens  16 
Kilobyte)  reservieren  und  diese  dann  selbst  verwalten  (siehe  dazu  die  Diskussion  des  GEM- 
DOS-Pools)! 

Die  Speicherverwaltung  wird  besonders  ineffektiv,  wenn  man  viele  kleinere  Blocke  alloziert 
und  diese  dann  nicht  in  der  gleichen  Reihenfolge  wieder  freigibt, 

“Malloc  (0)”  liefert  vor  GEMDOS  0. 1 5  keinesinnvollen  Ergebnisse,  ab  0. 1 5  wird  korrekterweise 
ein  Fehler  gemeldet  (0). 
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Man  darf  sich  keinesfalls  darauf  verlassen,  dab  man  tatsachlich  soviel  Bytes  wie  mit  “Malloc 
(-1)”  festgestellt  allozieren  kann.  Insbesondere  Konstruktionen  wie  “Malloc  (Malloc  (-1))” 
konnen  ohne  vveiteres  scheitem. 

Der  Grund:  Unter  einem  multitaskingfahigen  TOS  (bzw.  unter  einer  multitaskingfahigen 
GEMDOS-Erweiterung  wie  “MiNT”)  kann  zwischen  denbeiden  Aufrufen  ein  ProzeBwechsel 
stattfinden. 

Und  ein  letzter  Hinweis :  man  darf  keinerlei  Annahmen  liber  Lage  und  Inhalt  des  allozierten 
Speichers  machen! 

-  Der  Speicherblock  muB  nicht  leer  sein  (siehe  “Fastload”-Flag  im  Programmkopf). 

-  Nacheinander  allozierte  Speicherblocke  mussen  nicht  unbedingt  zusammenhangen. 

-  Man  darf  nie  Speicherbereiche  benutzen,  die  nicht  dem  eigenen  ProzeB  gehoren 
(Original-Ton  Atari  im  “Pexec  Cookbook”;  “Thou  shalt  not  mess  with  memory  thou 
ownest  not”).  Dies  ist  insbesondere  in  Hinsicht  auf  eine  geplante  TOS-Version  mit 
Memory  Protection  wichtig  (“Memory  Protection”  durch  die  PMMU  erlaubtes,  Schreib- 
zugriffe  auf  “fremden”  Speicher  durch  eine  Exception  zu  verhindem). 
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Mfree  (GEMDOS  73)  -  Release  memory 


Ein  allozierter  Speicherblock  wird  wieder  fireigegeben. 

Deklaration  in  C: 

WORD  Mfree  (void  *saddr) ; 


Aufruf  in  Assembler: 

pea  saddr  ;  Offset  2 

move.w  #$49,- (sp)  ;  Offset  0 

trap  #1 

addq.l  #6,sp 

Parameter: 

saddr:  Anfangsadresse  des  freizugebenden  Speicherbereiches 

MfreeQ:  OK  (0):  alles  in  Ordnung 

EIMBA  (-40):  Falsche  Speicherblockadresse  (nicht  mit  “MallocQ”  re- 

serviert...) 


Bemerkungen 

In  den  aktuell  vorliegenden  GEMDOS-Versionen  wird  nicht  iiberpriift,  ob  der  Speicherblock 
dem  betreffenden  ProzeB  selbst  gehort.  Daher  kann  man  theoretisch  auch  von  anderen  Prozes- 
sen  reservierte  Speicherbereiche  freigeben.  In  Hinblick  auf  kiinftige  multitaskingfahige  TOS- 
Versionen  ist  dies  aber  sicherlich  keine  gute  Idee! 
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Mshrink  (GEMDOS  74)  -  Shrink  size  of  allocated  block 


Verkiirzt  einen  dureh  “MallocO”  reservierten  Speicherbereich. 

Deklaration  in  C: 

WORD  Mshrink  (void  *block,  LONG  newsize) ; 

Aufruf  in  Assembler: 

move.l  newsize,- (sp) 
pea  block 

move.w  #0,-(sp) 

move.w  #$4A, -(sp) 

trap  #1 

lea  $C(sp),sp 

Parameter: 

newsize:  Neue  (verkiirzte)  Lange  des  Speicherblocks 

block:  Anfangsadresse  des  zu  verkiirzenden  Speicherblocks 

MshrinkO:  einige  mogliche  Return- Werte: 

OK  (0):  alles  in  Ordnung 

EIMBA  (-40):  falsche  Blockadresse 

EGSBF  (-67):  Speicherblock  wiirde  vergroBert 

Bemerkungen 

tlblicherweise  wird  beim  C-Binding  (zum  Beispiel  in  “osbind.h”)  der  Nullparameter  automa- 
tisch  hinzugefiigt,  so  dafi  man  ihn  beim  Aufruf  weglassen  muB! 


;  Offset  8 
;  Offset  4 

;  Offset  2;  siehe  Anmerkung 
;  Offset  0 
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Mxalloc  (GEMDOS  68)  -  Allocate  memory  (with  preference) 


Dieser  Aufruf  entspricht  “MallocO”  (und  existiert  ab  GEMDOS  0. 1 9).  Der  einzige  zusatzliche 
Parameter  erlaubt  die  Auswahl  zwischen  den  beiden  verschiedenen  RAM-Arten  (siehe 
GEMDOS-Einfiihrung): 


Modus 

Bedeutung 

0 

nur  aus  dem  ST-RAM 

1 

nur  aus  dem  Alternate  RAM 

2 

egal,  aber  lieber  aus  dem  ST-RAM 

3 

egal,  aber  lieber  aus  dem  Alternate  RAM 

In  Modus  0  und  1  wird  versucht,  einen  Block  des  verlangten  Speichertyps  zu  allozieren.  Wenn 
dazu  nicht  genug  Speicher  da  ist,  geht  die  Anforderung  schief.  In  Modus  2  und  3  wird  erst  unter 
den  freien  Blocken  des  angegebenen  Typs  gesucht,  ansonsten  aber  auf  die  andere  Speicherart 
ausgewichen.  Je  nach  Einstellung  im  Programmkopf  (siehe  Erlauterungen  zu  “ph_prgflags” 
in  der  GEMDOS-Einfiihrung)  werden  “Malloc()”-Anforderungen  als  “Mxalloc  (0,...)”  (wenn 
kein  Alternate  RAM  angefordert  werden  darf)  oder  “Mxalloc  (3...)”  (sonst)  ausgefuhrt.  Auch 
die  Speicherplatzabffage  (mit  -1L  als  “Lange”)  erlangt  dadurch  eine  neue  Bedeutung:  in  den 
Modi  0  und  1  wird  der  groBte  Block  der  entsprechenden  RAM- Art  zuriickgeliefert.  Die  beiden 
anderen  Modi  sind  logischerweise  indiesem  Zusammenhang  identisch  und  liefem  den  groBten 
Block  ungeachtet  des  Typus  zuriick. 


Deklaration  in  C: 

void  *Mxalloc  (LONG  amount,  WORD  mode) ; 


Aufruf  in  Assembler: 

move.w  mode,-(sp)  ;  Offset  6 

move.l  amount, -(sp)  ;  Offset  2 

move.w  #$44,- (sp)  ;  Offset  0 

trap  #1 

addq.l  #8,sp 

Parameter: 

amount:  siehe  “MallocO” 

mode:  siehe  oben 

MxallocQ:  siehe  “MallocO” 
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Pexec  (GEMDOS  75)  -  Load/Execute  Process 


Ermoglieht  das  Laden  und  S tarten  von  Programmen,  ohne  dali  das  aktuelle  Programm  aus  dem 
Speicher  entfemt  wird.  So  geladene  Programme  werden  von  den  AES  nicht  als  separate 
Applikationen  angesehen! 


Deklaration  in  C: 

LONG  Pexec  (WORD  mode,  const  char  *file,  const  char  *cmdlin, 
const  char  *env) ; 


Aufruf  in  Assembler: 


pea 

env 

;  Offset 

pea 

cmdlin 

;  Offset 

pea 

file 

;  Offset 

move . w 

mode,  -  (sp) 

;  Offset 

move . w 

#$4B,-(sp) 

;  Offset 

trap 

#1 

lea 

$10 (sp) , sp 

Parameter: 

file:  Name  der  Programmdatei 

cmdlin:  Kommandozeile  fur  das  Programm  als  Pascal-String:  im  ersten  Byte  steht  die 

Lange  der  Kommandozeile,  die  erst  ab  dem  zweiten  Byte  folgt.  Die 
Maximallange  fiir  die  Kommandozeile  betragt  124  Zeichen  -  mit  Hilfe  des 
ARGV-Verfahrens  kann  man  auch  mehr  Informationen  iibergeben. 

env :  Zeiger  auf  das  Environment.  Ent weder  0  -  dann  legt  GEMDOS  eine  Kopie  des 

aktuellen  Environments  an  -  oder  ein  Zeiger  auf  das  zu  iibergebende 
Environment. 


Hier  die  verschiedenen  Modi  (keine  Sorge,  im  allgemeinen  ist  nur  Modus  0  von  Interesse!): 

LOAD  AND  GO 


LONG  Pexec  (0,  const  char  *file,  const  char  *cmdlin, 
const  char  *env) ; 

Legt  Environment  und  Basepage  an,  ladt  und  reloziert  das  in  “file”  angegebene  Programm  und 
startet  es.  Der  Retum-Wert  ist  entweder  ein  negativer  32-Bit-Wert  (wenn  innerhalb  von 
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“PexecO”  ein  Fehler  aufgetreten  ist)  oder  ein  16-Bit-Wert  (der  Wert,  den  das  gestartete  Pro- 
gramm  mit  “Pterm()”5  “Ptermres()”  bzw,  “PtermOO”  zuriickgeliefert  hat). 

Bei  einem  Programmabsturz  werden  die  allseits  bekannten  Bomben  auf  dem  Bildschirm 
gemalt  und  der  Wert  OxOOOOFFFF  (-1  als  WORD)  zuriickgeliefert  (vor  GEMDOS  0.15:  0). 

Bei  einem  Programmabbruch  durch  CTRL-C  erhalt  man  OxOOOOFFEO  (also  -32  als  WORD) 
zuriick  (leider  ist  dies  augenscheinlich  nicht  offiziell  dokumentiert). 

Einige  mogliche  GEMDOS-Fehlermeldungen: 


EINVFN  (-32): 
EFILNF  (-33): 
ENSMEN  (-39): 
EPLFMT  (-66): 


Falsche  Funktionsnummer 
Programm  nicht  gefunden 
Nicht  geniigend  Speicher 
Keine  GEMDOS -Programmdatei 


LOAD,  DON’T  GO 


BASEPAGE  *Pexec  (3,  const  char  *file,  const  char  *cmdlin, 
const  char  *env) ; 

Dieser  Modus  wird  meist  zum  Starten  von  Overlays  oder  zum  Laden  von  Programmen  in  einen 
Debugger  benutzt. 

Er  entspricht  Modus  0,  mit  dem  Unterschied,  daB  das  Programm  nicht  sofort  gestartet  wird, 
sondem  statt  dessen  ein  Zeiger  auf  die  Basepage  zuriickgeliefert  wird. 

Wenn  der  so  geladene  ProzeB  mehr  als  einmal  gestartet  werden  soli,  mufi  man  folgende 
Probleme  beachten: 


-  Das  Programm  darf  weder  Text-  noch  Datensegment  verandem  (im  Zweifelsfall  sollte 
man  gleich  zu  Beginn  eine  Kopie  des  Datensegments  anlegen  und  vor  jedem  Start  in  das 
eigentliche  Programm  kopieren). 

-  Das  BSS-Segment  muB  vor  jedem  Start  geloseht  werden. 

-  Der  Zustand  der  Standardkanale  (Ein-/Ausgabeumlenkung)  wird  bereits  bei  diesem 
Aufruf  (und  nicht  erst  beim  eigentlichen  Start)  vererbt. 

Daher  diirfen  sie  sich  vor  dem  eigentlichen  Aufruf  mit  Modus  4  oder  6  nicht  mehr 
verandem  (und  natiirlich  auch  nicht  zwischen  den  Auffufen). 
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JUST  GO 

LONG  Pexec  (4,  OL,  BASEPAGE  *basepage,  OL) ; 

Startet  ein  bereits  geladenes  Programm.  Die  Basepage  soilte  mit  Modus  3  oder  5  erzeugt 
worden  sein.  Der  Retumwert  entspricht  dem  von  Modus  0. 

Dieser  Modus  hat  ein  sch  werwiegendes  Problem:  durch  einen  Fehler  im  GEMDOS  bleibt  der 
aufrufende  ProzeB  Besitzer  des  durch  Environment  und  TPA  belegten  Speichers.  Die  Folge: 
nach  Ruckkehr  aus  dem  ProzeB  muB  man  selbst  fUr  die  Freigabe  sorgen: 

void  FreeForMode4  (BASEPAGE  *child) 

{ 

Mfree  (child->p_env) ; 

Mfree  (child) ; 

} 

CREATE  BASEPAGE 

BASEPAGE  *Pexec  (5,  OL,  const  char  *cmdlin,  const  char  *env) ; 

Zunachst  legt  GEMDOS  ein  neues  Environment  an.  Dann  wird  der  grofite  zusammenhangen- 
de  Speicherblock  alloziert  und  in  den  ersten  256  Bytes  eine  Basepage  angelegt.  Start  und 
Lange  der  einzelnen  Programmsegmente  werden  noch  nicht  eingetragen  (wie  auch?).  Fur 
diesen  Modus  gibt  es  mehrere  sinnvolle  An  wendungen:  einmal  kann  man  das  Programm  selbst 
laden,  relozieren  und  die  fehlenden  Werte  in  der  Basepage  eintragen. 

Dazu  ein  Beispiel: 

typedef  struct 
{ 

LONG  offset;  /*  Offset  zum  ersten  zu  relozierenden  Wert  */ 

BYTE  info[];  /*  Byte-Tabelle  */ 

}  RELOC1NPO; 

BASEPAGE  *P; 

PH  *Image;  /*  Zeiger  auf  geladenes  Programm  */ 

LONG  ProgSize;  /*  Lange  der  Programmdatei  */ 

RELOCINFO  *reloc;  /*  Zeiger  auf  Relozierungsinformationen  */ 

LONG  *toreloc; 

BYTE  *info; 
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P  =  (BASEPAGE  *)P exec  (5,  OL,  OL)  ; 

/*  Programm  in  neue  TPA  kopieren  */ 

memcpy  ((void  *)  ((long)P  +  sizeof (BASPAG) ) , 

(void  *)  ( (long) Image  +  sizeof (PH) ) ,  ProgSize  -  sizeof  (PH) ) ; 

/*  Basepage-Zeiger  eintragen  */ 

P->p_tbase  =  ((void  *)  ((long)P  +  sizeof (BASEPAGE) )) ; 

P->p__dbase  =  ((void*)  ( (long)P->p_tbase  +  (long)  Image- >ph_tlen) )  ; 
P->p_bbase  =  ((void  *)  ( (long)P->p__dbase  +  (long) Image->ph_dlen) ) ; 
P->p_tlen  =  Image ~>ph_tlen; 

P~>P__dlen  =  Image->ph_dlen; 

P->p_blen  =  Image->ph_blen; 

P->p_dta  =  (DTA  *)  &  (P->p_cradlin)  ; 

/*  und  relozieren. . .  */ 

reloc  =  (RELOCINFO  *) P->p_bbase; 

toreloc  =  (long  *)  ( (long) P->p__tbase  +  reloc->offset) ; 
info  =  reloc->info; 

*toreloc  +=  (long)P->p_tbase; 

while  (*info) 

( 

BYTE  offset; 
offset  =  *info++; 
if  (offset  ==  1) 

toreloc  =  (long  *)  ( (long) toreloc  +  254L) ; 

else 

{ 

toreloc  =  (long  *)  ( (long) toreloc  +  (long) offset) ; 
*toreloc  +=  (long)P->p_tbase; 


) 

/*  und  starten...  */ 


Pexec  (4,  OL,  P,  OL) ; 
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Auch  zum  Starten  eines  Programms  im  ROM  kann  Modus  5  benutzt  werden  (genauso  wird 
auch  GEM  gestartet).  Dabei  sollte  man  allerdings  nicht  vergessen,  daB  fur  die  TPA  der  groBte 
verfugbare  Speicherblock  alloziert  wird.  Sollte  dies  ein  Problem  sein  (zum  Beispiel  well  das 
zu  startende  Programm  keinen  “MshrinkO”  macht),  dann  mull  man  selbst  “MshrinkO”  benut- 
zen  und  den  Zeiger  auf  das  TPA-Ende  entsprechend  korrigieren. 

JUST  GO,  THEN  FREE  -  ab  GEMDOS  0.15 

LONG  Pexec  (6,  0L,  BASEPAGE  *basepage,  OL) ; 

Entspricht  Modus  4,  mit  dem  entscheidenden  Unterschied,  daft  allozierter  Speicher  dem 
gestarteten  ProzcB  und  nicht  dem  Starter  gehort.  Zusammen  mit  Modus  3  kann  man  also  den 
gleichen  Effekt  wie  durch  Modus  0  erreiehen. 

CREATE  BASEPAGE,  RESPECTING  PRGFLAGS  -  ab  GEMDOS  0.19 

LONG  Pexec  (7,  LONG  prgflags,  const  char  *cmdlin,  const  char  *env) ; 

Wie  Modus  5,  nur  kann  in  “prgflags”  die  gleiche  Information  wie  im  Feld  “ph_prgflags”  des 
Programmkopfs  iibergeben  werden.  Dieser  Modus  wird  vom  BIOS  des  TT  benutzt,  um  GEM 
zu  starten  (GEM  erhalt dabei  die  “Erlaubnis”,  Speicher  aus  dem  Alternate  RAM  zu  allozieren). 

Pexec()  von  innen 

Um  zu  verstehen,  warum  die  verschiedenen  Modi  so  und  nicht  anders  funktionieren,  ist 
folgende  Ubersicht  des  Ablaufs  eines  Programmstarts  via  Modus  0  niitzlich: 

1 .  Programmdatei  finden. 

2.  Environment,  TPA  und  Basepage  anlegen: 

2a.  Es  wird  Plate  fiir  das  Environment  angelegt  und  dieses  vom  Aufrufer  kopiert  (entweder 
dessen  eigenes  oder  das  als  Parameter  ubergebene). 

2b.  Der  groBte  verfiigbare  Speicherblock  wird  belegt  und  zur  TPA  des  neuen  Prozesses. 

2c,  In  den  ersten  256  Bytes  der  TPA  werden  erste  Teile  der  Basepage  initialisiert  (TPA-, 
DTA-  und  Environmentzeiger). 

2d.  Dateikennungen,  aktuelles  Laufwerk  und  aktuelle  Verzeichnisse  werden  vom  Aufrufer 
vererbt  und  in  die  Basepage  eingetragen. 
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2e.  Die  Kommandozeile  wird  in  die  Basepage  kopiert. 

3.  Der  neue  ProzeB  wird  “Besitzer”  des  Environments  und  der  TPA. 

4.  Die  Programmdatei  wird  geladen  und  reloziert  und  die  Zeiger  auf  die  Programmsegmente 
in  der  Basepage  eingetragen. 

5.  Das  Programm  wird  gestartet: 

5a.  Der  Basepagezeiger  “p_parent”  wird  gesetzt. 

5b.  Am  Ende  der  TPA  wird  ein  Stack  eingerichtet  und  dort  die  Basepageadresse  abgelegt. 
5c.  Der  neuerzeugte  ProzeB  wird  zum  aktuellen  ProzeB. 

5d.  Der  ProzeB  wird  gestartet. 

Vorsicht :  Diese  Information  gilt  nicht  unbedingt  fiir  kunftige  GEMDOS-Versionen! 

"LOAD,  DON’T  GO”  (Modus  3)  macht  die  Arbeitsschritte  1,  2  und  4.  Da  Schritt  3  iiber- 
sprungen  wurde,  gehort  der  allozierte  Speicher  weiterhin  dem  Aufrufer. 

“JUST  GO”  (Modus  4)  fiihrt  nur  Schritt  5  aus.  Da  Schritt  3  vergessen  wurde,  gehoren  Environ¬ 
ment  und  TPA  weiterhin  dem  aufrufenden  ProzeB.  Alle  weiteren  Speicheranforderungen 
werden  dartn  jedoch  richtig  bearbeitet. 

“CREATE  BASEPAGE”  (Modus  5)  fiihrt  einzig  und  allein  Schritt  2  aus. 

“JUST  GO,  THEN  FREE”  (Modus  6)  macht  die  Arbeitsschritte  3  und  5.  Daher  treten  die  Pro- 
bleme  von  Modus  4  nicht  auf. 

“CREATE  BASEPAGE,  RESPECTING  PRGFLAGS”  entspricht  Modus  5,  nur  werden  zu- 
satzlich  die  Programmflags  aus  dem  ersten  Parameter  beachtet. 

Soweit  die  Erklarungen  zu  den  einzelnen  Modi.  DaB  der  am  haufigsten  benotigte  Modus 
(einfach  nur  ein  Programm  laden  und  starten)  problemlos  funktioniert,  haben  wir  auch  ge- 
sehen. 

Wie  steht  es  aber  mit  diffizileren  Wunschen? 


Problem:  Programm  laden,  modifzieren  und  einmal  starten. 
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Dies  ist  eine  typische  Aufgabe  fur  einen  Debugger:  das  zu  untersuchende  Programm  wird 
zunachst  geladen  und  dann  modifiziert,  etwa  durch  Setzen  eines  Breakpunkts.  AnschlieBcnd 
soil  es  genau  einmal  gestartet  werden. 

Losung-.  Mit  Modus  3  (LOAD,  DON’T  GO)  laden  und  dann  spater  mit  Modus  6  “JUST  GO, 
THEN  FREE”  starten.  Auf  GEMDOS-Versionen  vor  0.15  kann  man  sich  auch  mit  Modus  4 
(JUST  GO)  behelfen,  wenn  man  sich  abschlieBend  selbst  um  die  Freigabe  von  Environment 
und  TPA  kiimmert. 

Problem :  Programm  laden  und  dann  mehrfach  starten. 

Gerade  fur  eine  Shell  ware  ein  solches  Verfahren  interessant:  hiiufig  benutzte  Module  werden 
nur  einmal  geladen  und  konnen  dann  imrner  wieder  aufs  neue  aktiviert  werden  ( wobei  sich 
die  Frage  stellt,  wie  wichtig  dies  heutzutage  angesichts  der  hohen  Festplattenkapazitiiten  und 
-geschwindigkeiten  noch  ist). 

In  diesem  Fall  wiirde  es  sich  anbieten,  das  Programm  wieder  mit  Modus  3  (LOAD,  DON’T 
GO)  einzulesen  und  sich  dann  den  Fehler  in  Modus  4  zunutze  zu  machen.  Probleme  sind  dabei 
jedoch  vorprogrammiert,  einige  haben  wir  bereits  bei  der  Erklarung  von  Modus  3  genannt. 

Die  Idee,  die  Basepage  nur  einmal  zu  erzeugen  und  dann  den  ProzeB  mehrmals  zu  aktivieren, 
fiihrt  aber  noch  zu  weiteren  Schwierigkeiten.  So  wird  der  aufgerufene  ProzeB  vermutlich  beim 
ersten  Programmstart  mit  “MshrinkO”  den  nicht  benotigten  Teil  seiner  TPA  freigeben.  Beim 
nachsten  Ausfiihren  legt  GEMDOS  jedoch  den  Stack  wieder  an  der  gleichen  Adresse  an  - 
diesmal  im  “Niemandsland”  des  Speichers,  denn  dieser  Abschnitt  kann  ja  liingst  fur  andere 
Zwecke  vergeben  worden  sein.  Irgend  jemand  miiBte  also  dafiir  sorgen,  daB  der  Zeiger 
“p  hitpa”  in  der  Basepage  auf  das  neue  Ende  der  TPA  gesetzt  wird. 

Der  Aufrufer  ist  damit  allerdings  iiberfordert  —  er  weiB  ja  nicht,  wie  viele  Bytes  der  TPA  der 
geladene  ProzeB  behalten  hat.  Der  aufgerufene  ProzeB  konnte  das  tun  —  nur  miiBte  man  ihn 
dafiir  speziell  anpassen,  und  das  ist  im  allgemeinen  mangels  Quelltext  nicht  moglich. 

Doch  es  gibt  eine  Losung,  die  auch  noch  andere  Probleme  lost  (auf  die  wir  gleich  noch  zu  spre- 
chen  koinmen): 

A.  Programm  einfach  mit  “Fopen()-Fread()-Fclose()”  in  den  Speicher  laden. 

B.  Basepage  mit  Pexec-Modus  5  (CREATE  BASEPAGE)  erzeugen. 

C.  Text-  und  Datensegment  in  die  TPA  kopieren,  relozieren  und  fehlende  Basepagezeiger 
setzen. 
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D.  BSS  loschen, 

E.  Programm  mittels  Modus  4  bzw.  6  ausftihren. 

Zur  nochmaligen  Ausfiihrung  konnen  einfach  die  Schritte  B  bis  E  wiederholt  werden.  Eine 
Beispielfunktion  zum  Anlegen  der  Basepage  sowie  zum  Relozieren  und  Starten  des  Pro- 
gramms  haben  wir  bei  den  Erkliirungen  zu  Modus  5  angegeben.  Einziger  Schonheitsfehler: 
zum  Zeitpunkt  der  Programmausfiihrung  liegen  Textsegnient  und  Datensegment  doppelt  im 
Speicher,  was  natiirlich  bei  langen  Programmen  nicht  wiinschenswert  ist.  Fiir  Programme,  die 
nicht  darauf  angewiesen  sind,  dal.i  sie  alle  drei  Programm  segmente  in  einem  Stiick  vorfinden, 
gibt  es  eine  elegantere  Losung: 

A.  Programm  einfach  mit  “Fopen()-Fread()-Fclose()”  in  den  Speicher  laden. 

B.  Programmcode  doit,  wo  er  steht,  relozieren. 

C.  Basepage  mit  Pexec-Modus  5  (CREATE  BASEPAGE)  erzeugen. 

D.  Zeiger  auf  Programm-  und  Datensegment  in  Basepage  eintragen. 

E.  BSS  loschen. 

F.  Programm  mittels  Modus  4  bzw.  6  ausfiihren. 

Durch  Wiederholung  von  Schritt  C  bis  F  kann  man  das  Programm  dann  “beliebig”  oft  starten. 

Kommen  wir  schlieGlich  zu  dem  anderen  Problem,  das  die  Idee  “einmal  mit  Modus  3  laden 
und  imnrer  wieder  mit  Modus  4  starten”  zunichte  macht.  GEMDOS  merkt  sich  bekanntlich 
in  der  Basepage  einige  Informationen,  die  beim  Nachstarten  von  Prozessen  “vererbt”  werden. 
Dazu  gehoren  beispielsweise  die  Zuordnungen  der  Standardkanale  und  die  aktuellen  Ver- 
zeichnisse. 

Wie  man  sich  denken  kann,  stehen  in  der  Basepage  nicht  die  eigentlichen  Informationen, 
sondem  nur  Verweise  auf  GEMDOS-inteme  Strukturen.  Nehmen  wir  die  Standardkanale  als 
Beispiel.  Wenn  sie  auf  eine  “echte”  Datei  umgelenkt  worden  sind,  enthalt  die  Basepage  einen 
Verweis  auf  einen  Dateikontrollblock  im  Innem  des  GEMDOS. 

Fiir  jeden  Dateikontrollblock  merkt  sich  GEMDOS  in  einem  Zahler,  wie  “oft”  die  Datei 
tatsachlich  geoffnet  ist  (fachenglisch:  “usage  count”).  Diese  Information  wird  benotigt.  damit 
GEMDOS  weiB,  wie  oft  die  Datei  geschlossen  werden  muB,  bevor  der  Dateikontrollblock 
wieder  freigegeben  werden  kann. 
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Die  Vererbung  dieser  Informationen  (und  damit  die  Erhohung  der  Zahler)  findet  in  Schritt  2 
des  Pexec-Vorgangs  statt.  Beim  Terminieren  des  Prozesses  werden  analog  dazu  die  Zahler 
wieder  vermindert. 

Und  da  haben  (bzw .  hatten)  wir  den  Salat:  die  Zahler  werden  nur  einmal  erhoht,  aber  mehrfach 
vermindert.  Die  Folge  ware,  daB  GEMDOS-inteme  Strukturen  freigegeben  wiirden,  obwohl 
sie  noch  an  anderer  Stelle  benotigt  wiirden.  Abstiirze  oder  Systemhalt  (“Out  of  internal 
memory'...”)  waren  dann  vorhersehbar. 

Aktuelle  GEMDOS-Versionen  (bis  einschlieBlich  0.19)  gehen  also  falschlicherwei.se  davon 
aus,  daB  jedes  einmal  geladene  Programm  auch  genau  einmal  ausgefiihrt  wird.  Die  Vererbung 
wird  mithin  zu  friih  gemacht  -  eigentlich  sollte  sie  erst  beim  tatsachlichen  Start  des  Programms 
vorgenommen  werden  (in  Schritt  5  des  Pexec-Vorgangs). 

Dies  setzt  voraus,  daB  jedes  gestartete  Programm  friiher  oder  spater  auch  beendet  wird  (sicher- 
lich  eine  vemiinftige  Annahme).  Atari  hat  angekiindigt,  daB  kiinftige  GEMDOS-Versionen 
exakt  so  arbeiten  werden. 

Bemerkungen 

In  alteren  GEMDOS-Versionen  (mindestens  einschlieBlich  0.15)  passieren  unschone  Dinge, 
wenn  wahrend  des  Ladens  der  Programmdatei  BIOS-Error  (etwa  defekte  Sektoren)  auftreten: 
zum  Beispiel  kann  es  leicht  passieren,  daB  die  Datei  nicht  wieder  geschlossen  wird  und  damit 
die  Dateikennung  verlorengeht. 
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PtermO  (GEMDOS  0)  -  Terminate  Process 

1st  identisch  mit  “Pterm(O)”. 

Declaration  in  C: 

void  PtermO  (void) ; 

Aufruf  in  Assembler: 

clr.w  -(sp)  ;  Offset  0 

trap  #1 
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Pterm  (GEMDOS  76)  -  Terminate  process 


Der  laufende  ProzeB  wird  beendet  und  aus  dem  Speicher  entfernt.  Dem  aufrufenden 
Programm  wird  der  angegebene  Wert  als  Return-Status  zuruckgemeldet.  Das  kann  eine 
normale  GEMDOS-Fehlenneldung  oder  auch  ein  selbstdefinierter  Fehler-Code  sein. 

Alle  offenen  Dateien  (auch  die  Standardkanale)  w-erden  geschlossen,  und  mittels  “MallocO” 
oder  “Mxalloc()”wird  reservierter  Speicher  freigegeben.  Bei  Megas  und  TTs  wird  die  Uhrzeit 
aus  der  Hardware-Uhr  in  die  Systemuhr  iibertragen.  AuBerdem  wird  ein  Sprung  durch 
“etv_term”  durchgefiihrt. 


Deklaration  in  C: 

void  Pterm  (WORD  retcode) ; 


Aufruf  in  Assembler: 

move . w  retcode, - (sp)  ;  Offset  2 

move.w  #$4C,-(sp)  ;  Offset  0 

trap  #1 

Parameter: 

retcode:  Status,  der  an  das  aufrufende  Programm  zuriickgegeben  wird.  Gebrauchliche 

Return-Werte  sind: 

0:  alles  in  Ordnung 

1 :  allgemeine  Fehlermeldung 

2:  Fehler  in  den  iibergebenen  Parametem 

- 1 :  sollte  man  nicht  selbst  benutzen,  da  dieser  Wert  ab  GEMDOS  0. 15  bei 

einem  Programmabsturz  zuriickgeliefert  wird 
-32:  sollte  man  auch  nicht  selbst  benutzen,  da  man  diesen  Wert  bei  mit 

<CtrlxC>abgebrochenen  Programmen  erhalt 
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Ptermres  (GEMDOS  49)  -  Terminate  and  stay  resident 


Der  laufende  ProzeG  wird  beendet.  Dabei  kann  man  eine  beliebige  Anzahl  von  Bytes  resident 
im  Speicher  halten  (gerechnet  ab  Anfangsadresse  der  Basepage). 

Ebensowenig  werden  die  mittels  “MallocO”  oder  “MxallocO”  allozierten  Speicherbereiche 
freigegeben:  im  Gegenteil  -  sie  werden  vollstandig  aus  der  GEMDOS-Speicherliste  entfemt 
und  konnen  nie  wieder  per  GEMDOS  benutzt  werden  (auBer,  man  hangt  sie  wieder  mittels 
“MaddaltO”  in  die  Speicherverwaltung  ein). 


Deklaration  in  C: 

void  Ptermres  (ULONG  keep,  WORD  ret); 


Aufruf  in  Assembler: 

move.w  ret,-(sp) 
move.l  keep,-(sp) 

move.w  #$31,- (sp) 

trap  #1 


;  Offset  6 
;  Offset  2 
;  Offset  0 


Parameter: 

keep:  Anzahl  der  resident  zu  haltenden  Bytes  (ab  Anfang  der  Basepage,  mindestens  128 
Bytes) 

ret:  Status,  der  an  das  aufrufende  Programm  zuriickgegeben  wird.  Gebrauchliche  Retum- 

Werte  sind: 

0:  alles  in  Ordnung 

1:  allgemeine  Fehlermeldung 

2:  Fehler  in  den  iibergebenen  Parametem 

-1 :  sollte  man  nicht  selbst  benutzen,  da  dieser  Wert  ab  GEMDOS  0. 15  bei  einem 

Programmabsturz  zuriickgeliefert  wird 

-32:  sollte  man  auch  nicht  selbst  benutzen,  da  man  diesen  Wert  bei  mit  CtrlxC> 
abgebrochenen  Programmen  erhalt 
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Super  (GEMDOS  32)  -  Get/Set/Inquire  supervisor  mode 


Schaltet  zwischen  User-  and  Supervisor-Modus  hin  und  her  und  liefert  Funktionen  iiber  den 
momentanen  Prozessorstatus. 


Deklaration  in  C: 

LONG  Super  (void  *stack) ; 


Aufruf  in  Assembler: 


pea 

move . w 
trap 
addq . 1 


stack 
#$20, - (sp) 
#1 

#6,  sp 


;  Offset  2 
;  Offset  0 


Parameter: 

stack:  1:  Es  wird  der  momentane  Prozessorstatus  (0  =  User-Modus,  -1  =  Supervisor- 

Modus)  zuriickgegeben. 

0:  1st  der  Prozessor  im  User-Modus,  dann  wird  er  in  den  Supervisor-Modus 

geschaltet  und  als  SSP  (Supervisor  Stack  Pointer)  der  bisherige  USP  (User 
Stack  Pointer)  benutzt.  Zuriickgeliefert  wird  der  bisherige  SSP.  War  der  Pro¬ 
zessor  zuvor  im  Supervisor-Modus,  wird  nichts  Vemtinftiges  zuriickgeliefert. 

>1 :  Der  Prozessor-Modus  wird  umgeschaltet.  Der  Funktionswert  ist  der  bisherige 

Wert  des  SSP.  “stack”  wird  neuer  aktueller  Stack-Pointer.  In  diesem  Fall  sollte 
man  logischerweise  auf  die  anschlieBende  Stack-Korrektur  verzichten! 

Bemerkungen 

Zur  Klarung:  Man  schaltet  beispielsweise  mittels  “suret  =  Super  (0L)”  in  den  Supervisor- 
Modus.  Am  Ende  des  Programmteils  schaltet  man  dann  mit  “Super  (  suret)”  in  den  User-Modus 
zuriick. 
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Sversion  (GEMDOS  48)  -  Get  version  number 


Liefert  Versionsnummer  vom  GEMDOS.  Folgende  GEMDOS-Versionen  sind  zur  Zeit 
bekannt: 

0.13  (0x1300) 

Dieses  GEMDOS  befindet  sich  in  TOS  1.00  und  TOS  1 .02  (“Blitter”-TOS).  Es  zeichnet  sich 
durch  zahllose  Fehler  bei  der  Umlenkung  der  Standardkanale  und  durch  sehr  maBige 
Arbeitsgeschwindigkeit  auf  Festplatten  aus. 

0.14  ( 0x1400 ) 

Diese  Versionsnummer  trug  das  franzosische  “Turbo-DOS",  das  fiir  kurze  Zeit  mit  Atari- 
Festplatten  ausgeliefert  wurde.  Es  war  sehnell  und  unsicher. 

0.15  (0x1500) 

Dieses  GEMDOS  befindet  sich  in  TOS  1.04  und  TOS  1 .06.  Es  ist  weitestgehend  stabil  und 
sehnell.  Ein  bekannter  Bug  wird  durch  das  offizielle  Patchprogramm  “POOLFIX3.PRG” 
behoben. 

0.17(0x1700) 

1st  in  TOS  1 .62  zu  finden  und  unterscheidet  sich  von  0.1 5  nur  dadurch,  daB  das  Programm 
“POOLFIX3.PRG”  nicht  mehr  benotigt  wird. 

0.19  (0x1900) 

Dieses  GEMDOS  tauchte  erstmals  im  TOS  3.01  des  TT  auf.  Es  wurde  in  erster  Linie  um 
Funktionen  zur  Verwaltung  der  unterschiedlichen  RAM-Arten  erweitert. 


Deklaration  in  C: 

WORD  Sversion  (void) ; 


Aufruf  in  Assembler: 

move.w  #$30, -(sp)  ;  Offset  0 

trap  #1 

addq .1  #2 ,  sp 

Parameter: 

Sversion():  Low-Byte:  Haupt-Revision 
High-Byte:  Unter-Revision 
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Tgetdate  (GEMDOS  42)  -  Get  date 


Das  Systemdatum  (GEMDOS-intem)  wird  abgefragt.  Dabei  handelt  es  sich  um  einen 
einfachen  Zahler,  der  bei  Systemstart  initialisiert  wird  -  ab  TOS  1.02  bei  Rechnem  mit 
Hardware-Uhr  mit  der  aktuellen  Uhrzeit,  sonst  mit  dem  TOS-Erstellungsdatum  (siehe 
“_sysbase”). 

Bei  Rechnem  mit  Hardware-Uhr  und  ab  TOS  1 .02  wird  zusatzlich  bei  jeder  Beendigung  ernes 
GEMDOS-Prozesses  die  Zeit  mit  Hilfe  der  Hardware-Uhr  aktualisiert. 

Auf  Rechnem  ohne  Hardware-Uhr  kann  man  beim  Reset  die  GEMDOS-Uhrzeit  retten,  indem 
man  die  Zeit  mittels  der  XBIOS-Funktionen  ausliest  und  in  die  GEMDOS-Uhr  iibertragt. 

Deklaration  in  C: 

UWORD  Tgetdate  (void) ; 

Aufruf  in  Assembler: 

move.w  #$2A, -(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 


Parameter: 

Tgetdate():  Aktuelles  Damm 

Bit  0..4:  Tag  (0..31) 

Bit  5. .8:  Monat(1..12) 

Bit  9. .15:  Jahre  seit  1980  (0..1 19) 
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Tgettime  (GEMDOS  44)  -  Get  time 


Fragt  die  Systemzeit  der  GEMDOS-intemen  Uhr  ab  (siehe  auch  “TgetdateQ”). 

Deklaration  in  C: 

UWORD  Tgettime  (void) ; 


Aufruf  in  Assembler: 

move.w  #$2C,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #2,sp 

Parameter: 

Tgettime():  Aktuelle  Uhrzeit 

Bit  0..4:  Sekunden  (0..29)  -  muB  verdoppelt  werden 

Bit  5.. 10:  Minuten  (0..59) 

Bit  11. .15:  Stunden  (0..23) 
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Tsetdate  (GEMDOS  43)  -  Set  date 


Setzt  das  Systemdatum  in  der  GEMDOS-Uhr  (ab  TOS  1 .02  auch  in  der  jeweiligen  Hardware- 
Uhr). 

Deklaration  in  C: 

WORD  Tsetdate  (UWORD  date) ; 


Aufruf  in  Assembler: 

move.w  date,-(sp) 

move.w  #$2B, -(sp) 

trap  #1 

addq.l  #4,sp 


;  Offset  2 
;  Offset  0 


Parameter: 

date:  aktuelles  Datum  (siehe  unter  “TgetdateO”) 

Tsetdate():  -1:  Das  war  kein  giiltiges  Datum 

(0<=Tag<=31,  l<=Monat<=12,  0<=Jahr<=l  19)! 
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Tsettime  (GEMDOS  45)  -  Set  time 


Setzt  die  aktuelle  Systemzeit  in  der  GEMDOS-Uhr  (ab  TOS  1 .02  auch  in  der  jeweiligen  Hard- 
ware-Uhr). 

Deklaration  in  C: 

WORD  Tsettime  (UWORD  time) ; 


Aufruf  in  Assembler: 

move.w  time,-(sp)  ;  Offset  2 

move.w  #$2D,-(sp)  ;  Offset  0 

trap  #1 

addq.l  #4,sp 

Parameter: 

time:  Uhrzeit  (siehe  “TgettimeO”) 

Tsettime():  1:  Das  war  keine  giiltige  Uhrzeit 

(0<=Sekunden<=29,  0<=Minuten<=59,  0<=Stunden<=23)! 
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Einleitung 

Das  VDI  (“Virtual  Device  Interface”)  bildet  die  “untere”  Halfte  von  GEM.  Genauso  wie  das 
BIOS  den  Unterbau  fur  alle  Funktionen  des  GEMDOS  bereitstellt,  ist  das  VDI  Grundlage  fur 
alle  AES-Funktionen.  Dazu  bedient  es  sich  aller  tieferliegenden  Betriebssystemschichten 
(BIOS,  XBIOS  bis  GEMDOS)  und  greift  innerhalb  der  gerStespezifischen  Teile  naturgemaB 
auch  direkt  auf  die  Hardware  zu. 

Auch  wenn  man  mitdern  VDI  normalerweiseprimar  Funktionen  zur  Grafikausgabe  verbindet, 
erstreckt  sich  der  Aufgabenbereich  auch  auf  Eingaben  (wie  zum  Beispiel  per  Maus  oder 
Grafiktablett).  Das  VDI  ist  also  eine  Betriebssystemschicht  zur  Ansteuerung  von  im  weitesten 
Sinn  grafikorientierten  Aus-  und  Eingabegeraten. 

Ebensowenig  sollte  man  das  Wortchen  “Virtual”  iibersehen.  Fur  das  Anwenderprogramm 
bedeutet  dies,  dad  (fast)  alle  Funktionsaufrufe  auf  jedes  verfugbare  Ausgabegerat  -  ob 
Bildschirm,  Plotter,  Drucker  oder  auch  Diabelichter  -  angewendet  werden  konnen. 

Zwei  kurze  Beispiele,  urn  die  Gerateunabhangigkeit  des  VDI  zu  verdeutlichen:  die  AES 
machen  ausschlieGlich  GEMDOS-  und  VDI-Aufrufe.  Daher  ist  es  moglich,  die  AES  ohne  jede 
Anderung  auch  auf  solchen  Grafikkarten  einzusetzen,  an  deren  Existenz  1984  ganzbestimmt 
noch  niemand  gedacht  hat,  zum  Beispiel:  1280  *  960  Bildpunkte  in  256  Farben. 

Gleiches  gilt  naturlich  fur  alle  sauber  programmierten  GEM-Anwendungen,  deren  Zahl  in 
den  letzten  Jahren  glucklicherweise  immer  starker  gewachsen  ist  (man  denke  an  "SciGraph”, 
“Script  2”,  “LDW-Power”,  “Turbo-C”  und  “Gemini”). 

Bei  Druckem  sieht  die  Lage  nicht  anders  aus:  ob  9-Nadeldrucker,  Tintenstrahldrucker  oder 
Laserdrucker  -  immer  kann  man  mit  den  gleichen  Betriebssystemfunktionen  Kreise  malen 
oder  Texte  ausgeben. 

Die  Wurzeln  des  VDI  liegen  im  CP/M-GSX-System,  das  Anfang  der  achtziger  Jahre  aus  dem 
Bedarf  fiir  eine  portable  Grafikschnittstelle  fiir  die  damals  dominierenden  CP/M-Systeme 
entstand  (nicht  vergessen:  CP/M  ~  das  erste  verbreitete  Betriebssystem  fur  Mikrocomputer, 
stammte  ebenfalls  von  Digital  Research). 


Ahnlichkeiten  in  Funktionen  und  Bezeichnungen  zum  GKS  (“Grafisches  Kern-System”)  sind 
keineswegs  zufallig,  sondem  von  den  Entwicklem  bei  Digital  Research  voll  beabsichtigt.  Das 
VDI  erfullt  den  ANSI-Standard  X3H3.6  CG-VDI! 
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Grundlagen  des  VDI 

Workstations 

Fast  alle  VDI-Funktionen  erwarten  als  Parameter  das  sogenannte  “Handle”  der  zu  benutzen- 
den  “Workstation”.  Die  Parallele  zu  den  vom  GEMDOS  vergebenen  Datei-Handles  kommt 
nicht  von  ungefahr,  denn  die  dahinterslehende  Idee  ist  eigentlich  gleich. 

Fine  der  vielen  Aufgaben  einer  Betriebssystemschicht  ist  es  schlieBlich,  den  Zugriff  auf  die 
Hardware-Ressourcen  des  Rechnersystems  zu  verwalten.  Genauso,  wie  zwei  Programme 
nicht  gleichzeitig  denselben  Speicherbereich  benutzen  Oder  in  dieselbe  Datei  schreiben  diir- 
fen,  konnen  auch  die  vom  VDI  verwalteten  Ein-  und  Ausgabegerate  nie  mehr  als  einem  “Kun- 
den”  gleichzeitig  zu  Verftigung  stehen.  Niemand  wiirde  erwarten,  daB  etwas  Sinnvolles  dabei 
herauskommt,  werm  zwei  Applikationen  gleichzeitig  Daten  an  den  Drucker  schicken  oder 
abwechselnd  Tastendriicke  auslesen. 

Die  Losung :  Wer  auf  ein  bestimmtes  VDI-Gerat  zugreifen  will,  muB  dazu  eine  Workstation 
offnen.  Je  nach  Sachlage  erhalt  man  als  Resultat  entweder  eine  Fehlermeldung  oder  die  Work- 
station-Kennung  (Handle)  des  betreffenden  Gerats.  AnschlieBend  darf  man  das  angesproche- 
ne  Gerat  nach  Herzenslaune  benutzen.  Hauptsache,  man  schlieBt  die  Workstation  am  Ende, 
um  sie  wieder  fur  andere  Programme  verfiigbar  zu  machen. 

Zu  jeder  Workstation  gehort  eine  Menge  von  Merkmalen,  die  unveranderlich  sind  und  iiber 
die  Fahigkeiten  des  Gerats  Auskunft  geben.  Dazu  gehoren  neben  vielen  anderen  Geratetyp, 
Koordinatensystem  und  Farbfahigkeit.  Neben  den  beim  Offhen  der  Workstation  zuriickgelie- 
ferten  Daten  kann  man  mit  einer  erweiterten  Auskunftsfunktion  noch  mehr  Daten  abrufen. 
Dieses  Informationsangcbot  macht  es  den  Anwendungsprogrammen  moglich,  die  FShigkei- 
ten  des  Gerats  optimal  zu  nutzen  -  zum  Beispiel  dadurch,  daB  sie  ihren  Bildschirmaufbau  an 
die  Anzahl  der  darstellbaren  Bildpunkte  anpassen. 

Daneben  gibt  es  auch  noch  veranderliche  Merkmale,  die  sogenannten  “Attribute”.  Sie 
beschreiben  den  aktuellen  Zustand  des  Gerats.  Ein  gutes  Beispiel  ist  die  Linienfarbe,  die  man 
nur  ein  einziges  Mai  -  und  nicht  etwa  bei  jedern  einzelnen  Aufruf  von  Zeichenfunktionen  - 
setzen  muB.  Die  aktuellen  Attribute  werden  vom  VDI  in  intemen  Strukturen  fiir  jede  einzelne 
Workstation  getrennt  gespeichert.  So  kann  eine  Application  unbesorgt  fiir  Bildschimi  und 
Plotter  getrennt  verschiedene  Linienfarben  einstellen  -  das  VDI  erkennt  jeweiis  am  Workstation- 
Handle,  wer  gemeint  ist. 

DerBildschirm  nimmtnatiirlich  eine  Sonderstellung  ein-er  mufi  schlieBlich  fiir  mehrere Pro¬ 
gramme  gleichzeitig  verfiigbar  sein.  Wie  sollten  sonst  das  Fenstersystem  der  AES,  mehrere 
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Accessories  und  ein  Hauptprogramm  gemeinsam  auf  dem  gleichen  Bildschirm  ausgeben 
konnen? 

Das  VDI  bietet  dazu  die  sogenannten  “virtuellen  Workstations”  an,  die  immer  nur  im 
Zusammenhang  mit  einer  bereits  geoffneten  “physikalischen”  Bildschirm-Workstation  be- 
nutzt  werden  konncn.  Jede  virtuelle  Workstation  verfiigt  iiber  einen  eigenen  Satz  von 
Attributen,  So  konnen  mehrere  Programme  Workstations  offnen,  ohne  sich  bei  den  Bild- 
schirmausgaben  gegenseitig  die  Attribute  zu  verstellen. 

Dock  aufgepafii:  Nicht  alle  Eigcnschaften  der  physikalischen  Bildschirm-Workstation  sind 
auf  die  virtuellen  Workstations  tibertragbar.  Tastatur  und  Maus  konnen  auch  weiterhin  immer 
nur  von  einem  Programm  gleichzeitig  benutzt  werden.  Die  Eingabefunktionen  diirfen  daher 
nur  von  dem  Programm  benutzt  werden,  das  die  physikalische  Bildschirm-Workstation 
gedffnet  hat. 

Normalerweise  “gehort”  die  Bildschirm-Workstation  den  AES.  Daraus  folgt,  daG  man  in 
normalen  GEM-Anwendungen  nie  die  VDI-Eingabefunktionen  benutzen  darf-  die  Verwal- 
tung  von  Maus  und  Tastatur  wird  vollstandig  von  den  AES  (Screen-Manager)  iibemommen. 

Es  besteht  ubrigens  keine  Verbindung  zwischen  den  virtuellen  Workstations  und  dem 
Fenstersystem  der  AES.  Jede  virtuelle  Workstation  benutzt  das  gleiche  Koordinatensystem 
wie  die  zugehorige  physikalische  Bildschirm-Workstation.  Die  Koordinaten  auf  Positionen 
relativ  zum  Fensterinhalt  umzurechnen  ist  einzig  und  allein  Aufgabe  des  Anwendungspro- 
gramms. 

Die  Verwaltung  der  Workstation-Attribute  erfordert  natiirlich  Speicher.  Nicht  nur  deshalb, 
weil  der  Bildschirmtreiber  im  ROM  den  Speicher  dynamisch  (per  “MallocO”)  anfordert,  sollte 
man  nie  davon  ausgeben,  daB  das  Offnen  einer  physikalischen  oder  virtuellen  Workstation 
immer  klappen  muG!  In  vielen  GDOS-Versionen  (siebe  unten)  werden  die  Informationen  in 
statischen  Strukturen  verwaltet,  so  daB  die  Maximalzahl  von  gleichzeitig  geoffneten  Work¬ 
stations  begrenzt  ist. 


Koordinatensysteme 

Das  VDI  unterscheidet  zwischen  zwei  verschiedenen  Typen  von  Koordinatensystemen:  dem 
“Rasterkoordinatensystem”  (oder  “RC-System”)  und  dem  “Normalisierten  Geratekoordina- 
tensystem”  (oder  “NDC-System”,  steht  fur  “Normalized  Device  Coordinates”). 

Bei  Verwendung  des  RC-Systems  kann  man  exakt  das  dem  Ausgabegerat  eigene  Koordinaten¬ 
system  nutzen.  Bei  einem  Bildschirm  entspricht  das  den  horizontal  und  vertikal  verfiigbaren 


278 


ATARI  Profibuch 


Pixeln.  Der  Nullpunkt  Iiegt  in  der  linken  oberen  Ecke.  Hauptvorteilc  der  Rasterkoordinaten 
sind  die  absolut  exakte  Positionierung,  die  die  genaue  Arbeit  mit  Bildschirmrastern  (Fenster 
etc.)  erst  mdglich  macht. 

Das  NDC-System  hingegen  hat  immer  eine  maximale  Auflosung  von  32768  mal  32768 
Punkten.  Das  VDI  rechnet  beim  Aufruf  eines  Geratetreibers  automatisch  auf  dessen  physika- 
lisches  Koordinatensy  stem  um.  Der  Nullpunkt  Iiegt  in  der  linken  unleren  Ecke.  Zur  Arbeit  mit 
dem  NDC-System  mull  ein  GDOS  (siehe  unten)  installiert  sein  -  der  Bildschirmtreiber  im 
ROM  kann  keine  NDC-Koordinaten  verarbeiten. 

In  der  Praxis  wird  das  NDC-System  nur  selten  benutzt.  Programme,  die  exakte  BemaSungen 
anbieten  miissen  (Desktop-Publishing,  wissenschaftliche  Graftk)  miissen  intern  sowieso  eine 
eigene,  feinere  Koordinatendarstellung  benutzen. 

Die  Benutzung  des  NDC-Systems  wiirde  dazu  fiihren,  dafl  Koordinaten  gleich  zweimal  kon- 
vertiert  werden  (einmal  von  der  intemen  Darstellung  in  NDC-Koordinaten,  anschlieBend  in 
Rasterkoordinaten),  was  zu  iiberflussigen  Geschwindigkcitsverlusten  und  Rundungsfehlem 
fiihrt. 


mO.  0, 32767 


RC:  x-1,  0 


Abb.  3.1:  Das  RC-  und  das  NDC-Koordinatensysiem 
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Auflosung  und  PixelgroBenverhaltnis 

Im  Zusammenhang  mit  dem  Begriff  “Auflosung”  kommt  es  nur  zu  haufig  zu  MiBverstand- 
nissen.  Viele  meinen,  mit  der  Auflosung  ware  die  Anzahl  der  verfiigbaren  Bildpunkte 
gemeint.  Weit  gefehlt! 

Die  Auflosung  gibt  an,  wie  groB  jeder  einzelne  Pixel  ist.  Das  gebrauchliche  MaB  heiBt  “dpi”, 
was  fur  “dots  per  inch”,  also  Pixel  pro  Zoll,  steht  (1  Zoll  sind  2,54  cm).  Gebrauchliche  Auf- 
Iosungen  sind 


Auflosung  ! 

Gerat 

72  dpi 

Macintosh-Bildschirm 

300  dpi 

Laserdrucker 

360  dpi 

24-Nadeldrucker 

Rechenexempel:  Bei  einem  handelsiiblichen  Laserdrucker  passen 
300  *  300  =  90000  Punkte 
auf  eine  Fiache  von 

2,54  cm  *  2,54  cm  =  6,452  Quadratzentimeter. 

Das  sind  etwa  14000  Punkte  pro  Quadratzentimer. 

Ein  anderes,  im  Druckgewerbe  gebrauchliches  MaB  ist  der  “Punkt”,  der  1/72  Zoll  groB  ist. 
SchriftgroBen  werden  normalerweise  in  “Punkt”  angegeben  -  der  Text,  den  Sie  gerade  lesen, 
ist  beispielsweise  in  einer  10-Punkt-Schrift  gesetzt. 

Wie  aus  der  obigen  Ubersicht  ersichtlich,  ist  bei  einem  Macintosh-Bildschirm  ein  Pixel  genau 
einen  “Punkt”  groB.  Eine  10-Punkt-Schrift  nimmt  auf  dem  Macintosh  daher  auch  10  Pixel  ein. 
Diese  Gleichheit  vereinfacht  natilrlich  viele  Berechnungen,  andererseits  macht  sie  den  Apple- 
Programmierem  den  Ubergang  zu  neuen,  hoherauflosenden  Bildschirmen  sehr  schwer. 

Beim  VDI  sieht  es  etwas  anders  aus.  Die  Auflosung  kann  beim  Offnen  der  Workstation 
abgefragt  werden  und  darf  fiir  Pixelbreite  und  Pixelhohe  verschieden  sein. 

Beim  Zeichnen  von  Kreisen  und  ahnlicher  geometrischer  Figuren  wird  dieses  Pixelgroflen- 
verhaltnis  ("Aspect  ratio”)  berucksichtigt  -  Kreise  blieben  also  auch  in  der  “mittleren” 
Auflosung  des  Atari  ST  Kreise.  Als  Referenzskala  dient  dabei  die  X-Achse. 
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Dieser  Mechaiiismus  erlaubt  es  prinzipiell,  auch  Gerate  mit  nicht-quadratischen  Pixeln 
korrekt  anzusteuem,  Hier  einige  wcitere  Beispiele: 


Auflosung 


Gerat 


360  dpi  *  1 80  dpi 
240  dpi  *  216  dpi 
91  dpi  *  91  dpi 
91  dpi  *  45  dpi 


einige  24-Nadeldrucker 
manche  9-Nadeldrucker  bei  Mehrfachdruck 
“ST-Hoch”  auf  SM  124  (640  Pixel  auf  7  Zoll) 
”ST-Mittel”  auf  einem  r2-Zoll-Farbbildschirm 


Wie  man  sieht,  ist  d  ie  Auflosung  letztendlich  auch  von  der  Moni  torgroBe  u  nd  derBildeinstellung 
abhangig.  Davon  wei8  natiirlich  das  VDI  nichts,  und  so  sind  die  beim  Offnen  der  Workstation 
zu  ermittelnden  Werte  nicht  zwingend  exakt.  Wer  es  ganz  prazise  mag,  miiBte  sich  insofem 
ein  Patchprogramm  im  AUTO-Ordner  installieren,  das  dem  VDI  korrekten  PixelgroBen 
unterschiebt.  Zumindestdas  PixelgroBenverhaltnis  kannman  jedoch  den  VDI-Riickgabewerten 
ziemlich  verlaBlich  entnehmen. 


Clipping 

Clipping  ist  ein  Verfahren,  das  die  Benutzung  eines  Fenstersy stems  eigentlich  erst  moglich 
macht.  Dabei  gibt  man  mittels  des  Clipping-Rechtecks  an,  auf  welchen  Bildschirmbereich 
sich  alle  Grafikausgaben  der  betreffenden  Workstation  beziehen  sollen.  Alles,  was  aus  dem 
so  spezifizierten  Bildausschnitt  herausragt,  wird  bei  der  Bildschirmausgabe  iibergangen. 

Fine  zwar  wenig  effiziente,  aber  leicht  zu  programmierende  Fensterausgaberoutine  wiirde 
einfach  fur  jedes  zu  zeichnende  Teilrechteck  des  Fensters  jeweis  ein  Clipping-Rechteck  setzen 
und  dann  alle  zum  Aulbau  des  Fensterinhalts  notwendigen  Bildschirmausgaben  wiederholen. 
Wer  sich  die  Mtihe  macht,  zunachst  anhand  einer  Plausibilitatabfrage  festzustellen,  ob  das  zu 
zeichnende  Objekt  iiberhaupt  sichtbar  ist,  kann  natiirlich  deutlich  Zeit  einsparen. 

Bleibt  zu  erwahnen,  daB  das  Clipping  natiirlich  nicht  gratis  zu  haben  ist.  Wer  optimale 
Geschwindigkeit  beim  Bildschirmaufbau  erreichen  will,  sollte  das  Clipping-Rechteck  so  oft 
wie  nur  moglich  ausschalten. 


Rasterformate 

Bei  der  Arbeit  mit  Bildschirmen  spielen  die  Rasterfunktionen  eine  besonders  groBe  Rolle:  sie 
sindfUralldas  zust&ndig,  was  mitderBewegung  oder  Veranderung  vonBildschirmausschnitten 
zu  tun  hat  -  als  Beispiele  seien  das  Scrolling  und  das  Darstellen  von  Icons  genannt. 
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DieRasterfunktionen  kbnnen  ihre  Aufgabe  natiirlich  nur  dann  effizient  erledigen,  wenn  als 
interne  Darstellung  das  gleiche  Format  verwendet  wird,  wie  es  auch  im  Bildspeicher  benutzt 
wird.  Anderenfalls  miiBten  die  Daten  bei  jedem  einzelnen  Aufruf  einer  Rasterfunktion 
konvertiert  werden.  NaturgemaB  ist  jedoch  der  interne  Aufbau  des  Bildspeichers  von  der 
Hardware  des  benutzten  Grafiksy  stems  abhangig  -  mal  davon  abgesehen ,  daB  der  B  ildspeicher 
gar  nieht  unbedingt  direkt  fiir  den  Prozessor  zuganglich  sein  muB, 

Wie  viele  Bits  man  pro  Pixel  braucht,  hiingt  natiirlich  von  der  Anzahl  der  gleichzeitig  dar- 
stellbaren  Farben  ab.  Fiir  monochrome  Pixel  braucht  man  jeweils  nur  ein  Bit  —man  muB  eben 
nur  die  Information  “ein/aus”  unterbringen.  Bei  16  Farben  sind  es  schon  vier  Bits  (denn  mit 
vier  Bits  kann  man  die  Werte  0..  1 5  darstellen),  Diese  Bits  konnen  je  nach  verwendeter  Video¬ 
hardware  vollig  verschieden  angeordnet  sein, 

Bei  einem  pixelorientierten  Format  werden  alle  zu  einem  Pixel  gehorenden  Bits  zusammen 
in  ein  Oder  mehrere  Bytes  kodiert.  In  einem  1 6-Farb-System  wiirden  also  jeweils  zwei  Pixel 
gemeinsam  in  einem  Byte  abgespeichert;  bei  256  Farben  nimmt  jeder  Pixel  ein  Byte  ein, 

Bei  planeorientierten  Formaten  verfolgt  man  einen  anderen  Ansatz.  Man  betrachtet  den 
Bildspeicher  einfach  als  eine  Sammlung  monochromer  (einfarbiger)  Bildebenen  (“planes”). 
Urn  zu  einem  Pixel  die  Farbe  zu  ermitteln,  kombiniert  man  die  zustandigen  Bits  aus  den 
einzelnen  Ebenen  zu  einem  Farbwert.  Damit  ist  freilich  noch  nichts  dariiber  ausgesagt,  wie 
die  einzelnen  Ebenen  im  Bildspeicher  angeordnet  sind.  Eine  einfache  (und  im  PC-Bereich 
auch  ubliche)  Losung  ist  es,  eine  Plane  nach  der  anderen  hintereinander  im  Bildspeicher 
anzuordnen. 

Bei  der  in  den  bisherigen  ST/TT-Modellen  serienmaBig  eingebauten  Videohardware  kommt 
eine  spezielle  Spielart  der  planeorientierten  Formate  zum  Einsatz:  die  Interleaved  Bitplanes. 
Die  einzelnen  Bildebenen  sind  dabei  nicht  jeweils  am  ganzen  Stuck  nacheinander  abgelegt, 
sondem  wechseln  sich  wortweise  ab  (mehr  dazu  im  Hard  wareteil  zum  Thema  “Grafiksy  stem”). 
Dieses  Format  verdankt  seine  Entstehung  vermutlich  technischen  Zwangen  bei  der  Entwick- 
lung  der  ersten  STs.  DaB  es  kunftig  sicherlich  nicht  weiterverwendet  werden  wird,  leuchtet 
ein,  wenn  man  sich  iiberlegt,  auf  wie  viele  Speicherzellen  im  Modus  “TT-Niedrig”  fiir  jeden 
einzelnen  Pixel  zugegriffen  werden  muB  (Antwort:  16  Bytes). 

Doch  selbst  wenn  es  nur  eine  Moglichkeit  zur  Verwaltung  der  Planes  gabe,  konnte  daraus 
kaum  ein  Standardformat  definiert  werden.  Orientierung  der  einzelnen  Bits  (steht  Bit  15  fiir 
einen  Pixel  links  oder  rechts  von  Pixel  14?)  und  ahnliche  Aspekte  konnen  prinzipbedingt  bei 
jedem  Grafiksystem  anders  gelQst  sein. 

Das  VDI  besei  tigt  dieses  Problem  auf  salomonische  Art  und  Weise:  es  unterscheidet  zwischen 
dent  gerateahhangigen  Format  (das  von  der  Hard  ware  abhangt)  und  dem  Standardformat.  Das 
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Standardformat  ist  fiir  alle  Rechner  mit  VDI  gleich  und  kann  daher  immer  dann  benutzt 
werden,  wenn  Rastergrafiken  von  “auBen”  in  das  System  eingebracht  werden  (Beispiel: 
Darstellung  von  Icons  in  einer  Resource-Datei).  Zur  Umwandlung  zwischen  beiden  Formaten 
steht  die  Funktion  “vr_tmfm()”  zu  Verfdgung.  Und  hier  ist  die  Definition  des  VDI- 
Standardfonnats: 

-  Das  Format  ist  planeorientiert.  Jede  Bildebene  belegt  ein  zusammenhangendes  Stiick 
Speicher  und  hat  die  gleiche  Anzahl  von  Bildpunkten. 

-  Das  hochste  Bit  eines  16-Bit-Worts  steht  fiir  den  am  weitesten  links  stehenden  Pixel. 

-  Aufeinanderfolgende  Worte  im  Bildspeicherbilden  die  einzelnen  Zeilen.  Das  erste  Wort 
einer  solchen  Zeile  liegt  am  linken  Bildrand.  Die  erste  Zeile  der  Plane  kodiert  die  oberste 
Pixelzeile. 


Abb,  3.2:  Ein  Beispiel  fiir  das  gerateunabhangige  Standardformat 
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In  den  monochromen  Grafikmodi  von  ST  und  TT  entspricht  das  gerateabhangige  Format 
zufdllig  dem  gerateunabhangigen  Format,  Das  heiBt  natiirlich  nicht,  daB  man  deshalb  auf  den 
Aufruf  von  “vr_tmfm()”  verzichten  darf! 

Uber  das  gerateabhangige  Format  hingegen  hat  man  keinerlei  Informationen.  Schon  deshalb 
verbietet  sich  jede  direkte  Manipulation  am  Bildspeicher  von  selbst. 

Das  VDI  arbeitet  prinzipiell  Farbregister-orientiert  (“Color-Lookup-Table”).  Es  geht  also 
davon  aus,  daB  es  eine  Maximalzahl  von  gleichzeitig  darstellbaren  Farben  gibt  und  daB  man 
diesen  Farbregistem  bestimmte  -  relativ  frei  wahlbare  -  Farbtone  zuordnen  kann, 

Diese  Eigenschaft  ist  jedoch  nicht  selbstverstandlich  und  kann  auch  mit  Hilfe  von  “  vq_extnd()” 
erfragt  werden.  Zwei  Beispiele  fur  Grafikmodi  ohne  “Color-Lookup”: 

1.  Der  TT-Grafikmodus  “TT-Hoch”:  es  gibt  nur  zwei  Farbregister  und  zwei  Farbtone 
(Schwarz  und  WeiB),  die  auch  nicht  vertauscht  werden  konnen. 

2.  Bei  “True-Color”-Karten  konnen  “beliebig”  viele  Farben  gleichzeitig  dargestellt  wer¬ 
den.  Normalerweise  werden  24  Bits  pro  Pixel  benutzt  -  es  stehen  also  etwa  1 6  Millionen 
Farben  zu  Verfiigung. 

Bei  einer  derartigen  Anzahl  von  Farbnummem  hat  sich  die  Idee  von  Farbregistem 
erledigt:  die  Anzahl  der  prinzipiell  gleichzeitig  darstellbaren  Farbtone  iibersteigt  die 
typische  Zahl  von  Bildpunkten  bei  weitem.  Schon  in  Ktirze  soli  das  VDI  solche  Grafik- 
karten  unterstiitzen. 

Eine  weitere  unbeantwortete  Frage  bleibt:  Auf  welche  Weise  hangen  die  Pixelwerte  im 
Bildspeicher  mit  VDI-Farbnummem  zusammen? 

1 .  Aus  historischen  Griinden  darf  man  davon  ausgehen,  daB  bei  einem  Pixel  in  VDI-Farbe 
0  (normalerweise  WeiB)  alle  Bits  geloscht  sind.  Analog  dazu  sind  bei  schwarzen  Bild¬ 
punkten  (VDI-Farbe  1 )  alle  Pixel  gesetzt. 

Diese  Regel  ergibt  sich  schon  dadurch,  daB  durch  ein  vollstandiges  Invertieren  aller  Bits 
der  Pixeldarstellung  WeiB  und  Schwarz  vertauscht  werden  miissen, 

2.  Mit“v_get_pixel()”kannmanfureinegegebeneBildkoordinatesowohlVDI-Farbnummer 
als  auch  Pixelwert  erffagen. 

Zusatzlich  haben  Digital  Research  und  Atari  die  Standardzuordnungen  fur  8-  und  16-Farb- 
Grafikstufen  dokumentiert  (man  achte  speziell  auf  die  Zuordnung  von  VDI-Farbe  1!). 
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Bei  acht  Farben; 


Pixelwert 

Farbindex 

Farbe 

Name 

000 

0 

weiB  (Hinterginnd) 

WHITE 

001 

2 

rot 

RED 

010 

3 

griin 

GREEN 

Oil 

6 

gelb 

YELLOW 

100 

4 

blau 

BLUE 

101 

7 

magenta 

MAGENTA 

110 

5 

cyan 

CYAN 

111 

1 

schwarz 

BLACK 

Bei  16  Farben: 


Pixelwert 

Farbindex 

Farbe 

Name 

0000 

0 

weifi  (Hintergrund) 

WHITE 

0001 

2 

rot 

RED 

0010 

3 

griin 

GREEN 

0011 

6 

gelb 

YELLOW 

0100 

4 

blau 

BLUE 

0101 

7 

magenta 

MAGENTA 

0110 

5 

cyan 

CYAN 

0111 

8 

hellgrau 

LWHITE 

1000 

9 

dunkelgrau 

LBLACK 

1001 

10 

dunkelrot 

LRED 

1010 

11 

dunkelgriin 

LGREEN 

1011 

14 

dunkelgelb 

LYELLOW 

1100 

12 

dunkelblau 

LBLUE 

1101 

15 

dunkelmagenta 

LMAGENTA 

1110 

13 

dunkelcyari 

LCYAN 

mi 

1 

schwarz 

BLACK 

Als  Datenstruktur  zur  einheitlichen  Beschreibung  von  Rastem  dient  die  MFDB-Struktur 
(“Memory  Fonn  Definition  Block”): 
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typedef  struct 
{ 

void  *fd_addr;  /*  Zeiger  auf  Speicherblock  (mull  auf  gera- 

der  Adresse  liegen) .  Fur  den  Bildspei- 
cher  mufi  man  0  ubergeben,  alle  anderen 
Werte  werden  dann  ignoriert  */ 

WORD  fd__w;  /*  Breite  des  Speicherblocks  in  Punkten  */ 

WORD  fd__h;  /*  Hohe  des  Speicherblocks  in  Punkten  */ 

WORD  fd_wdwidth;  /*  Breite  des  Speicherblocks  in  16-Bit- 

Wort  en  */ 

WORD  fd__stand;  /*  0:  gerateabhangiges  Format, 

1:  Standardforrnat  */ 

WORD  fd_nplanes;  /*  Anzahl  der  Bildebenen  */ 

WORD  fd_rl,fd_r2,  fd_r3;  /*  reserviert  */ 

}  MFDB; 

Eine  MFDB-Struktur  beschreibt  einen  “rechteckigen”  Speicherblock  -  entweder  im 
Arbeitsspeicher  oder  im  Bildschirm.  Wenn  man  den  Bildspeicher  meint,  mufi  man  “fd_addr” 
auf  0  setzen.  Alle  anderen  Werte  werden  dann  ignoriert.  Die  VDI-Rasterfunktionen  arbeiten 
ausschliefilich  dann  mit  Clipping,  wenn  “fd_addr”  0  ist. 

Anderenfalls  beschreibt  der  MFDB  einen  fur  die  CPU  zuganglichen  Speicherblock.  Dann,  und 
nur  dann,  muB  man  die  restlichen  Werte  des  MFDB  mit  sinnvollen  Werten  fuilen. 

Die  folgende  Beispielfunktion  ermittett  den  fur  einen  rechteckigen  Bildausschnitt  benotigten 
Speicherplatz  und  besetzt  schon  die  wichtigsten  Felder  des  MFDB  vor; 

ULONG  RastSize  (WORD  handle,  WORD  width,  WORD  height,  MFDB  *p) 

{ 

WORD  work_out [ 57 ] ; 

WORD  widthjwd; 

vg_extnd  (handle,  1,  work_out) ;  /*  erweiterte  Attribute 

erfragen  */ 

width_wd  =  (width  +  15)  /  16;  /*  Anzahl  der  benotigten 

WORDS  */ 

p->fd_w  =  width; 
p->fd_h  =  height; 
p->fd__wdwidth  =  width_wd; 
p->f d_nplanes  =  work__out  { 4  j  ; 
p->fd_stand  =0; 
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return  ( ( (OLONG)  height)  *  /*  Bildschirmzeilen  */ 

( (ULONG)  widthjwd  *  2)  *  /*  Bytes  pro  Zeile  */ 

((ULONG)  work_out  [4] ) ) ;  /*  Planes  */ 

} 

GDOS 

Das  VDI  -  eine  Illusion? 

Bislang  wurde  immer  nur  ganz  abstrakt  von  “dem”  VDI  gesprochen.  Dali  die  eigentliche 
Arbeit  von  den  Geratetreibern  erledigt  wird,  wurde  auch  schon  erwahnt. 

Bleibt  die  Frage:  was  bleibt  vom  VDI  iibrig,  wenn  man  die  Geratetreiber  wegnimmt?  Antwort: 
es  bleibt  GDOS  (“Graphics  Device  Operating  System”),  die  Schaltzentrale,  die  fur  die 
Verwaltung  der  einzelnen  Geratetreiber,  der  nachladbaren  Zeichensatze  und  der  verschiede- 
nen  Koordinatensysteme  zustandig  ist. 

Alle  diese  Fahigkeiten  gehen  dem  im  ROM  verankerten  VDI  ab,  weil  es  eben  kein  GDOS 
enthalt.  GDOS  muli  daher  normalerweise  nachtraglich  als  residentes  AUTO-Ordner-Pro- 
gramm  installiert  werden. 

Die  Griinde  hierfiir  sind  primar  in  den  Platzproblemen  zu  suchen,  die  Atari  bei  der 
Zusammenstellung  der  ers'ten  TOS-ROMs  plagten.  Was  ursprtinglich  als  Lticke  gait,  darf 
heute  jedoch  eher  als  Glucksfall  eingestuft  werden:  kaum  ein  anderer  Betriebssystemteil  hat 
von  Aulienstehenden  soviet  Weiterentwicklung  erfahren  -  gerade  deshalb,  weil  es  so  leicht 
durch  eine  verbesserte  Version  zu  ersetzen  ist .  (Ein  gutes  Beispiel  ist  das  “AMC-GDOS”  von 
VDI-Insider  Amd  Beissner,  das  bis  einschlieBlich  Version  3.21  fur  den  nichtkommerziellen 
Einsatz  frei  verfugbar  und  in  fast  alien  Mailboxen  zu  finden  ist.) 

Und  so  ist  es  vermutlich  auch  zu  erklaren,  warum  GDOS  auch  in  den  neuesten  TOS  -  Versionen 
nicht  im  ROM  untergebracht  ist. 

Die  Kehrseite  der  Medaille  ist  allerdings  auch  schnell  beschrieben: 

-  fiir  Nicht-Insider  komplizierte  Installation 

-  urspriinglich  sehr  liickenhafte  Informationen 

-  sehr  viele  altere  Programme  laufen  bzw.  liefen  nicht  korrekt,  wenn  GDOS  installiert  ist 
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Ein  weiterer  Grund  fur  die  urspriinglich  schlechte  Akzeptanz  von  GDOS  war  die  uniiberseh- 
bare  Bremsung  aller  VDI-Funktionen,  die  Folge  einer  bemerkenswert  ineffizienten 
Programmierung  des  Dispatchers  ist.  GDOS-Versionen  von  Fremdanbietem  und  kiinftige 
GDOS-Versionen  von  Atari  haben  dieses  Problem  allerdings  nicht  mehr  (oder  zumindest  in 
einem  erheblich  geringerem  MaBe). 

Ein  anderes  Problem  ist  natiirlich  die  Verfiigbarkeit.  Wer  GDOS  zur  Zeit  in  einem  kommer- 
ziellen  Programm  einsetzen  will,  muB  es  mitliefem  und  dazu  bei  Atari  eine  Lizenz  erwerben 
(gleiches  gilt  natiirlich  auch  damn,  wenn  man  das  GDOS  eines  anderen  Anbieters  mitliefem 
mochte).  Die  von  Atari  geforderte  Lizenzsumme  ist  allerdings  so  niedrig,  daB  auch  kleine 
Softwarehauser  dadurch  vor  kein  Problem  gestellt  werden.  Genauere  Informationen  dazu 
erhalten  Sie  bei  Ataris  Software-Support. 


Geratetreiber 

Jedem  im  System  befindlichen  Gerat  ist  ein  eigener  Treiber  (mit  einer  speziellen  Treiberdatei) 
zugeordnet.  Der  Bildschirmtreiber  im  ROM  nimmt  nur  insofem  eine  Sonderrolle  ein,  als  sein 
Programmcode  eben  im  ROM  und  nicht  in  einer  Datei  vorliegt. 

Jeder  einzelne  Geratetreiber  muB  alle  diejenigen  VDI-Funktionen  iibemehmen,  fiir  die  nicht 
das  GDOS  zustandig  ist,  und  enthalt  also  in  etwa  die  gleiche  Funktionalitat  wie  der  ROM- 
Bildschirmtreiber.  liber  Aufbau  und  Funktionen  der  verschiedenen  Geratetreiber  gibt  ein 
eigenes  Kapitel  Auskunft. 


Zeichensatze 

Das  VDI  kennt  generell  zwei  verschiedene  Klassen  von  Zeichensatzen.  Damit  ist  allerdings 
noch  keine  Aussage  dariiber  gemacht,  welcher  Art  diese  Zeichensatze  sind  -  das  ist  vom 
jeweiJigen  Treiber  bzw.  dem  verwendeten  GDOS  abhangig. 

Zunachst  einmal  gibt  es  die  sogenannten  Systemzeichensatze  -  das  sind  solche  Fonts,  die  das 
Gerat  “von  Haus  aus”  kennt.  Den  Systemzeichensatz  des  ROM-Bildschirmtreibers  kennt 
jeder  -  man  hat  ihn  permanent  bei  der  Arbeit  mit  GEM  vor  Augen  (auch,  wenn  es  den  System¬ 
zeichensatz  in  mehreren  Grofien  gibt,  handelt  es  sich  doch  eben  nur  urn  eine  Schrift  mit  einer 
gemeinsamen  Zeichensatznummer).  Die  Anzahl  der  verfugbaren  Systemzeichensatze  wird 
beim  Offtien  der  Workstation  zuriickgeliefert  und  muB  nicht  gleich  1  sein! 

Wenn  GDOS  installiert  ist,  kann  man  auf  zusatzliche  Zeichensatze  zugreifen,  die  bei  einem 
Aufruf  von  “vst_load_fonts()”  geladen  werden.  Welcher  Art  diese  Zeichensatze  sind,  ist  nicht 
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dokumentiert  und  vom  verwendeten  GDOS  abhangig.  Aus  der  Sicht  eines  Anwendungs- 
programms  verhalten  sich  auf  jeden  Fall  alle  verfiigbaren  Zeichensatze  gleich. 


Koordinatensysteme 

Die  Unterstiitzung  des  NDC-Koordinatensystems  ist  eine  weitere  Aufgabe  von  GDOS.  Dazu 
merkt  es  sich  fiir  jede  geoffnete  Workstation,  ob  RC-  oder  NDC-Koordinaten  benutzt  werden 
sollen,  und  kiimmert  sich  bei  jedem  VDI-Aufruf  um  die  Konvertierung  von  Koordinaten  und 
Maften. 


Kiinftige  Weiterentwickl  ungen 

Im  PC-Bereich  sind  am  VDI  diverse  Erweiterungen  vorgenommen  worden.  Einige  Beispiele: 

-  Mehr  Optionen  beim  Offnen  von  Workstations  (Stichwort:  Papierformate  bei  Drucker- 
treibem). 

-  Unterstutzung  von  Grau-  und  Farbverlaufen. 

-  Bezierkurven  (realisiert  durch  einen  “globalen”  Schalter,  der  zwischen  Polyline-  und 
Bezierdarstellung  von  Linien  und  Polygonen  umschaltet). 

-  Erweiterungen  fur  “True-Color”-Grafik  (also  Farbgrafikkarten  mit  24  Bit  pro  Pixel). 

Ob  und  welche  dieser  Erweiterungen  jemals  Eingang  in  das  Atari-GDOS  bzw.  die  Geratetreiber 
finden  wird,  ist  heute  schwer  abzusehen.  Sicher  scheint,  daft  kiinftige  GDOS-Versionen  zu- 
mindest  PC-GEM-kompatible  Beziererwciterungen  enthalten  werden  -  einige  Fremdhersteller 
bieten  schon  jetzt  solche  GDOS-Versionen  an  (zum  Beispiel:  AMCGDOS  5.0). 

Von  Atari  seit  Herbst  1 990  angekiindigt  ist  FSMGDOS ,  eine  GDOS-Version,  die  Postscript- 
ahnliche  Vektorschriften  unterstiitzen  soli.  Hoffentlich  ist  die  Entwicklung  bald  abgeschlos- 
sen,  denn  erst  mit  FSMGDOS  wird  das  VDI  die  Flexibility  bei  der  Textausgabe  haben,  die 
man  sich  wiinscht  (identische  Zeichensatze  fiir  alle  Ausgabegerate,  freie  Skalier-  und  Rotier- 
barkeit,  okonomischere  Nutzung  des  Speicherplatzes). 

Keine  der  beiden  Entwicklungen  war  bei  Redaktionsschluft  fertiggestellt  und  veroffentlicht. 

Daher  miissen  wir  fiir  weitere  Informationen  leider  auf  kiinftige  Auflagen  des  Profibuchs,  die 
Fachzeitschriften  und  den  Entwickler-Support  von  Atari  verweisen. 
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Technische  Details 

Informatlonen  liber  GDOS  erfragen 

In  einigen  Fallen  kann  es  wichtig  sein,  zu  wissen,  ob  iiberhaupt  ein  vollstandiges  GDOS 
installiert  1st  (zum  Beispiel,  bevor  man  einen  “vst_load_fonts()”-Aufruf  macht).  Gliicklicher- 
weise  hat  Atari  beschrieben,  wie  man  in  dieser  Frage  vorzugehen  hat.  Die  Funktion  beruht  auf 
der  Tatsache,  daG  der  Trap-Dispatcher  den  Eingabewert  -2  flir  Register  DO  genau  dann 
verandert,  wenn  ein  GDOS  installiert  ist  (' Vorsicht :  Die  GEM-Versionen  des  niederlandischen 
Softwarehauses  “ABC”  (ABC-GEM  2.x)  stiirzen  bei  diesem  Aufmf  ab). 

Bei  den  meisten  Entwicklungssystemen  ist  diese  Funktion  bereits  in  die  VDI-Bibliotheken 
aufgenommen  worden.  Hier  ein  Beispiel-Binding  in  Alcyon-C: 

/*  liefert  0,  falls  GDOS  nicht  installiert  ist  */ 


WORD  vq  gdos ( ) 

{ 

asm("  move.w 

#-2,d0 

asm(" 

trap 

#2 

asm(" 

cmp.w 

#-2,d0 

asm(" 

sne 

dO 

asm  (" 

ext  .w 

dO 

} 


Zeichensatzformat 

Alle  zur  Zeit  erhaltlichen  GDOS-Versionen  konnen  Zeichensatze  im  DR-Standardformat  fiir 
Bitmap-Zeichensatze  laden.  Bei  diesem  Format  wird  der  Zeichensatz  einfach  wie  ein  sehr 
breites  monochromes  Rasterbild  organisiert  -  alle  Zeichen  stehen  in  Reih  und  Glied  neben- 
einander.  Die  Breite  des  Rasters  (“form  width”)  ist  die  Summe  aller  Zeichenbreiten,  die 
Rasterhohe  (“form  height”)  entspricht  der  Hohe  eines  einzelnen  Zeichens. 

Unmittelbare  Konsequem :  Der  linke  Rand  eines  Zeichens  fallt  nicht  unbedingt  auf  eine 
Bytegrenze!  Nur  am  Ende  jeder  Rasterzeile  wird  mit Nullbits  so weit  aufgefiillt,  bis  der  nachste 
Zeilenbeginn  wieder  auf  eine  Wortgrenze  fallt. 

Da  das  VDI  urspriinglich  auf  dem  PC  entwickelt  wurde,  liegen  normalerweise  alle  Daten  im 
Intel  -Format  vor.  Es  miissen  also  in  jedem  einzelnen  1 6-B  it-Wort  des  Zeichensatzkopfes  das 
obere  und  das  untere  Byte  vertauscht  werden. 
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Auch  ein  Motorola-Format  (ohne  Bytevertauschung)  ist  definiertund  kann  anhand  ernes  Flags 
im  Dateikopf  unterschieden  werden.  Zeichensatze  im  Motorola-Format  werden  zwar  ROM- 
intem  fur  die  Systemzeichensatze  benutzt,  konnen  aber  von  den  meisten  GDOS-Versionen 
nicht  gelesen  werden.  Der  Dateiheader  fur  einen  solchen  Zeichensatz  sieht  wie  folgt  aus: 


typedef  struct 

{ 

WORD 

WORD 

CHAR 

UWORD 


UWORD 

UWORD 

UWORD 

UWORD 

UWORD 

UWORD 

UWORD 

UWORD 

UWORD 

UWORD 

UWORD 


UWORD 

UWORD 


UWORD 


UWORD 


font_id; 
point ; 
name [32] ; 
first  ade; 


last_ade ; 

top; 

ascent; 

half  ; 

descent; 

bottom; 

max  char  width; 


/*  Fontnummer  */ 

/*  Grohe  im  Punktmail  */ 

/*  Name  des  Zeichensatzes  */ 

/*  Erstes  Zeichen  im  Zeichensatz  (nur 
die  wenigsten  Druckerschriften 
enthalten  Control-Zeichen,  also 
ASCII-Werte  kleiner  32)  */ 

/*  Letztes  Zeichen  im  Zeichensatz  */ 
/*  Abstand  Topline<->Baseline  */ 

/*  Abstand  As cent line<->Base line  */ 

/*  Abstand  Halfline<->Baseline  */ 

/*  Abstand  Descentline<->Baseline  */ 
/*  Abstand  Bottomline<->Baseline  */ 


/*  grofrte  Zeichenbreite  */ 


max_cel l_width; 

/*  groiite  Zeichenzellenbreite  */ 
left  offset;  /*  linker  Offset  fur  Kursivschrift  */ 
right_of fset;  /*  rechter  Offset  fur  Kursivschr.  */ 
thicken;  /*  Verbreiterungsfaktor  fur 

Fettschrift  (bei  Fettschrift  wird 
die  Breite  urn  genausoviele  Pixel 
erhoht)  */ 


ul_size; 

lighten; 


skew; 


flags; 


/*  Dicke  der  Unterstreichung  */ 

/*  Maske  fur  helle  Schrift  (wird  mit 
Raster  undiert,  normalervjeise 
0  x  5555)  */ 

/*  Maske  fur  Kursivschrift  (be- 
schreibt,  an  welchen  Stellen  die 
Rasterzeilen  verschoben  werden 
sollen,  normalerweise  0  x  5555  */ 
/*  Bit  0:  gesetzt,  wenn  es  der 

"Default  system  font"  ist 
Bit  1:  gesetzt,  wenn  die  "Hori- 
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UBYTE 

*hor_table; 

/* 

UWORD 

*off_table; 

/* 

UWORD 

*dat_table; 

/* 

UWORD 

form  width; 

/* 

UWORD 

form_height; 

/* 

FONT_HDR 

*next  font; 

/* 

}  FONT  HDI^- 


zontal  offset  table" 
benutzt  wird 

Bit  2:  gesetzt,  wenn  Bytes  nicht 
vertauscht  werden  mussen 
(Motorola-Format ) 

Bit  3:  gesetzt,  wenn  der  Font 

nicht  proportional  ist  */ 
Zeiger  auf  "Horizontal  Offset 
Table";  in  der  Datei  der  Offset 
zum  Dateibeginn  */ 

Zeiger  auf  "Character  Offset 
Table"  */ 

Zeiger  auf  Fontimage  */ 

Breite  des  Zeichensatzimage  */ 

Hohe  des  Zeichensatzimage  *J 
Zeiger  auf  nachsten  Fontheader  (in 
Fontdatei  zunachst  unbenutzt)  V 


Bleibt  ein  Problem'.  Urn  das  Motorola/Intel-Flag  abfragen  zu  konnen,  muB  man  eigentlich 
bereits  wissen,  welches  Format  der  Zeichensatz  bat  (denn  im  Intel-Format  liegen  alle  16-Bit- 
Worte  des  Headers  “vertauscht”  vor!).  Einzige  Moglichkeit:  Man  geht  davon  aus,  daB  Bit  10 
des  Flags  mentals  benutzt  sein  wird  und  testet,  ob  Bit  2  im  67.  Byte  des  Headers  gesetzt  ist 
-  dann  liegt  der  Font  im  Motorola-Format  vor! 


Die  “Character  Offset  Table”  ist  eine  Tabelle  von  16-Bit-Werten,  die  den  horizontalen 
Pixeloffset  fur  jedes  Zeichen  innerhalb  des  Fontrasters  angibt. 

Als  Index  muB  man  also  den  ACSII-Code  minus  den  ACSII-Code  des  ersten  Zeichens  im 
Zeichensatz  benutzen  (“first_ade”).  Die  Breite  eines  Zeichens  ergibt  sich  aus  der  Differenz 
zum  Offsetwert  des  nachsthoheren  Zeichens  (damit  diese  Formel  auch  fur  das  letzte  Zeichen 
funktioniert,  enthdlt  die  Tabelle  immer  einen  Eintrag  mehr,  als  Zeichen  da  sind). 


Die  “Horizontal  Offset  T able”  wird  nur  bei  wenigen  Zeichensatzen  benutzt  und  enthalt  positve 
Oder  negative  Offsetwerte,  die  vor  der  Ausgabe  eines  Zeichens  auf  die  X-Position  addiert 
werden. 


AbschlieBend  sei  nochmals  darauf  hingewiesen,  daB  sich  eine  normale  VDI-Anwendung 
niemals  mit  diesem  Format  befassen  muB.  Die  Beschreibung  ist  nur  fiir  diejenigen  wichtig, 
die  Zeichensatzeditoren  oder  -generatoren  entwickeln  Oder  die  Welt  mit  einer  weiteren  neuen 
GDOS-Version  begliicken  wollen. 
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Zeichensatznamen 

Atari  selbst  liefert  auf  der  GDOS-Systemdiskette  folgende  Zeichensatze  mit: 


Fontnummer 


Name 


02 

14 

15 


Swiss  (Helvetica-Schrift,  Dateien  “ATSS*.FNT”) 
Dutch  (Times-Schrift,  Dateien  “ATTR*.FNT”) 
Typewriter  (Courier-Schrift,  Dateien  “ATTP*.FNT”) 


Auch  die  Bedeutung  der  Dateinamen  ist  dokumentiert,  wird  aber  leider  nicht  einheitlich 
benutzt: 


Zeichen 


Belegung 


0..1 

2.. 3 

4. . 5 

6..  7 


Hersteller  des  Zeichensatzes  (bei  Ataris  Zeichensatzen  “AT”) 

Ktirzel  fur  den  Zeichensatztyp  (z.  B.  “SS”  fiir  “Sans  Serif’,  “TR”  fiir 
‘Times  Roman”,  “TP”  fiir  “Typewriter”) 

PunktgroBe  des  Zeichensatzes 

Typ  des  Ausgabegerats  (z.  B.  “EP”  fiir  Epson-9-Nadeldrucker,  “LS”  fiir 
Laserdrucker,  “CG”  fiir  die  640*200-Auflosung  oder  leer  fiir  Standard- 
Bildsehirmfonts) 


Die  ASSIGN.SYS-Datei 

DieseTextdateienthaltlnformationen  iiber  die  vorhandenenGeratetreiberund  die  Zeichensatze, 
die  ihnen  zugeordnet  sind.  GDOS  sucht  sie  bei  Systemstart  im  Wurzelverzeichnis  des  Boot- 
laufwerks. 

Hier  zunachst  eine  Beispieldatei: 

;  Beispiel  fiir  ASSIGN.SYS-Datei 
path  =  C:\gemsys 

Olp  screen. sys  ;  Bildschirmtreiber  (ROM) 

ATSS10.FNT 

ATSS12.FNT 

ATSS18.FNT 

ATSS24.FNT 

ATTR10.FNT 
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ATTR12.FNT 
ATTR18.FNT 
ATTR24 .FNT 
ATTP10.FNT 

02p  screen. sys  ;  Bildschirmtreiber  (ROM) 

ATSS10.FNT 

ATSS12.FNT 

ATSS18.FNT 

ATSS24.FNT 

ATTR10.FNT 

ATTR12.FNT 

ATTR18.FNT 

ATTR24.FNT 

ATTPIO.FNT 

03p  screen. sys  ;  Bildschirmtreiber  (ROM) 

ATSS10CG.FNT 
ATSS12CG.FNT 
ATSS18CG.FNT 
ATSS24CG.FNT 
ATTR10CG-FNT 
ATTR12CG.FNT 
ATTR18CG . FNT 
ATTR2  4  CG . FNT 
ATTP10CG.FNT 
ATTP10CG.FNT 

04p  screen. sys  ;  Bildschirmtreiber  (ROM) 

ATSSIO.FNT 
ATSS12 . FNT 
ATSS18.FNT 
ATSS24.FNT 
ATTR10 .FNT 
ATTR12 . FNT 
ATTR18.FNT 
ATTR24.FNT 
ATTPIO.FNT 
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21r  fx80.sys  ;  Epson  FX80,  resident 


ATSS10EP.FNT 
ATSS12EP.FNT 
ATSS18EP.FNT 
ATSS24EP.FNT 
ATTR10EP.FNT 
ATTR12EP.FNT 
ATTR18EP.FNT 
ATTR24EP . FNT 
ATTP10EP.FNT 


31  meta.sys  ;  Metafile-Treiber 

ATSS10MF.FNT 
ATSS12MF.FNT 
ATSS18MF.FNT 
ATSS24MF . FNT 
ATTR10MF . FNT 
ATTR12MF . FNT 
ATTR1 8MF . FNT 
ATTR24MF.FNT 
ATTP10MF.FNT 

Kommentare  werden  mit  emem  Semikolon  eingeleitet  und  konnen  an  einer  beliebigen  Stelle 
in  der  Textzeile  beginnen  -  auf  einem  Atari  TT  wurden  noch  zusatzliche  Eintrage  fUr  die 
Geriite  5  bis  10  benotigt.  Die  erste  Zeile,  die  keinen  Kommentar  enthalt,  darf  einen  Eintrag 
der  Form 

path  =  pfadname 

enthalten. 

GDOS  suchtdann  Treiber  und  Zeichensatze  in  dem  dort  angegebenen  Verzeichnis  (Maximal- 
lange:  64  Zeichen!). 

Es  folgen  die  Eintrage  fur  die  Geratetreiber  und  die  ihnen  zugeordneten  Zeichensatze. 
Jeder  Geratetreiberformat  hat  das  Format: 


<NummerXFlag>  <Dateiname  des  Treibers> 
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Die  Nummer  entspricht  der  beim  Offnen  der  Workstation  iibergebenen  Geratenummer.  Man 
beachte,  daB  fur  jede  mogliche  Geratenummer  auch  ein  Treiber  angemeldet  sein  muB.  Die 
AES  benutzen  zur  Berechnung  der  zu  benutzenden  Bildschirmworkstation  die  Formel: 

2  +  Getrez  ()  ; 

Als  Flag  darf  “r”  (Treiber  gleich  beim  Booten  resident  laden)  oder  “p”  (Treiber  ist  im  ROM 
installiert)  oder  auch  nichts  (Treiber  beim  Offnen  der  Workstation  nachladen)  angegeben 
werden.  Bei  gesetztem  “p”-Flag  ist  der  Treibemame  nur  ein  Platzhalter,  den  GDOS  braucht, 
um  die  Zeile  dekodieren  zu  konnen. 

Es  folgen  die  Eintrage  fur  die  einzelnen  verfiigbaren  Zeichensatze.  Man  beachte  dabei,  daB 
Fonts  der  gleichen  Familie  (also  mit  glejcher  Fontnummer,  aber  verschiedener  PunktgroBe) 
direkt  aufeinander  folgen  sollten. 


IJber  sicht  iiber  die  VDI-Bibliotheken 

Die  VDI-Funktionen  sind  in  sieben  Bereiche  unterteilt.  Diese  Unterteilung  ist  nicht  immer 
ganz  konsequent  -  aus  historischen  Griinden  wollen  wir  es  aber  dabei  belassen.  Der  Meinung, 
die  von  Digital  Research  vergebenen  Bezeichnungen  seien  allzu  kryptisch,  konnen  wir  uns 
nicht  anschlieBen,  man  muB  sich  eben  nur  an  sie  gewohnen. 

Im  allgemeinen  kann  man  namlich  aus  den  Buchstaben  vor  dem  ersten  Unterstrich  schon  die 
Funktion  gut  einordnen.  Beispiel:  “vst_”  steht  fiir  “VDI  SET  TEXT”. 

Kontrollfunktionen 

Diese  Funktionen  dienen  zur  Kontrolle  der  Workstations  -  Offnen  und  SchlieBen,  Laden  und 
Freigeben  von  Zeichensatzen,  Setzen  des  Clippings  und  verwandte  Informationen.  Faustregel: 
Bei  den  meisten  dieser  Funktionen  spielt  GDOS  eine  Rolle. 

Ausgabefunktionen 

Mit  Hilfe  dieser  Funktionen  werden  die  Grafikgrundformen  ausgegeben. 

Attributfunktionen 

Jede  Grafikgrundform  ist  in  verschiedenen  Darstellungen  verfugbar.  Man  kann  mit  den  Attri¬ 
butfunktionen  Farbe,  Linienbreite  und  vieles  mehr  wahlen.  Mehrere  Attributfunktionen  kon¬ 
nen  zu  Full-,  Linien-,  Marker-  und  Text-Attributen  zusammengefaBt  werden. 


296 


ATARI  Profibuch 


Raster-Operationen 

Die  Raster-Operationen  bieten  die  Moglichkeit,  Raster  unter  Anwendung  verschiedener 
Verkniipfungen  im  Bildspeicher,  im  Arbeitsspeicher  oder  zwischen  beiden  Bereichen  hin  und 
her  zu  kopieren.  Femer  konnen  Raster  konvertiert  und  die  Belegung  einzelner  Pixel  abgefragt 
werden. 

Eingabefunktionen 

Mit  diesen  Funktionen  konnen  die  verschiedenen  Eingabegerate  (wie  Maus  oder  Tastatur) 
abgefragt  werden.  Die  Eingabefunktionen  sind  zwar  ein  Bestandteil  des  Bildschirmtreibers, 
diirfen  aber  nur  auf  der  physikalischert  Workstation  eingesetzt  werden. 

Eine  Eigenheit  der  Eingabefunktionen  sind  die  “doppelten”  Bindings  fur  viele  Funktionen: 
Je  nach  eingeschalteter  Betriebsart  (Request  oder  Sample)  werden  unterschiedliche  Funk- 
tionsnamen  benutzt  -  auch  wenn  der  benutzte  Opcode  gleich  ist. 

Auskunftsfunktionen 

Mit  diesen  Funktionen  kann  man  jederzeit  gesetzte  Attribute  oder  andere  Parameter  abfragen. 
Escapes 

Spezielle  Fahigkeiten  des  Grafikgerates  konnen  mit  diesen  Funktionen  ausgenutzt  werden. 
Auf  dem  Textbildschirm  etwa  kann  man  mit  den  Escape-Funktionen  eine  Hardcopy  auslosen, 


VDI-Bindings 


Der  VDI-Parameterblock 

Das  VDI  benutzt  zur  Parameteriibergabe  nicht  die  Prozessorregister  oder  den  Stack,  sondem 
mebrere  Ein-  und  Ausgabefelder.  Im  einzelnen  sind  das: 

WORD  contrl [12] ; 

Dieses  Feld  enthalt  folgende  Eingabeparameter: 

contrl[0]:  Opcode  derFunktion  ( Vorsicht :  kann  sich  iiberden  ganzenBereich  von -32768 

bis  32767  erstrecken!) 
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contrl[l]:  Anzahl  der  Eingabekoordinatenpaare 

contrl[3J:  Anzahl  der  Werte  im  intin-Array 

contrl[5]:  Identifikationsnummer  fur  Unter-Opcode 

contrl[6]:  Workstation-Handle 

contrl[7..|:  Mogliche  weitere  Werte,  abhangig  von  der  Funktion 

Zuriick  erhalt  man  folgende  Riickgabewerte: 

contrl[2]:  Anzahl  der  Ausgabekoordinatenpaare 

contrl[4]:  Anzahl  der  Werte  im  intout- Array 

contrl[6]:  Workstation-Handle  (beim  Offnen  der  Workstation) 

contrl[7..]:  Mogliche  weitere  Werte,  abhangig  von  der  Funktion 

WORD  intin 
WORD  intout 

Diese  beiden  Felder  enthalten  Ein-  bzw.  Ausgabeparatneter  -  und  zwar  alle  die,  die  keine 
MaBe  oder  Koordinaten  beschreiben.  Auch  einzelne  Zeichen  und  Zeichenketten  werden  hier 
iibergeben  (indem  die  einzelnen  Zeichen  auf  16-Bit-Werte  expandiert  werden).  Wie  viele 
Werte  maximal  iibergeben  werden  konneri,  hangt  vom  jeweiligen  Treiber  ab  und  kann  mit 
“vq_extnd()”  erfragt  werden. 

WORD  ptsin [...]; 

WORD  ptsout 

Diese  beiden  Felder  enthalten  alle  Parameter,  die  Ma8-  oder  Koordinatencharakter  haben.  Sie 
werden  deshalb  unabhangig  von  “normalen”  Parametem  gefiihrt,  weil  bei  ihnen  gegebenfalls 
die  Koordinatentransformation  zwischen  NDC-  und  RC-System  durchgefiihrt  werden  muB. 
Die  maximal  zu  iibergebende  Anzahl  von  Koordinatenpunkten  ist  nicht  nur  von  wissenschaft- 
licher  Bedeutung,  sondem  legt  die  maximale  Punktzahl  fiir  Linienziige  und  Polygone  fest. 
Wie  viele  Koordinatenpunkte  (also  Wortpaare!)  iibergeben  werden  konnen,  laBt  sich  mittels 
“vq_extnd()”  erfragen.  Die  Adressen  der  ftinf  Parameterfelder  werden  als  Zeiger  im  VDI- 
Parameterblock  abgelegt: 


Adresse 

Inhalt 

PB 

Adresse  des  contrl-Arrays 

PB+4 

Adresse  des  intin- Arrays 

PB+8 

Adresse  des  ptsin-Arrays 

PB+12 

Adresse  des  intout-Arrays 

PB+16 

Adresse  des  ptsout-Arrays 
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Der  VDI-Trap 

Zum  Aufruf  einer  VDI-Funktion  ladt  man  Datenregister  DO  mit  der  Konstante  1 15,  D1  mit 
der  Anfangsadresse  des  VDI-Parameterblocks  und  machteinen  “TRAP  #2”- Aufruf.  Dariiber, 
welche  Register  verandert  werden,  gibt  es  keine  idaren  Informational.  Tatsache  aber  ist,  daB 
die  entsprechenden  Routinen  im  ROM  alle  Register  retten. 

Leider  gibt  es  keinen  dokumentierten  Return-Code  ftir  “Unbekannte  Funktionsnummer”.  Im 
Zweifelsfall  muB  man  sich  also  folgendermaBen  behelfen: 

1 .  Die  “Extended  Inquire  Function”  bietet  bereits  etliche  Informationen  iiber  den  angespro- 
chenen  Treiber  an. 

2 .  Ansonsten  muB  man  den  fragl  ichen  VDI- Aufruf  ausprobieren  und  dann  die  Riickgabewerte 
analysieren.  Vieie  Funktionen  liefem  als  Resultat  den  eingestellten  Wert  zuriick. 
Daneben  kann  man  auch  untersuchen,  ob  contrl[2]  und  contrl[4J  die  korrekten  Zahlen 
enthalten. 


Hier  noch  eine  Ubersicht  iiber  die  moglichen  Opcodes  (also  Werte  fur  DO.W),  die  vom 
Dispatcher  verstanden  werden: 


Opcode 

Funktion 

-2 

Abfrage,  ob  GDOS  vorhanden  ist 

-1 

Nicht  dokumentiert,  aber  vom  GDOS  benotigt:  bei  diesem  Aufruf  liefert  der 
ROM-Bildschirmtreiber  die  Adresse  einer  Funktion  zuriick,  die  das  GDOS 
dann  -  ganz  wie  bei  einem  “normalen”  Bildschirmtreiber  -  per  JSR  aufru- 
fen  kann. 

Wer  sich  in  den  VDI-Trap  einklinken  will,  mufi  auch  diese  Funktionsnum¬ 
mer  abfangen,  damit  ein  eventuell  spater  installiertes  GDOS  wie  beabsich- 
tigt  funktioniert. 

115 

VDI-Aufruf 

200 

AES-Aufruf 

Die  Beispiel-Bindings 

Bei  den  hier  vorliegenden  Beispiel-Bindings  des  Alcyon-Compilers  hat  man  es  sich  recht 
einfach  gemacht  und  den  Parameterblock  kurzerhand  folgendermaBen  deklariert; 

int  *poof f , *ioof f , *pioff , *iioff , *pblock; 
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Da(S  ein  C-Compiler  diese  ftinf  Pointer  direkt  hintereinander  im  Speicher  anlegt,  ist  nicht 
iiberraschend.  Dali  bei  dieser  Deklaration  aber  auch  noch  die  richtige  (namlich  umgekehrte) 
Reihenfolge  herauskommt,  diirfte  ein  implementationsabhangiger  Zufall  sein  -  dieser 
Programmierstil  ist  also  nicht  zur  Nachahmung  empfohlen! 

Was  noch  fehlt,  ist  die  Initialisierung  des  Parameter-Blocks.  Die  letzten  vier  Adressen  werden 
von  “OPEN  WORKSTATION”  bzw.  “OPEN  VIRTUAL  WORKSTATION”  eingesetzt, 
wahrend  die  Funktion  “vdi()”  den  ersten  Wert  setzt  (namlich  “pblock”,  der  den  Zeiger  auf  das 
contrl-Array  enthalt). 

Die  Funktion  “vdi  ()”  hat  eine  vergleichsweise  einfache  Aufgabe: 

-  Die  AdreBregister  AO  und  A1  werden  gerettet. 

-  Die  Anfangsadresse  des  contrl-Arrays  wird  in  “pblock”  eingetragen. 

-  Die  Adresse  von  “pblock”  (also  die  Anfangsadresse  des  VDI-Parameterblocks)  wird  in 
Datenregister  D1  geladen. 

-  Datenregister  DO  wird  mit  der  Zahl  “115”  geladen. 

AbschlieBend  wird  iiber  “TRAP  #2”  GEM  aufgerufen,  und  es  werden  noch  die  beiden 
zuvor  geretteten  AdreBregister  wiederhergestellt. 

Kein  Teil  des  ST/TT-Betriebssystems  ohne  Ausnahmen:  einige  wenige  Funktionen  erwarten 
oder  liefem  32-Bit- Werte.  Da  alle  Ein-  und  Ausgabefelder  jeweils  nur  16-Bit-Wort-Felder 
sind,  muB  man  mit  einem  Kunstgriff  die  Werte  auf  zwei  16-Bit-Variablen  verteilen.  Dazu 
werden  hier  die  Funktionen  “i_ptr”  (schreibt  den  angegebenen  Wert  in  contrl[7]  und 
contrl[8]),  “i_ptr2”  (dasselbe  mit  contrl[9]  und  contrl[10]),  sowie  “m_lptr2”  (iibertragt 
contrl(9]  und  contrl[10]  in  die  angegebene  Adresse)  benutzt. 


VDI-Geratetreiber 

Einleitung 

Ein  Geratetreiber  ist  eine  vollig  normale  Programmdatei  ohne  STARTUP-Code  (z,B.  Spei- 
cherreservierung),  die  als  erste  Routine  jm  Textsegment  (also  an  der  “Einsprungadresse”) 
einen  “Dispatcher”  fur  die  eingehenden  VDI-Aufrufe  enthalt: 
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-  Die  Adresse  des  VDI-Parameterblocks  wird  in  Register  D1  tibergeben. 

-  Die  Funktion  wird  mit  einer  RTS-Instruktion  abgeschlossen, 

Folgendes  muB  man  noch  bei  der  Implementation  eines  Geratetreibers  beachten:  Nicht  alle 
Funktionen  erreichen  den  eigentlichen  Treiber  genauso,  wie  sie  abgesandt  werden,  sondem 
sie  werden  vom  GDOS  “vorverarbeitet”.  Im  einzelnen  sind  dies: 

-  Das  Laden  der  Zeichensatze.  GDOS  ladt  alle  in  der  ASSIGN.SYS-Datei  angegebenen 
Zeichensatze  (sofem  der  Speicher  reicht),  “reloziert”  die  einzelnen  Zeiger  und  verkettet 
alle  Header  iiber  das  “next_font”-Feld  zu  einer  linearen  Liste.  Der  Treiber  erhalt  diese 
vorverarbeiteten  Zeichensatze  im  Rahmen  eines  “  vst  Joad_fonts()”-Aufrufs  mit  der  fol- 
genden,  vom  normalen  Gebrauch  abweichenden  Parameterbelegung: 

contrl[7/8]  Adresse  des  “Scratch”-Puffers  zur  Berechnung  von  Texteffekten 
(wie  kursiv  oder  fett). 

contrl[9]  Lange  dieses  Puffers  in  1 6-Bit- Worten. 

contrl[10/l  1]  Anfangsadresse  des  ersten  Fontheaders  in  der  Zeichensatzliste. 

Dieses  Interface  zum  Laden  der  Zeichensatze  funktioniert  also  ausschliefilich  dann, 
wenn  GDOS  nicht  installiert  ist! 

Der  Treiber  arbeitet  immer  im  Rasterkoordinatensystem.  Die  Konvertierung  der  Werte 
im  ptsin-  und  ptsout-Feld  wird  vom  GDOS  iibemommen. 


Bildschirmtreiber 

Besonderheiten 

Bei  den  aktuellen  TOS-Versionen  findet  sich  der  VDI-Bildschirmtreiber  im  ROM,  kann  aber 
durch  einen  vom  GDOS  nachzuladenden  Treiber  ersetzt  werden. 

Derartige  Treiber  existieren  mittlerweile  fur  diverse  Grafikkarten,  beispielsweise  die  des 
Herstellers  “Matrix”.  Man  beachte,  daB  bei  einigen  auf  dem  Markt  befindlichen  Treibem 
Funktionen  fehlerhaft  implementiert  sind  bzw.  ganz  fehlen. 

( Hinweis :  Erkundigen  Sie  sich  vor  einer  eventuellen  Ansehaffung  nach  der  vollen  Unterstiit- 
zung  von  GEM-Zeichensatzen.) 
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Der  ROM-Bildschirmtreiber  selbst  weist  folgende  Merkmale  auf: 

-  Die  zu  “CELL  ARRAY”  gehorigen  Funktionen  sind  nicht  implementiert  (sind  laut 
Digital  Research  aber  auch  optional). 

-  Einige  der  Eingabefunktionen  arbeiten  nicht  fehlerfrei  (was  keine  schlimme  Einschran- 
kung  ist,  da  sie  von  den  AES  nicht  bendtigt  werden). 

-  Das  ROM-VDI  basiert  auf  dem  Kern  der  sogenannten  “Line-A”-Funktionen,  iiber  die 
das  VDI  samtliche  Ausgaben  abwickelt  (mehr  dazu  spater). 

-  Die  Escape-Routinen  zur  Bildschirmausgabe  sind  mit  den  vom  BIOS  fiir  “CON:”  und 
“RAWCON:”  benutzten  Routinen  identisch  (konnen  allerdings  nicht  wie  ihre  ihreBIOS- 
Gegenstiicke  “umgelenkt”  werden). 

Mmdestfunktionsumfang 

(Spezifikation  nach  Atari,  “GEM  Programmer’s  Guide”) 


Opcode 

Funktion 

1 

Open  workstation 

2 

Close  workstation 

3 

Clear  workstation 

4 

Update  workstation 

5 

Escape-functions 

1 

Inquire  addressable  character  cells 

2 

Exit  alpha  mode 

3 

Enter  alpha  mode 

4 

Cursor  up 

5 

Cursor  down 

6 

Cursor  right 

7 

Cursor  left 

8 

Home  cursor 

9 

Erase  to  end  of  screen 

10 

Erase  to  end  of  line 

11 

Direct  cursor  address 

12 

Output  cursor  addressable  text 

15 

Inquire  current  alpha  cursor  address 

18 

Place  graphic  cursor 

19 

Remove  last  graphic  cursor 
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Opcode 

Funktion 

6 

Polyline 

7 

Polymarker 

8 

Text 

9 

Filled  area 

11 

Generalized  Drawing  Primitive  (GDP) 

1 

Bar 

2 

Arc 

3 

Pie 

4 

Circle 

5 

Ellipse 

6 

Elliptical  arc 

7 

Elliptical  pie 

8 

Rounded  rectangle 

9 

Filled  rounded  rectangle 

10 

Justified  graphics  text 

12 

Set  character  height,  absolute  mode 

14 

Set  color  representation 

15 

Set  polyline  Iinetype 

17 

Set  polyline  color  index 

18 

Set  polymarker  type 

20 

Set  polymarker  color  index 

21 

Set  text  face 

22 

Set  graphic  text  color  index 

23 

Set  fill  interior  style 

24 

Set  fill  style  index 

25 

Set  fill  color  index 

26 

Inquire  color  representation 

28 

Input  locator 

33 

Input  string 

32 

Set  writing  mode 

33 

Set  input  mode 

35 

Inquire  current  polyline  attributes 

36 

Inquire  current  polymarker  attributes 

37 

Inquire  current  fill  area  attributes 

38 

Inquire  current  graphic  text  attributes 

39 

Set  graphic  text  alignment 

100 

Open  virtual  screen  workstation 

101 

Close  virtual  screen  workstation 

102 

Extended  inquire  function 
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Opcode 

Funktion 

104 

Set  fill  perimeter  visibility 

106 

Set  graphic  text  special  effects 

107 

Set  character  cell  height,  points  mode 

108 

Set  polyline  end  styles 

109 

Copy  raster,  opaque 

110 

Transform  form 

111 

Set  mouse  form 

112 

Set  user-defined  fill  pattern 

113 

Set  user-defined  linestyle 

114 

Fill  rectangle 

115 

Inquire  input  mode 

116 

Inquire  text  extent 

117 

Inquire  character  cell  width 

118 

Exchange  timer  interrupt  vector 

121 

Copy  raster,  transparent 

122 

Show  cursor 

123 

Hide  cursor 

124 

Sample  mouse  button  state 

125 

Exchange  button  change  vector 

126 

Exchange  mouse  movement  vector 

127 

Exchange  cursor  change  vector 

128 

Sample  keyboard  state  information 

129 

Set  clipping  rectangle 

130 

Inquire  face  name  and  index 

131 

Inquire  current  face  information 

1m  aktuellen  ROM-Bildschirmtreiber  zusatzlich  implementiert: 


Opcode 

Funktion 

13 

Set  character  baseline  vector 

16 

Set  polyline  width 

19 

Set  polymarker  height 

30 

Input  choice  (fehlerhaft) 

103 

Contour  fill 

105 

Get  pixel 

119 

Load  fonts 

120 

Unload  fonts 
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Line-A-Routinen 

Der  “harte  Kern”  des  ROM-Bildschirmtreibers  ist  der  sogenannte  Line-A-Emulator.  Diese 
Bezeichnung  ist  alierdings  etwas  irrefiihrend,  da  es  auf  Anhieb  nicht  unbedingt  klar  ist,  was 
denn  uberhaupt  emuliert  wird...  Was  macht  die  CPU  des  ST,  wenn  sie  auf  einen  unbekannten 
Befehl  trifft? 

Nun,  sie  lost  einen  TRAP  (Nummer  4,  “illegaler  Befehl”)  aus,  den  der  verwirrte  Benutzer  auf 
dem  Bildschirm  durch  vier  Bombchen  erkennen  kann.  Eine  Ausnahme  bilden  jedoch  die 
Opcodes,  deren  oberste  vier  Bits  ein  “$A"  oder  ein  “$F”  darstellen.  Lauft  die  CPU  in  einen 
solchen  Opcode,  wird  wiederum  eine  spezielle  TRAP-Routine  aufgerufen.  Die  unteren  1 2  Bits 
des  Befehlsworts  kann  man  dann  fiir  eigene  Informationen  verwenden. 

Bis  TOS  1.04  einschlieBlich  werden  F-Opcodes  intern  durch  das  Betriebssystem  fiir  die 
verschiedensten  Zwecke  benutzt,  und  daher  sollte  man  von  ihnen  tunlichst  die  Finger  lassen. 
Die  A-Opcodes  dienen  hingegen  zum  Aufruf  der  wichtigsten  Grafikroutinen  -  man  kann  also 
sagen,  dafi  die  Line-A-Routinen  auf  Maschinenebene  die  Befehle  eines  imaginaren  Grafik- 
Chips  emulieren. 

Die  Architektur  des  Betriebssystems  spricht  alierdings  eindeutig  gegen  die  Benutzung  der 
Line-A-Routinen.  Diese  stellen  namlich  die  untere  Ebene  des  VDI-Bildschirmtreibers  im 
ROM  dar.  Mit  ihrer  V erwendung  verbaut  man  sich  also  eine  eventuelle  Nutzung  eines  anderen 
(schnelleren)  Bildschirmtreibers! 

Auch  ist  eine  Existenz  der  Line-A-Routinen  nur  fiir  die  ST-Modi  (also  320  *  200, 640  *  200 
und  640  *  400)  garantiert.  Schon  bei  256-Farbgrafik  (spezielle  Grafikkarte  bzw.  TT  in  der 
“niedrigen”  Auflosung)  sind  die  Moglichkeiten  der  Line-A-Schnittstelle  erschopft  (siehe 
“COLBITO”  bis  “COLB1T3”). 

Wer  meint,  Line-A-Funktionen  im  Gegensatz  zu  VDI-Funktionen  im  Interrupt  aufrufen  zu 
konnen,  hat  sich  iibrigens  geirrt:  auch  die  Line-A-Funktionen  sind  nicht  re-entrant  (einer  der 
Griinde:  sie  sprechen  -  falls  vorhanden  -  direkt  den  Blitter  an). 

Auch  Zeit  sparen  laBt  sich  entweder  nur  wenig  oder  gar  nicht.  Ein  Beispiel:  die  Line-A- 
Funktion  “Textblt”  kann  tatsachlich  einzelne  Zeichen  schneller  ausgeben  als  das  VDI  -  kein 
Wunder,  macht  doch  der  Bildschirmtreiber  im  ROM  auch  nur  den  gleichen  Line-A-Aufruf 
(alierdings  per  “JSR”  statt  per  Line-A-Ausnahmebehandlung).  Normalerweise  mdchte  man 
jedoch  mehrere  Zeichen  (Worter  oder  ganze  Zeilen)  in  einem  Stiick  ausgeben. 

Das  geht  mit“v_gtext()”  mit  einem  VDI- Aufruf  (eine  Exception-Behandlung),  wahrend  man 
per  Line-A  fiir  jedes  einzelne  Zeichen  eine  (zeitfressende!)  Exception  auslosen  muB. 
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Es  spricht  also  alles  gegen  die  Verwendung  der  Line-A-Routinen.  Wer  will  schon  Programme 
haben,  die  bei  Hardwareanderungen  oder  neuen  Rechnem  dank  der  Verwendung  von  Line- 
A-Routinen  nicht  mehr  funktionstuchtig  sind? 

Zitat  aus  den  TT030  TOS  Release  Notes:  “The  Line-A  graphics  interface  is  maintained  for 
backward  compatibility  with  existing  ST  programs  only.  It  should  not  be  used  for  new  pro¬ 
grams.  It  will  not  keep  pace  with  future  hardware  or  software  improvements.  The  VDI  should 
be  used.” 

Also:  Finger  weg  von  den  Line-A-Routinen,  wenn  es  sich  nicht  gerade  um  ein  systemnahes 
Programm  handelt,  das  sowieso  nur  auf  den  drei  Standard-Grafikmodi  des  ST  funktionieren 
muR. 


Initialization  ($A000) 


Mit  diesem  Aufruf  kann  man  die  Anfangsadressen  der  Line-A-Variablen,  der  Line-A- 
Routinen  und  der  Systemzeiehensatze  erfragen.  Initialisiert  wird  sinnigerweise  gar  nichts !  Zur 
Parameteriibergabe  an  die  Line-A-Routinen  wird  ein  Parameterblock  folgender  Form  ver- 
wendet  (in  Klammem  jeweils  der  Offset  zur  Basisadresse): 


typedef  struct 
{ 


WORD 

WORD 

LONG 

LONG 

LONG 

LONG 

LONG 

WORD 

WORD 

WORD 

WORD 

WORD 

WORD 

WORD 

WORD 

LONG 


PLANES;  /*  Anzahl  der  Bildschirmebenen  (+$00)  */ 

WIDTH;  /*  Bytes  pro  Bildschirmzeile  (+$02)  */ 

CONTRL;  /*  Zeiger  auf  contrl[]  (VDI)  (+$04)  */ 

INTIN;  /*  Zeiger  auf  int_in[]  (VDI)  (+$08)  */ 

PTSIN;  /*  Zeiger  auf  pts_in[]  (VDI)  (+$0C)  */ 

INTOUT;  /*  Zeiger  auf  int_out[]  (VDI)  (+$10)  */ 

PTSOUT;  /*  Zeiger  auf  pts_out[]  (VDI)  (+$14)  */ 

COLBIT0;  /*  Farbwert  fiir  Plane  0  (+$18)  */ 

COLBIT1;  /*  Farbwert  fiir  Plane  1  (+$1A)  */ 

COLBIT2 ;  /*  Farbwert  fiir  Plane  2  (+$1C)  */ 

COLBIT3;  /*  Farbwert  fur  Plane  3  (+$1E)  */ 

LSTLIN;  /*  letzten  Pixel  einer  Linie  zeichnen  (1)  oder 
nicht  zeichnen  (0)  +$20)  */ 

LNMASK;  /*  Muster  fiir  Linien  (+$22)  */ 

WMODE;  /*  VDI-Schreibmodus  (+$24)  */ 

XI, Y1,X2,Y2; 

/*  Koordinatenangaben  (+$26)  */ 

PATPTR;  /*  Zeiger  auf  Fiillmuster  (+$2E)  */ 
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WORD  PATMSK;  /*  dazugehorige  Maske  (+$32)  */ 

WORD  MFILL;  /*  Fiillmuster  monochr . /farbig  (+$34)*/ 

WORD  CLIP;  /*  Clipping  aus/an  (+$36)  */ 

WORD  XMINCL, YMINCL; 

/*  linke  obere  Ecke  des  Clip-rect.  (+$38)  */ 
WORD  XMAXCL, YMAXCL; 

/*  rechte  untere  Ecke  des  Clip-rect.  (+$3C)  */ 
WORD  XDDA;  /*  vor  Textausgaben  auf  0x8000  setzen  (+$40)  */ 
WORD  DDAINC;  /*  Vergroberungsfaktor  -  bei  Vergrofterung: 

256* (Wunschgrofle-Aktuelle) /Aktuelle;  bei 
Verkleinerung:  56* (Wunschgrofte) /Aktuelle 
(+$42)  */ 

WORD  SCALDIR;  /*  Vergrolierungsrichtung  (0:  verkleinern, 

1:  vergrofiern  (+$44)  */ 

WORD  MONO;  /*  Proportionalschrift  ja/nein  (+$46)  */ 

WORD  SOURCEX,  SOURCEY; 

/*  X, Y-Koordinate  im  Zeichensatz  (+$48)  */ 

WORD  DESTX, DESTY; 

/*  Koordinate  des  Zeichens  auf  dem  Bildschirm 
(+$4C)  */ 

WORD  D£LX,DELY; 

/*  Breite  und  Hohe  des  Zeichens  (+$50)  */ 
FONTJHDR  *FRASE; 

/*  Zeiger  auf  Zeichensatz image  (+$54)  */ 

WORD  FWIDTH;  /*  Breite  des  Zeiehensatzimage  (+$58)  */ 

WORD  STYLE;  /*  Schreibstil  (+$5A) 

Bit  0:  Fettschrift 

Bit  1:  Helle  Schrift 

Bit  2:  Kursivschrift 

Bit  3:  Unterstrichene  Schrift 

Bit  4:  Umriilschrift  */ 

WORD  LITEMASK;  /*  Maske  fur  das  Schattieren  (light)  (+$5C)  */ 
WORD  SKEWMASK;  /*  Maske  fur  Italics  (+$5E)  */ 

WORD  WEIGHT;  /*  zusatzliche  Breite  bei  Bold  (+$60)  */ 

WORD  ROFF;  /*  Kursiv-Offset  rechts  (+$62)  */ 

WORD  LOFF;  /*  Kursiv-Offset  links  (+$64)  */ 

WORD  SCALE;  /*  VergroBerung  ja/nein  (+$66)  */ 

WORD  CHUP;  /*  Rotationswinkel  *  10  (+$68)  */ 

WORD  TEXTFG;  /*  Textfarbe  (+$6A)  */ 

LONG  SCRTCHP;  /*  Zeiger  auf  temp.  Buffer  fur  Texteffekte 
(+$6C)  */ 
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WORD  SCRPT2;  /*  Offset  fur  denselben  (+$70)  */ 

WORD  TEXTBG;  /*  Texthintergrundfarbe  (+$72)  */ 

WORD  COPYTRAN;  /*  Flag  fiir  "COPY  RASTER  FORM"  (0:  "opaque", 

1:  "transparent")  (+$74)  */ 

LONG  SEEDABORT; 

/*  Pointer  auf  Routine,  die  nach  jeder 
Bildzeile  eines  "SEEDFILL"  aufgerufen  wird  (+$76)  */ 

}  LINEA; 

In  den  Registem  DO  und  AO  erhalt  man  einen  Zeiger  auf  diesen  Parameterblock.  In  der 
Literatur  werden  haufig  auch  noch  “negative”  Offsets  zur  Line-A-Basisadresse  aufgefiihrt. 
Bei  diesen  Registem  handelt  es  sich  urn  die  lokalen  Variablen  des  Bildschirmtreibers. 

Der  Lese-Zugriff  ist  durch  das  Dokument  “S.A.L.A.D.”  offiziell  durch  Atari  freigegeben 
(dabei  waren  allerdings  die  Offsets  fur  die  Variablen  bis  einschlieBlich  “MASKJFORM” 
falsch  angegeben!)  -  abereben  ausschliefilich  fiir  die  drei  Standard-Grafikmodi  des  Atari  ST, 

Es  sei  also  noch  einmal  darauf  hingewiesen,  daB  man  solche  Eigenschaften  des  ROM- 
Bildschirmtreibers  nur  dann  auszunutzen  sollte,  wenn  das  Programm  auch  sonst  ausschlieB- 
lich  iiber  Line-A  ausgibt.  Auf  keinen  Fall  anstelle  der  jeweiligen  Auskunftsfunktionen  des 
VDI  benutzen!!! 


typedef  struct 
{ 


LONG  RESERVED6 ;  /*  (-$38E)  */ 

FONT  HDR  *CUR  FONT; 


/*  Zeiger  auf  den  Header  des  aktuellen 
Zeichensatzes  (-$38A)  */ 

WORD  RESERVED5 [23] ;  /*  (-$386)  */ 

WORD  M_POS_HX;  /*  X-Koordinate  des  Maus-"Hot  spot" 

(-$358)  */ 


WORD  M_POS_HY; 

WORD  M_PLANES; 

WORD  M_CDB_BG; 

WORD  M_CDB__FG; 

WORD  MASK_FORM [32]  ; 

WORD  INQ  TAB [45j ; 


/*  Y-Koordinate  des  Maus~"Hot  spot" 

(-$356)  */ 

/*  Maus  wird  ira  Replace-Modus  (1)  oder  im 
XOR-Modus  (~1)  gezeichnet  (-$354)  */ 

/*  Maus~Hintergrundfarbe  (~$352)  */ 

/*  Maus-Vordergrundfarbe  (-$350)  */ 

/*  jeweils  abwechselnd  fiir  Vordergrund  und 
Maske  16  Words  (-$34E)  */ 

/*  Informationen,  die  bei  ”vq_extnd()" 
zuriickgeliefert  werden  (-$30E)  */ 
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WORD  DEV_TAB[45] ;  /*  Informationen,  die  man  bei  "v_opnwk () " 

erhalt  (-$2B4)  */ 

WORD  GCURX;  /*  Aktuelle  X-Position  der  Maus  <-$25A)  */ 

WORD  GCORY;  /*  Aktuelle  Y-Position  der  Maus  (-$258)  */ 

WORD  M_HID_CT;  /*  Anzahl  der  erfolgten  "Hide  Mouse1’ - 

Aufrufe  (-$256)  */ 

WORD  MOUSE_BT;  /*  Aktueller  Status  der  Mausknopfe  (-$254)  */ 
WORD  REQ_COL[48] ;  /*  Interne  Daten  fur  "vq_color ( ) "  (-$252)  */ 
WORD  SIZ_TAB[15];  /*  Informationen,  die  bei  "v_opnwk()" 

zuruckgeliefert  werden  (~$1F2)  */ 

WORD  RESERVED 4 [2] ; 

LONG  CUR_WORK;  /*  Zeiger  auf  Attributdaten  der  aktuellen 

virtuellen  Workstation  (-$1D0)  */ 

FONT_HDR  *DEF_FONT; 

/*  Zeiger  auf  den  Standardsystemzeichen- 
satz  (-$1CC)  */ 

LONG  FONTJRING [ 4 ] ;  /*  Drei  Pointer  auf  Zeichensatzlisten 

(verkettete  FONT_HDR-Strukturen.  Das 
letzte  Element  enthalt  eine  0  als 
Endezeichen  (-$1C8)  */ 

WORD  FONT_COUNT;  /*  Anzahl  der  Zeichensatze  in  der 

"F0NT_R1NG"-Liste  (-$1B8)  */ 

WORD  RESERVED 3 (45]; 

CHAR  CUR_MS_STAT;  /*  Mausstatus: 

Bit  0:  linker  Knopf 

Bit  1 :  rechter  Knopf 

Bit  2 . . 4 :  reserviert 

Bit  5:  Bewegungsflag  (1:  Maus  wurde 

bewegt) 

Bit  6:  gesetzt:  Status  des  rechten 

Knopfes  hat  sich 
geandert 

Bit  7:  gesetzt:  Status  des  linken 

Knopfes  hat  sich 
geandert  (-$15C)  */ 

CHAR  RESERVED2 ; 

WORD  V_HID_CNT;  /*  Anzahl  der  Hide-Cursor-Aufrufe  */ 

WORD  CUR__X;  /*  X-Position  der  Maus  (-$158)  */ 

WORD  CUR_Y;  /*  Y-Position  der  Maus  (-$156)  */ 

CHAR  CUR_FLAG;  /*  <>0,  wenn  Mauszeiger  beim  nachsten 

VBlank  neu  gezeichnet  werden  muft  (-$154)  */ 
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CHAR 

LONG 

WORD 

WORD 

LONG 

WORD 


LONG 

LONG 


LONG 

LONG 

LONG 

LONG 

WORD 

WORD 

WORD 

WORD 

WORD 

WORD 

LONG 

WORD 


WORD 

CHAR 

CHAR 

LONG 


MOUSE_FLAG; 

RESERVED 1; 
V_SAV_XY [2] ; 

SAVE_LEN; 

SAVE_ADDR; 

SAVE  STAT; 


SAVE_AREA [64] ; 
USER  TIM; 


NEXTJFIM; 
USER_BUT; 
USER_CUR; 
USER_MOT; 
V_CEL_HT; 
V_CEL_MX;  / 

V_CEL_MY;  / 

V_CEL_WR; 

V_COL__BG; 

V_COL_FG; 

V_CUR_AD'' 

V  CUR  OF; 


V_CUR_XY  [2] ; 
V_PERIOD;  /* 
V_CUR_CT; 

V  FNT  AD; 


/*  <>0,  wenn  Maus-Interruptbehandlung 
eingeschaltet  ist  (-$153)  */ 

/*  gerettete  X-  und  Y-Koordinate  des 
Cursors  (-$14E)  */ 

/*  Anzahl  der  gebufferten  Bildzeilen 
( — $1 4A)  */ 

/*  Adresse  des  ersten  gebufferten  Bytes  im 
Bildspeicher  (-$148)  */ 

/*  Bit  0:  Buffer  ist  giiltig  (1)  Oder 
ungultig  (0) 

Bit  1:  Longs  (1)  Oder  Words  (0) 
gebuffert  (-$144)  */ 

/*  Buffer  fur  Bild  unter  Mauszeiger 
($-142)  */ 

/*  aktueller  Timer-Interrupt-Vektor; 

sollte  zur  Beendigung  zu  "NEXT_TIM" 
springen  (-$42)  */ 

/*  alter  Timer-Interrupt-Vektor  (-$3E)  */ 
/*  Maustastenvektor  (-$3A)  */ 

/*  Mausvektor  (-$36)  */ 

/*  Mausbewegungsvektor  (-$32)  */ 

/*  Zeichenhohe  (-$2E)  */ 

*  maximale  Cursor-Spaltenposition  (-$2C)  */ 

*  maximale  Cursor-Zeilenposition  (-$2A)  */ 
/*  Character-Zeilenbreite  in  Bytes  (Hohe  * 

Breite  einer  Pixelzeile)  (-$28)  */ 

/*  Hintergrundfarbe  (-$26)  */ 

/*  Vordergrundfarbe  (-$24)  */ 

/*  Adresse  der  aktuellen  Cursorposition 
auf  dem  Bildschirm  (-$22)  */ 

/*  Vertikaler  Offset  vom  physikalischen 
Bildschirmanfang  (kann  mit  VDI  ESC  101 
verandert  werden)  (-$1E)  */ 

/*  X-  und  Y-Position  des  Cursors  (-$1C)  */ 
Blinkgeschwindigkeit  des  Cursors  (-$18)  */ 
/*  Zahler  fur  Cursorblinken  (-$17)  */ 

/*  Zeiger  auf  Zeichensatzdaten  des 

Systemzeichensatzes  (siehe  auch  VDI  ESC 
102)  .  Die  Zeichenbreiten  miissen  jeweils 
8  Bytes  betragen!  (-$16)  */ 
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WORD  V_FNT_ND; 

WORD  V_FNT_ST; 

WORD  V_FNT_WD; 

WORD  V_REZ_HZ; 
LONG  V_OFF_AD; 

WORD  RESERVED; 


WORD  V_REZ_VT; 
WORD  BYTES_LIN; 
}  VDIESC; 


/*  ASCII-Wert  des  letzten  Zeichens  im 
Zeichensatz  (-$12)  */ 

/*  ASCII-Wert  des  ersten  Zeichens  im 
Zeichensatz  (-$10)  */ 

/*  Breite  der  Fontdaten  (des  Fontimage)  in 
Bytes  (-$E)  */ 

/*  Bildschirmbreite  in  Pixel  (— $0C)  */ 

/*  Zeiger  auf  Zeichensatz-Offset-Tabelle 
(siehe  VDI  ESC  102)  (-$0A)  */ 

/*  TOS  1.00:  Cursorflag  (-$06) 

Bit  0:  Blinken  aus/ein 

Bit  1:  momentaner  Blinkstatus: 

normal / invert iert 
Bit  2 :  Cursor  unsichtbar/sichtbar 
Bit  3:  Wrapping  am  Zeilenende  ein/aus 
Bit  4:  Inverse  Darstellung  nein/ja 
Bit  5 :  Cursorposition  gespeichert 
nein/ja 

Hat  sich  seither  geandert! ! !  */ 

/*  Bildschirmhohe  in  Pixel  (-$04)  */ 

/*  Bytes  pro  Pixelzeile  (-$02)  */ 


In  A1  erhalt  man  einen  Zeiger  auf  eine  Tabelle  mit  Zeigem  auf  die  Systemzeichensatze, 
Zusatzlich  enthalt  A2  einen  Zeiger  auf  eine  Tabelle  mit  den  Anfangsadressen  der  Line-A- 
Routinen. 


Put  pixel  ($A001) 


Setzt  einen  Punkt  an  den  angegebenen  Koordinaten.  Die  Parameter  miissen  in  den  entspre- 
chenden  Eingabefeldem  des  VDI  gesetzt  werden,  Man  beachte  also  die  Variablen  “INTIN” 


und  “PTSIN”. 


Eingabewerte: 

intinfO]:  Farbe 

ptsin[0]:  X-Koordinate 

ptsin[l]:  Y-Koordinate 
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Get  pixel  ($A002) 

Fragt  die  Farbe  eines  beliebigen  Punktes  auf  dem  Bildschirm  ab. 

Eingabewerte: 

ptsin[0] :  X-Koordinate 

ptsinl  1  ]:  Y-Koordinate 

Ausgabewerte: 

DO:  Farbe  des  gegebenen  Punkts 


Arbitrary  Line  ($A003) 

Zeich.net  eine  Linie  zwischen  zwei  Punkten.  Die  Linie  wird  dabei  immer  von  links  nach  rechts 
gezogen.  Fur  horizontale  Linien  steht  die  schnellere  Funktion  “Horizontal  Line”  ($A004)  zur 
Verfiigung,  die  auch  von  dieser  Funktion  genutzt  wird. 


Eingabewerte: 


XI: 

Yl: 

X2: 

Y2: 

COLBITO 

COLBIT1 

COLBIT2 

COLB1T3 

LNMASK 

WMODE: 


LSTLIN: 


X-Koordinate  des  ersten  Punkts 
Y-Koordinate  des  ersten  Punkts 
X-Koordinate  des  zweiten  Punkts 
Y-Koordinate  des  zweiten  Punkts 
Bitwert  ftir  die  erste  Farbplane 

Bitwert  fur  die  zweite  Farbplane  (nur  bei  Low-  oder  Medium-Res.) 
Bitwert  fur  die  dritte  Farbplane  (nur  bei  Low-Resolution) 

Bitwert  ftir  die  vierte  Farbplane  (nur  bei  Low-Resolution) 
Bitmuster  (Punktmuster)  fiir  die  Linie 
Schreibmodus: 

0:  Replace 

1:  Transparent  (OR) 

2:  Inverse  (XOR) 

3 :  Inverse  Transparent  (XOR  mit  not(LN_MASK)) 

Letzen  Pixel  der  Linie  zeichnen?  (0:  nein,  1 :  ja) 


Ausgabewerte: 

LNMASK:  durch  den  Algorithmus  geshiftet 
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Horizontal  line  ($A004) 


Zeichnet  eine  horizontal  Linie.  Da  diese  Funktion  intern  auch  fur  Flachenfiillroutinen  benutzt 
wird,  ergeben  sich  interessante  weitere  Funktionen. 

So  kann  man  statt  eines  Linienmusters  auch  mehrere  Muster  angeben,  die  dann  alternierend 
in  aufeinanderfolgenden  Zeilen  benutzt  werden.  So  kann  man  sehr  leicht  mit  “Mustem” 
zeichnen. 


Eingabewerte: 


XI: 

Yl: 

X2: 

COLBITO 

COLBIT1 

COLBIT2 

COLBIT3 

WMODE: 


PATPTR: 

PATMSK: 

MFILL: 


X-Koordinate  des  ersten  Punkts 
Y-Koordinate  der  Linie 
X-Koordinate  des  zweiten  Punkts 
Bitwert  fiir  die  erste  Farbplane 

Bitwert  fiir  die  zweite  Farbplane  (nur  bei  Low-  oder  Medium-Res.) 
Bitwert  fiir  die  dritte  Farbplane  (nur  bei  Low-Resolution) 

Bitwert  fiir  die  vierte  Farbplane  (nur  bei  Low-Resolution) 
Schreibmodus: 

0:  Replace 

1 :  Transparent  (OR) 

2:  Invert  (XOR) 

3:  Inverse  Transparent  (XOR  mit  not(Eingabe)) 

Zeiger  auf  ein  Feld  von  Linienmustem  (je  16  Bit) 

Anzahl  der  verschiedenen  Linienmuster 
0:  nur  in  der  ersten  Farbebene 

>0:  alle  Farbebenen 


Filled  rectangle  ($A005) 


Zeichnet  ein  ausgefiilltes  Rechteck. 


Eingabewerte: 

XL  X-Koordinate  der  oberen  linken  Ecke 

Yl:  Y-Koordinate  der  oberen  linken  Ecke 

X2:  X-Koordinate  der  unteren  rechten  Ecke 

Y2:  Y-Koordinate  der  unteren  rechten  Ecke 
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COLBITO:  Bitwert  fur  die  erste  Farbplane 

COLBIT1 :  Bitwert  fur  die  zweite  Farbplane  (nur  bei  Low-  Oder  Medium-Res.) 
COLBIT2:  Bitwert  fur  die  dritte  Farbplane  (nur  bei  Low-Resolution) 
COLBIT3:  Bitwert  fiir  die  vierte  Farbplane  (nur  bei  Low-Resolution) 
WMODE:  Schreibmodus: 


0: 

Replace 

1: 

Transparent  (OR) 

2: 

Invert  (XOR) 

3: 

Inverse  Transparent  (XOR  mit  not(Eingabe)) 

PATPTR: 

Zeiger  auf  ein  Feld  von  Linienmustem  (je  16  Bit) 

PATMSK: 

Anzahl  der  verschiedenen  Linienmuster 

MFDLL: 

0: 

nur  in  der  ersten  Farbebene 

>0: 

alle  Farbebenen 

CLIP: 

Clipping:  0:  aus,  1 :  an 

XMINCL: 

Oberer  Rand  des  Clip-Rechtecks 

XMAXCL: 

Unterer  Rand  des  Clip-Rechtecks 

YMINCL: 

Linker  Rand  des  Clip-Rechtecks 

YMAXCL: 

Rechter  Rand  des  Clip-Rechtecks 

!  Filled polygon($A006) 


Die  Bezeichnung  dieser  Funktion  ist  ein  wenig  irrefiilirend,  da  lediglich  eine  Zeile  des  Poly¬ 
gons  gefiillt  wird. 

Um  das  gesamte  Polygon  zu  fUllen,  muR  man  also  die  Funktion  mehrfach  aufrufen. 

Im  ptsin[]-Feld  werden  die  Koordinaten  der  Eckpunkte  angegeben.  Als  letzter  Punkt  muR 
natiirlich  noch  mal  der  Anfangspunkt  angegeben  werden,  da  man  sonst  keine  geschlossene 
Figur  erhalt. 


Eingabewerte: 


ptsin[]: 

control]: 

Yl: 

COLBITO 

COLBIT1 

COLBIT2 

COLBIT3 


Enthalt  die  Koordinaten  der  Eckpunkte  des  Polygonzugs 
Anzahl  der  Koordinaten  in  ptsin[] 

Y-Koordinate  der  zu  zeichnenden  Linie 
Bitwert  fiir  die  erste  Farbplane 

Bitwert  fiir  die  zweite  Farbplane  (nur  bei  Low-  oder  Medium-Res.) 
Bitwert  fiir  die  dritte  Farbplane  (nur  bei  Low-Resolution) 

Bitwert  fiir  die  vierte  Farbplane  (nur  bei  Low-Resolution) 
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WMODE: 


PATPTR: 

PATMSK: 

MFILL: 

CLIP: 

XMINCL: 

XMAXCL: 

YMINCL: 

YMAXCL: 


Schreibmodus: 

0:  Replace 

1 :  Transparent  (OR) 

2:  Invert  (XOR) 

3:  Inverse  Transparent  (XOR  mit  not(Eingabe)) 

Zeiger  auf  ein  Feld  von  Linienmustem  (je  16  Bit) 
Anzahl  der  verschiedenen  Linienmuster 
0:  nur  in  der  ersten  Farbebene 

>0:  alle  Farbebenen 

Clipping  (0:  aus,  1:  an) 

Oberer  Rand  des  Clip-Rechtecks 
Unterer  Rand  des  Clip-Rechtecks 
Linker  Rand  des  Clip-Rechtecks 
Rechter  Rand  des  Clip-Rechtecks 


Ausgabewerte: 

XI  und  X2  werden  verandert;  AO  wird  zerstort 


Bitblt  (Bit  Block  Transfer)  ($A007) 


Dies  ist  die  Grundfunktion  fur  “Text  Block  Transfer”  ($A008)  und  “Copy  raster  form” 
($AOOE).  Einziger  Eingabewert  fiir  diese  Funktion  ist  das  AdreSregister  A6,  das  einen  Zeiger 
auf  eine  BITBLT-Struktur  enthalten  muft: 

typedef  struct  { 

WORD  B__WD;  /*  Breite  des  Blocks  in  Pixeln  */ 

WORD  B_HT;  /*  Hohe  des  Blocks  in  Pixeln  */ 

WORD  PLANE_CT;  /*  Anzahl  der  Farbplanes;  wird  durch  "Bitblt" 
zerstort  */ 

WORD  FG__COL;  /*  Vordergrundfarbe;  wird  durch  "Bitblt" 
zerstort  */ 

WORD  BG_COL;  /*  Hintergrundfarbe;  wird  durch  "Bitblt" 
zerstort  */ 

LONG  OP_TAB;  /*  Logische  Verkniipfungen  fiir  alle  vier 
Kombinationen  von  Vordergrund-  und 
Hintergrundbits  (siehe  die  16  raoglichen 
Verkniipfungen  fiir  Blitter-Operationen)  */ 

/*  X-Koordinate  des  Quellrasters  */ 


WORD  S  XMIN; 
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WORD 

LONG 

WORD 

WORD 

WORD 

WORD 

WORD 

LONG 

WORD 

WORD 

WORD 

LONG 

WORD 
WORD 
WORD 
CHAR 
}  BITBLT; 


S__YMIN;  /*  Y-Koordinate  des  Quellrasters  */ 

SJFORM;  /*  Anfangsadresse  des  Quellrasters  */ 

S_NXWD;  /*  Offset  zum  nachsten  Wort  in  der  gleichen 
Plane  (HighRez  2,  MedRez  4,  LowRez  8)  */ 
S_NXLN;  /*  Breite  des  Quellrasters  in  Bytes  */ 

S_NXPL;  /*  Offset  zur  nachsten  Plane  (beim  ST  immer  2)  */ 
D__XMIN;  /*  X-Koordinate  des  Zielrasters  *7 

D_YMIN;  /*  Y-Koordinate  des  Zielrasters  */ 

D_FORM;  /*  Anfangsadresse  des  Zielrasters  */ 

D_NXWD;  /*  Offset  zum  nachsten  Wort  in  der  gleichen 
Plane  (Zielraster)  */ 

DJNXLN;  /*  Breite  des  Zielrasters  in  Bytes  */ 

D_NXPL;  /*  Offset  zur  nachsten  Plane  (beim  ST  immer  2)  */ 
P_ADDR;  /*  Zeiger  auf  16-Bit-Masken,  mit  denen  jeweils 
undiert  wird.  (0  =  keine  Maske)  */ 

P_NXLN;  /*  Hohe  der  Maske  in  Bytes  (eine  Potenz  von  2)  */ 
P_NXPL;  /*  Zeiger  auf  nachste  Plane  in  der  Maske  */ 
P_MASK;  /*  Hohe  der  Maske  in  Zeilen  */ 

SPACE  [24];/*  interner  Arbeit sbereich  fur  "Bitblt"  */ 


Bemerkungen 

Clipping  findet  nicht  statt.  Weiterhin  wird  nicht  getestet,  ob  die  angegebenen  Ausschnitte 
tatsachlich  innerhalb  der  benutzten  Memory-Form  liegen. 


TextBIt  (Text  Block  Transfer)  ($A008) 


Dies  ist  eine  universelle  Routine  zur  Ausgabe  von  einzelnen  Zeichen  auf  dem  Bildschirm.  Zu 
ihren  vielfaltigen  Funktionen  zahlen  die  Drehung  von  Zeichen  (in  90-Grad-Schritten), 
verschiedene  Textattribute  und  diverse  SchriftgroGen.  Bei  “TextBIt”  ergeht  es  einem  nicht 
anders  als  bei  anderen  “Monster-Routinen”  des  Betriebssystems  -  je  universeller,  desto  mehr 
Register  mufi  man  setzen  und  desto  umstandlicher  ist  die  Handhabung. 

Bevor  wir  uns  aber  auf  die  einzelnen  Eingabeparameter  stiirzen,  seien  noch  ein  paar  Worte 
zum  Aufbau  eines  Zeichensatzes  gesagt. 

Von  “konventionellen”  Rechnem  war  man  an  einen  sehr  einfachen  Aufbau  von  Zeichensatzen 
gewohnt.  Da  hatten  alle  Zeichen  die  gleiche  Breite  und  Hohe,  besondere  Schriftattribute 
wurden  -  wenn  iiberhaupt  verfiigbar-  von  der  Hardware  erzeugt,  und  verschiedene,  gleich- 
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zeitig  ver  wendbare  Zeichensatze  waren  ilberhaupt  kein  Thema.  Ganz  anders  ist  es  unter  TOS . 
Dadurch,  dad  alle  Bildschirmausgaben  im  Grafikmodus  erfolgen,  kann  das  Betriebssystem 
verschiedene  Textattribute  (wie  Fettschrift  oder  kursiv)  direkt  unterstutzen.  Zusatzlich  wol- 
len  auch  noch  Dinge  wie  Proportionalschrift  verwaltet  sein.  Womit  wir  schon  beim  Problem 
angelangt  sind  -  wie  legt  man  moglichst  speicherplatzsparend  einen  Zeichensatz  im  Speicher 
ab?  Atari  hat  folgende  Losung  gewahlt:  der  Zeichensatz  wird  einfach  als  groBes  “Bild” 
betrachtet,  dessen  Hohe  die  Zeichenhohe  und  dessen  Breite  die  Sum-me  aller  Zeichenbreiten 
ist. 

Alle  Zeichen  stehen  in  diesem  “Fontimage”  direkt  nebeneinander.  Auf  diese  Weise  geht  zwar 
kein  einziges  Bit  verloren,  dafiir  muB  aber  die  Position  eines  jeden  Zeichens  erst  mittels  einer 
Offset-Tabelle  berechnet  werden.  Fur  GEM-Zeichensatze  gibt  es  ein  Standard-Dateiformat, 
wie  es  zum  Beispiel  auch  von  GDOS  gelesen  wird  (siehe  dazu  Einfiihrung  ins  VDI).  Damit 
ist  die  Zeichenausgabe  auf  das  Kopieren  eines  Ausschnitts  aus  einem  imaginaren  Bildschirm 
(dem  Zeichensatz)  auf  den  tatsachlichen  Bildschirm  reduziert  -  und  dafiir  gibt  es  ja  andere 
Routinen. 


Eingabewerte: 

WMODE:  Schreibmodus: 

0: 

Replace 

1: 

Transparent  (OR) 

2: 

Invert  (XOR) 

3: 

Inverse  Transparent  (XOR  mit  not(Eingabe)) 

4—19:  Bitblt-Modi  0-15 

CLIP: 

Clipping  aus  (0)  oder  an  (I) 

XMINCL: 

Oberer  Rand  des  Clip-Rechtecks 

XMAXCL: 

Unterer  Rand  des  Clip-Rechtecks 

YMINCL: 

Linker  Rand  des  Clip-Rechtecks 

YMAXCL: 

Rechter  Rand  des  Clip-Rechtecks 

XDDA: 

Vor  jedem  Aufruf  auf  $8000  setzen 

DDAINC: 

VergroBerungsfaktor 

SCALDIR: 

VergroBerungsrichtung 

MONO: 

0:  Zeichen  konnen  verschiedene  Breiten  haben  (wg.  Texteffekten 

SOURCEX: 

oder  Proportionalschrift) 

1 :  Alle  Zeichen  haben  die  gleiche  Breite 

X-Position  des  Zeichens  im  Fontimage  (Berechnung:  zunachst  vom 

SOURCEY: 

ASCII-Wert  “first_ade”  abziehen  und  diesen  Wert  dann  als  Index  in  die 
Offset-Tabelle  “offjable”  verwenden) 

Y-Position  des  Zeichens  im  Fontimage.  Gewohnlich  0. 

DESTX: 

X-Zielkoordinate 
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DESTY: 

Y-Zielkoordinate 

DELX: 

Breite  des  Zeichens  (dazu  subtrahiert  man  die  X-Position  von  der  X- 
Position  des  folgenden  Zeichens) 

DELY: 

Hohe  des  Zeichens  (ublicherweise  “form_height”) 

FBASE: 

Zeiger  auf  Zeichensatzdaten  (“dat_table”) 

FWIDTH: 

Breite  des  Zeichensatzimage  (“fotm_width”) 

STYLE: 

Texteffekte:  Bit  0:  Fettschrift 

Bit  1 :  Helle  Schrift 

Bit  2:  Kursivschrift 

Bit  3:  Unterstrichen  (wird  ignoriert) 

Bit  4:  Unuissene  Schrift  (“outline”) 

LITEMASK: 

Maske  fiir  helle  Schrift  (“lighten”) 

SKEWMASK: 

Maske  fiir  Kursivschrift  (“skew”) 

WEIGHT: 

Zusatzliche  Breite  fiir  Fettschrift  (“thicken”) 

ROFF; 

Rechter  Offset  des  Zeichens  bei  Kursivschrift  (“right_offset”) 

LOFF: 

Linker  Offset  des  Zeichens  bei  Kursivschrift  (“left_offset”) 

SCALE: 

Scaling  aus  (0)  Oder  ein  (1) 

CHUP: 

Schriftrichtung  in  1/10  Grad  (also  0,  900,  1800  oder  2700) 

TEXTFG: 

Textfarbe 

SCRTCHP: 

Zeiger  auf  einen  Buffer,  der  zur  Erzeugung  der  Texteffekte  benotigt 
wird  (2  *  Maximalgrofie  eines  Zeichens) 

SCRPT2: 

Offset  zur  Mitte  des  Buffers  (=1/2  der  Lange  des  Buffers) 

TEXTBG: 

Texthintergrundfarbe 

Show  mouse  ($A009) 

Diese  Routine  istdiedirekteEntsprechung  der“Show  Cursor”-Funktion  des  VDI(“v„show_c()”) 
und  dient  zum  Einschalten  des  Mauscursors.  Intern  wird  mitgezahlt,  wie  oft  die  Maus  vorher 
abgeschaltet  worden  ist,  so  daB  man  gegebenenfalls  die  Aufrufe  verschachteln  kann .  Die  Maus 
wird  nur  dann  angezeigt,  wenn  dieser  interne  Zahler  wieder  auf  0  steht.  Diesen  Mechanismus 
kann  man  allerdings  mittels  des  Parameters  in  intinfO]  ausschalten. 


Eingabeparameter: 

intin[0]:  0:  Maus  auf  jeden  Fall  wieder  einschalten 

>0:  normale  Arbeitsweise 

Bemerkungen 

Die  Line-A-Zeiger  auf  die  VDI-Eingabefelder  miissen  natiirlich  auch  korrekt  gesetzt  sein! 
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Hide  mouse  ($A00A) 


Pendant  zur  vorhergehenden  Funktion  (schaltet  den  Mauscursor  aus). 


Transform  mouse  ($AO0B) 


Mit  dieser  Funktion  kann  man  das  Erscheinungsbild  der  Maus  andem.  Im  intinf]-Feld  wird 
eine  MFORM-Struktur  erwartet. 


Die  einfachste  Art  der  Parameteriibergabe  1st,  sich  zunachst  den  alten  Zeiger  auf  das  intin  []- 
Feld  zu  merken  (INTIN)  und  mit  einem  Zeiger  auf  die  MFORM-Struktur  zu  uberschreiben. 
Nach  Ausfiihrung  der  Funktion  stellt  man  dann  den  Vektor  wieder  her. 

Die  Mausform-Struktur  sieht  folgendermaBcn  aus: 

typedef  struct 
{ 

WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
)  MFORM; 

Der  Aktionspunkt  ist  dabei  die  Stelle  innerhalb  des  Mauscursors,  auf  die  sich  alle  Maus-Koor- 
dinatenangaben  beziehen.  Beim  einfachen  Pfeil  liegt  der  Aktionspunkt  beispielsweise  in  der 
linken  oberen  Ecke  (0,0). 


mf  xhot; 

/* 

mf  yhot; 

/* 

mf  nplanes; 

/* 

mf  fq; 

/* 

mf  bg; 

/* 

mf  mask [16]; 

/* 

mf__data[16] ; 

/* 

/*  Aktionspunkt  X-Koordinate  */ 
/*  Aktionspunkt  Y-Koordinate  */ 
auf  1  setzen  */ 

Maskenfarbe  */ 

Cursorfarbe  */ 

Maskendaten  (16*16  Punkte)  */ 
Cursordaten  (16*16  Punkte)  */ 


Undraw  sprite  ($A00C) 


Loscht  ein  mit  “DRAW  SPRITE”  gezeichnetes  Sprite  vom  Bildschirm  und  stellt  den  Hinter- 
grund  wieder  her.  Die  Funktion  erwartet  in  A2  einen  Zeiger  auf  den  Sprite-Save-Block  (siehe 
“DRAW  SPRITE”).  Register  A6  wird  zerstort. 
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Draw  sprite  ($A00D) 


Zeichnet  ein  bis  zu  1 6*  1 6  Punkte  groBes  Sprite  auf  dem  Bildschirm.  Register  A6  wird  zerstort. 


Eingabewerte: 

DO:  X-Koordinate  des  Aktionspunktes  des  Sprites  auf  dem  Bildschirm 

Dl:  Y-Koordinate 

AO:  Zeiger  auf  SDB-Struktur 

A2:  Zeiger  auf  Sprite-Save-Buffer  (GroBe  in  Bytes:  10+64  *  Anzahl  der  Farbebenen).  Die 
Adresse  dieses  Buffers  muB  auch  an  “UNDRAW  SPRITE”  iibergeben  werden. 


typedef  struct 


WORD  xhot  ? 

WORD  yhot ; 

WORD  form; 

WORD  bgcol; 
WORD  fgcol; 
WORD  image [ 32 ] ; 
1  SDB; 


/*  X-Koordinate  des  Aktionspunkts  */ 
/*  Y-Koordinate  des  Aktionspunkts  */ 
/*  1:  VDI-Format,  -1:  XOR-Format  */ 
/*  Hintergrundfarbe  */ 

/*  Vordergrundfarbe  */ 

/*  Sprite- Image  */ 


In  den  Sprite-Daten  wechseln  sich  jeweiis  ein  Wort  fur  den  Vordergrund  und  ein  Wort  fiir  den 
Hintergrund  ab.  Es  ergeben  sich  folgende  Verkntipfungen  (old  sei  der  bisherige  Pixelwert  des 
Bildpunkts): 


Vordergr.-Bit 

Hintergr.-Bit 

VDI-Format 

XOR-Format 

0 

0 

new=old 

new=old 

0 

1 

new=bgcol 

new=bgcol 

1 

0 

new^fgcoi 

new-fgcol  xor  old 

1 

1 

new-fgco] 

new=fgcol 

Copy  raster  form  ($A00E) 


Diese  Funktion  entspricht  exakt  der  VDI-Funktion  “COPY  RASTER,  OPAQUE”,  mit  der 
Ausnahme,  daB  das  contrl[]-Feld  nicht  vollstandig  gesetzt  und  kejne  Workstation  geoffhet  zu 
werden  braucht.  Man  muB  lediglich  die  Elemente  im  ptsin[]-Feld  und  contrlf7-10]  ausfiillen. 
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Seedfill  ($AOOF) 


Entspricht  exakt  der  VDI-Funktion,  mit  folgenden  Ausnahmen: 

-  Man  braucht  keine  Workstation  zu  offnen. 

-  Die  Clipping- Variablen  miissen  gesetzt  werden. 

-  SEEDABORT  ist  ein  Zeiger  auf  eine  Routine,  die  am  Ende  jeder  Bildschirmzeile  einmal 
aufgerufen  wird.  Liefert  sie  in  DO  einen  Wert  ungleich  0  zuriick,  wird  der  Fiillvorgang 
abgebrochen. 


Plottertreiber 

Einleitung 

GDOS-PIottertreiber  fiir  den  Atari  gibt  es  meines  Wissens  bislang  nicht.  Ich  wiirde  mich 
allerdings  geme  eines  Besseren  belehren  lassen! 

Mindestfunktionsumfang 

(Spezifikation  nach  Atari,  “GEM  Programmer’s  Guide”) 


Opcode 

Funktion 

1 

Open  workstation 

2 

Close  workstation 

3 

Clear  workstation 

4 

Update  workstation 

5 

Escape-functions 

1 

Inquire  addressable  character  cells 

6 

Polyline 

7 

Polymarker 

8 

Text 

9 

Filled  area 

11 

Generalized  Drawing  Primitive  (GDP) 

1 

Bar 

2 

Arc 

3 

Pie 
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Opcode 


Funktion 


4 

5 

6 

7 

8 
9 

10 

12 

15 

17 

18 
20 
21 
22 

23 

24 

25 

35 

36 

37 

38 

39 
102 
104 

107 

108 
116 
117 

130 

131 


Circle 

Ellipse 

Elliptical  arc 

Elliptical  pie 

Rounded  rectangle 

Filled  rounded  rectangle 

Justified  graphics  text 

Set  character  height,  absolute  mode 

Set  polyline  linetype 

Set  polyline  color  index 

Set  polymarker  type 

Set  polymarker  color  index 

Set  text  face 

Set  graphic  text  color  index 

Set  fill  interior  style 

Set  fill  style  index 

Set  fill  color  index 

Inquire  current  polyline  attributes 

Inquire  current  polymarker  attributes 

Inquire  current  fill  area  attributes 

Inquire  current  graphic  text  attributes 

Set  graphic  text  alignment 

Extended  inquire  function 

Set  fill  perimeter  visibility 

Set  character  cell  height,  points  mode 

Set  polyline  end  styles 

Inquire  text  extent 

Inquire  character  cell  width 

Inquire  face  name  and  index 

Inquire  current  face  information 


Druckertreiber 

Besonderheiten 

GDOS-Druckertreiber  gibt  es  mittlerweise  in  alien  Formen  und  Farben  -  angefangen  beim 
Epson-kompatiblen  bis  zum  Atari-Laserdrucker.  Selbst  Treiber  fur  HP-Laserdrucker  und 
Postscript-Ausgabegerate  wurden  schon  gesichtet. 
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Eingetragene  Entwickler  konnen  bei  Atari  das  sogenannte  “Treiber-EntwickJungs-Paket” 
bekommen.  Es  besteht  aus  einer  kompletten  Bibliothek,  die  nur  noch  um  einige  wenige 
druckerspezifische  Funktionen  erweitertwerdenmuB,umeinenTreiberfureinenmonochromen, 
grafikfahigen  Drucker  zu  erzeugen.  Bei  der  Arbeit  mit  VDI-Druckertreibem  beachte  man,  daB 
nicht  alle  Treiber  funktional  vollig  identisch  sind.  Bei  Verwendung  des  Lasertreibers  gibt  es 
nicht  nur  zusatzliehe  Funktionen,  sondem  einige  bestehende  wurden  auch  teilweise  erweitert. 
Auf  Unterschiede  wird  bei  den  einzelnen  Funktionen  jeweils  getrennt  hingewiesen. 

SchlieBlich  sei  noch  einmal  auf  die  erst  ab  GEM  2.0  dokumentierten  Escape-Funktionen 
“v_q_scan()”  und  “v_alpha  _text()”  hingewiesen,  die  eine  sehr  einfache  Moglichkeit  zur  stan- 
dardisierten  Textausgabe  liefem. 

Mindestfunktionsumfang 

(Spezifikation  nach  Atari,  “GEM  Programmer’s  Guide”) 


Opcode 

Funktion 

1 

Open  workstation 

2 

Close  workstation 

3 

Clear  workstation 

4 

Update  workstation 

5 

Escape-functions 

1 

Inquire  addressable  character  cells 

20 

Form  advance 

21 

Output  window 

22 

Clear  display  list 

23 

Output  bit  image  file 

6 

Polyline 

7 

Polymarker 

8 

Text 

9 

Filled  area 

11 

Generalized  Drawing  Primitive  (GDP) 

1 

Bar 

2 

Arc 

3 

Pie 

4 

Circle 

5 

Ellipse 

6 

Elliptical  arc 

7 

Elliptical  pie 

8 

Rounded  rectangle 
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Opcode 

Funktion 

9 

Filled  rounded  rectangle 

10 

Justified  graphics  text 

12 

Set  character  height,  absolute  mode 

15 

Set  polyline  linetype 

17 

Set  polyline  color  index 

18 

Set  polymarker  type 

20 

Set  polymarker  color  index 

21 

Set  text  face 

22 

Set  graphic  text  color  index 

23 

Set  fill  interior  style 

24 

Set  fill  style  index 

25 

Set  fill  color  index 

26 

Inquire  color  representation 

32 

Set  writing  mode 

35 

Inquire  current  polyline  attributes 

36 

Inquire  current  polymarker  attributes 

37 

Inquire  current  fill  area  attributes 

38 

Inquire  current  graphic  text  attributes 

39 

Set  graphic  text  alignment 

102 

Extended  inquire  function 

104 

Set  fill  perimeter  visibility 

106 

Set  graphic  text  special  effects 

107 

Set  character  cell  height,  points  mode 

108 

Set  polyline  end  styles 

112 

Set  user-defined  fill  pattern 

116 

Inquire  text  extent 

117 

Inquire  character  cell  width 

129 

Set  clipping  rectangle 

130 

Inquire  face  name  and  index 

131 

Inquire  current  face  information 

Metafile-Treiber 

Einleitung 

Der  Metafile-Treiber  ermoglicht  es,  VDI-Befehle  in  gerateunabhangiger  Form  in  eine  Datei 
zu  schreiben.  Der  so  erzeugte  Metafile  enthalt  eine  “Aufzeichnung”  aller  getatigten  VDI- 
Aufrufe  inklusive  aller  Parameter, 
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Format  von  Metafiles 

Wer  Metafiles  lesen  konnen  will,  muB  das  Format  des  Metafile-Headers  kennen: 


typedef  struct 

{ 

WORD  mf_header; 
WORD  mf_hlength; 
WORD  mf  version; 


WORD  mf_ndcrcfl; 
WORD  mf_extents [4 ] ; 


WORD  mf_pagesz [2] ; 


WORD  mf  coords [4]; 


WORD  mf_imgflag; 


WORD  mf_resvd [ 9] ; 

}  METAHDR; 


/*  -1  (Metafile-Kennung)  */ 

/*  Lange  des  Headers  in  Integers  (24)  */ 
/*  bei  der  aktuellen  Version  101 
(Version  1.01),  Forrael: 
100*Hauptnummer+Unternummer  */ 

/*  NDC/RC-Flag  (0  oder  2)  */ 

/*  optional  -  maximale  Ausmafie  der 
Grafik  -  konnen  mit 
"v_meta_extents () "  gesetzt  werden 
(sonst  mit  0  gefullt)  */ 

/*  optional  -  Seitengrofle  in  1/10  mm  - 
kann  mit  "vmjpagesize () "  gesetzt 
werden  (sonst  mit  Nullen  gefullt)  */ 
/*  optional  -  Koordinatensystem  -  kann 
mit  "vm_coords ( ) "  gesetzt  werden 
(sonst  mit  Nullen  gefullt)  */ 

/*  falls  Bit  0=1,  so  enthalt  die  Datei 
Bitimages,  sonst  nicht.  Die  anderen 
Bits  sind  immer  0.  */ 

/*  zur  Zeit  unbenutzt  */ 


Beim  Lesen  der  Metafiles  wird  keine  feste  Lange  benutzt.  Vielmehr  liest  eine  Applikation  erst 
die  ersten  beiden  Worter  und  damit  die  Lange  des  Headers.  Anschliefiend  wird  der  Rest  des 
Headers  gelesen.  Es  folgen  dann  “beliebig”  viele  Eintrage  folgender  Form  : 


Wort 

Inhalt 

Belegung 

0 

contrl[0] 

VDI-Befehlsnummer 

1 

control] 

Anzahl  der  Werte  im  ptsin[]-Feld 

2 

contrl[3] 

Anzahl  der  Werte  im  intin[]-Feld 

3 

contrl[5] 

Unterfunktionsnummer 

ab  4 

ptsin[] 

Alle  belegten  Felder  des  ptsin[]-Feldes 

es  folgt 

intin[] 

Alle  belegten  Felder  des  intin[]-Feldes 
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Speziell  behandelt  werden  die  Funktionen  “v_opnwk()”,  die  die  Datei  offnet  und  alle 
Standard- Attribute  als  Aufrufe  von  Attributfunktionen  in  die  Datei  schreibt,  “v._dswk()’\  die 
als  Endekennung  eine  “-1”  in  die  Datei  schreibt,  und  einige  Escapefunktionen,  die  Werte  in 
den  Header  der  Metadatei  eintragen  (oder  sie  umbenennen). 

Fehler  bei  der  Ausgabe  in  Dateien  werden  auf  ausgesprochen  humorvolle  Weise  beanstandet 
-  in  “ptsoutfOJ”  und  “ptsoutflj”  werden  die  Ziffem  “987”  bzw.  “654”  geschrieben  ( nicht 
offiziell  dokumentiert!).  Was  Digital  Research  sich  dabei  gedacht  hat,  wird  wohl  fur  immer 
ein  Ratsel  bleiben.  Unbedingt  zu  beachten  ist  femer,  dafi  alle  Worter  im  Intel-Format  (also 
High-  und  Low-Byte  vertauscht)  abgelegt  werden! 

Erweiterte  Opcodes 

Der  Hauptzweck  von  Metafiles  ist  der  standardisierte  Datenaustausch  zwischen  GEM- 
Applikationen.  Die  PC-Version  von  GEM  wird  von  deutschen  Softwarehaus  CCP  gepflegt, 
das  auch  das  bekannte  Anwendungsprogramm  “GEM  Artline”  entwickelt  hat. 

Viele  Atari-Programme  bemiihen  sich,  GEM/3-kompatible  Metafiles  lesen  und  schreiben  zu 
konnen.  Die  Unterschiede  zum  oben  beschriebenen  Formatergeben  sich  ausschlieBlich  durch 
das  mogliche  Auftreten  von  Opcodes  neuer  VDI-Funktionen  (wie  etwa  Bezierkurven  oder 
Grauraster).  GEM/4  (in  Artline  2)  kennt  weitere  Funktionen  wie  etwa  zum  Setzen  von  Farb- 
verlaufen. 

Daher  ist  es  leider  nicht  moglich,  an  dieser  Stelle  exakt  und  vollstandig  zu  beschreiben,  was 
alles  in  einem  Metafile  stehen  kann  -  das  hangt  ausschlieBlich  davon  ab,  welches  Programm 
die  Datei  erzeugt  und  welches  sie  einlesen  konnen  soil.  Im  Zweifelsfall  mul?>  man  bei  Digital 
Research  die  aktuellen  Entwicklerunterlagen  zu  PC-GEM  erwerben. 

Vielleicht  ringt  sich  Atari  eines  Tages  selbst  zu  einer  iiberarbeiteten  Spezifikation  durch. 

Mindestfunktionsumfang 

(Spezifikation  nach  Atari,  “GEM  Programmer’s  Guide”) 


Opcode 

Funktion 

1 

Open  workstation 

2 

Close  workstation 

3 

Clear  workstation 

4 

Update  workstation 

5 

Escape-functions 
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Opcode 

Funktion 

1 

Inquire  addressable  character  cells 

2 

Exit  alpha  mode 

3 

Enter  alpha  mode 

20 

Form  advance 

21 

Output  window 

22 

Clear  display  list 

23 

Output  bit  image  file 

98 

Update  metafile  extents 

99 

Write  metafile  item 

100 

Change  GEM  VDI  filename 

6 

Polyline 

7 

Polymarker 

8 

Text 

9 

Filled  area 

11 

Generalized  Drawing  Primitive  (GDP) 

1 

Bar 

2 

Arc 

3 

Pie 

4 

Circle 

5 

Ellipse 

6 

Elliptical  arc 

7 

Elliptical  pie 

8 

Rounded  rectangle 

9 

Filled  rounded  rectangle 

10 

Justified  graphics  text 

12 

Set  character  height,  absolute  mode 

13 

Set  character  baseline  vector 

14 

Set  color  representation 

15 

Set  polyline  linetype 

16 

Set  polyline  line  width 

17 

Set  polyline  color  index 

18 

Set  polymarker  type 

19 

Set  polymarker  height 

20 

Set  polymarker  color  index 

21 

Set  text  face 

22 

Set  graphic  text  color  index 

23 

Set  fill  interior  style 

24 

Set  fill  style  index 

25 

Set  fill  color  index 
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Opcode 

i 

Funktion 

26 

Inquire  color  representation 

32 

Set  writing  mode 

35 

Inquire  current  polyline  attributes 

36 

Inquire  current  polymarker  attributes 

37 

Inquire  current  fill  area  attributes 

38 

Inquire  current  graphic  text  attributes 

39 

Set  graphic  text  alignment 

102 

Extended  inquire  function 

103 

Contour  fill 

104 

Set  fill  perimeter  visibility 

106 

Set  graphic  text  special  effects 

107 

Set  character  cell  height,  points  mode 

108 

Set  polyline  end  styles 

112 

Set  user-defined  fill  pattern 

113 

Set  user-defined  line  style  pattern 

114 

Fill  rectangle 

117 

Inquire  character  cell  width 

129 

Set  clipping  rectangle 

131 

Inquire  current  face  information 

Kameratreiber 

Einleitung 

Treiber  fur  die  “Polaroid  Palette”  sind  nicht  erhaltlich  und  werden  wohl  auch  nicht  mehr 
implementiert  werden  (aber  wer  weiB...).  In  der  Dokumentation  zu  GEM  2.0  hat  Digital 
Research  samtliche  Funktionen  geandert-da  es  sowieso  bislang  keine  Treiber  gibt,  haben  wir 
hier  alie  Anderungen  vollstandig  ubemommen! 

Mindestfunktionsumfang 

(Spezifikation  nach  Digital  Research  zu  GEM  2.0) 


Opcode 

Funktion 

1 

Open  workstation 

2 

Close  workstation 

3 

Clear  workstation 
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Opcode 

Funktion 

4 

Update  workstation 

5 

Escape-functions 

1 

Inquire  addressable  character  cells 

23 

Output  bit  image  file 

91 

Select  camera  film  type  and  exposure  time 

92 

Inquire  camera  film  name 

6 

Polyline 

ii 

Generalized  Drawing  Primitive  (GDP) 

i 

Bar 

2 

Arc 

3 

Pie 

4 

Circle 

5 

Ellipse 

6 

Elliptical  arc 

7 

Elliptical  pie 

8 

Rounded  rectangle 

9 

Filled  rounded  rectangle 

10 

Justified  graphics  text 

12 

Set  character  height,  absolute  mode 

13 

Set  character  baseline  vector 

14 

Set  color  representation 

15 

Set  polyline  linetype 

16 

Set  polyline  line  width 

17 

Set  polyline  color  index 

18 

Set  polymarker  type 

19 

Set  polymarker  height 

20 

Set  polymarker  color  index 

21 

Set  text  face 

22 

Set  graphic  text  color  index 

23 

Set  fill  interior  style 

24 

Set  fill  style  index 

25 

Set  fill  color  index 

26 

Inquire  color  representation 

32 

Set  writing  mode 

35 

Inquire  current  polyline  attributes 

36 

Inquire  current  polymarker  attributes 

37 

Inquire  current  fill  area  attributes 

38 

Inquire  current  graphic  text  attributes 

39 

Set  graphic  text  alignment 
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Opcode 

Funktion 

102 

Extended  inquire  function 

104 

Set  fill  perimeter  visibility 

106 

Set  graphic  text  special  effects 

107 

Set  character  cell  height,  points  mode 

108 

Set  polyline  end  styles 

112 

Set  user-defined  fill  pattern 

113 

Set  user-defined  line  style  pattern 

116 

Inquire  text  extent 

117 

Inquire  character  cell  width 

119 

Load  fonts 

120 

Unload  fonts 

129 

Set  clipping  rectangle 

130 

Inquire  font  name  and  index 

131 

Inquire  current  face  information 
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VDI-Referenz 

Kontrollfunktionen 


OPEN  WORKSTATION  (VDI 1) 


“OPEN  WORKSTATION”  initialisiert  einen  Graflk-Geriitetreiber  l'iir  ein  bestimmtes  Ein-/ 
Ausgabegerat.  Ein  Eingabefeld  teilt  die  dazu  notwendigen  Parameter  mit,  Informationen  iiber 
das  Gerat  erhalt  man  in  einem  speziellen  Ausgabefeld.  Geratetreiber  miissen  in  der 
ASSIGN.SYS-Datei,  die  beim  Booten  von  GDOS  gelesen  wird,  angemeldet  sein  (siehe 
Erlauterungen  zum  Aufbau  der  ASSIGN.SYS-Datei). 

Sollte  es  sich  urn  einen  Bildschirmtreiber  handeln,  so  wird  der  Grafik-Modus  gestartet.  Im 
Normalfall  sind  es  die  AES,  die  die  Bildschirm-Workstation  fur  sich  offnen.  Anwendungs- 
programme  miissen  daher  virtuelle  Workstations  offnen.  Nur  wenn  die  AES  noch  nicht  aktiv 
sind  (wahrend  der  Abarbeitung  des  AUTO-Ordners),  ist  es  moglich,  Bildschirm-Workstations 
zu  offnen.  Wird  OPEN  WORKSTATION  dazu  benutzt,  einen  Metafile  zu  offnen,  so  schreibt 
diese  Funktion  den  Metafileheader  und  initialisiert  den  Dateipuffer.  Wenn  die  Funktion 
erfolgreich  war,  wird  in  contrl[6]  eine  Geratekennung  iibergeben,  sonst  ist  contrl[6]  gleich  0 
(Vorsicht:  Die  allermeisten  GDOS-Versionen  konnen  nicht  beliebig  viele  Workstations  off- 
nen!). 

Deklaration  in  C: 

void  v_opnwk  (WORD  *work_in,  WORD  *handle,  WORD  *work_out) 

{ 

iioff  =  work_in; 
iooff  =  work_out; 
pooff  ^  work__out+45; 
contrl[0]  =  1; 
contrl[l]  =  0; 
contrl[3]  =  11; 
vdi  ( ) ; 

*handle  =  contrl[6]; 
iioff  =  intin; 
iooff  =  intout; 
pooff  =  ptsout; 
pioff  =  ptsin; 


) 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

1 

Opcode  fur  V_OPNWK 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

6 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

11 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

45 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0..  10] 

work_in[0..10] 

intout 

intout[0..44] 

work_out[0..44] 

ptsout 

ptsout[0..11] 

work_out[45..56] 

Parameter: 

work_in[0]: 


work_in[l]: 

work_in[2]: 

work_in[3]: 
work_in[4]: 
work_in[5]: 
work.  _in[6]: 
work_in[7]: 
workJn[8]: 


work_in[9]: 


Geratidentifikationsnummer,  bestimmt  den  zu  ladenden  Geratetreiber  (siehe 
auch  ASSIGN.SYS-Datei): 

1 :  Bildschirmtreiber  (aktuelle  Auflosung) 

2+Getrez():  Bildschirmtreiber  (das  VDI  schaltet  selbsttatig  in  die  entspre- 
chende  Auflosung;  nur  fur  die  Standard-Auflosungen  von  ST 
und  TT  definiert). 
ab  1 1 :  Plottertreiber 
ab21:  Druckertreiber 
ab31:  Metafile-Treiber 
ab41:  Kamera 
ab  5 1 :  Grafiktablett 
Linientyp 

Linienfarbe  (wird  auf  1  gesetzt,  falls  die  Werte  bei  work_in[2],  work_in[4], 
work_in[6]  bzw.  work„in[9]  falsch  gesetzt  werden) 

Markertyp 

Markeifarbe 

Zeichensatznummer 

Textfarbe 

Fiilltyp 

FUllmuster-Index  (Bemerkung;  bei  diesem  Parameter  existiert  ein  Fehler  im 
VDI.  Er  wird  um  den  Wert  1  zu  hoch  iibemommen,  d.  h.  bei  Angabe  von  n  wird 
Fullmuster  n  +  1  gewahlt.) 

Fiillmuster-Farbe 
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work_in[10]: 


work_out[0]: 

work_out[l]: 

work_out[2]: 


work_out[3]: 


work_out[4]: 

work_out[5]: 

work_out[6]: 

work_out[7]: 

work_out[8]: 

work_out[9]: 

work_out[10j: 

work_out[l  1]: 

work_out[12]: 

work_out[I3]: 

work_out[14]: 

work_out[15]  bis 

work_out[24]: 


Koordinaten-Flag 

0:  NDC-Koordinaten  (nur  mil  GDOS) 

1 :  reserviert 

2:  RC-Koordinaten 

Vorsicht :  Je  nach  verwendetem  GDOS  wird  bei  einem  ungtiltigen  Wert 
entweder  NDC  oder  RC  gewahlt! 

Maximale  horizontale  Pixelposition 
(beispielsweise  im  Grafikmodus  “ST-Hoch”:  639) 

Maximale  vertikale  Pixelposition 
(beispielsweise  im  Grafikmodus  “ST-Hoch”:  399) 
Geratekoordinaten-Flag 

0:  Bild  kann  genau  skaliert  werden  (wie  auf  dem  Bildschirm) 

1 :  Bild  kann  nicht  genau  skaliert  werden  (wie  auf  Film-Recordem) 

Breite  eines  Pixels  (oder  Plotterschrittweite)  in  Mikrometem  (=mm/ 
1 000).  FiirBildschirme  sind  work_out[3]  und  work_out[4]  prinzipbedingt 
nicht  exakt  (das  Betriebssystem  kennt  schliefllich  nicht  die  benutzte 
Bilddiagonale).  Immerhin  kann  man  den  Quotienten  aus  beiden  Werten 
sinnvoll  auswerten! 

Hohe  eines  Pixels  (oder  Plotterschrittweite)  in  Mikrometem 
(=mm/1000) 

Anzahl  der  Schriftzeichenhohen  (0:  beliebig  veranderbar) 

Anzahl  der  Linientypen 

Anzahl  der  Linienbreiten  (0:  beliebig  veranderbar) 

Anzahl  der  Markertypen 

Anzahl  der  Markergrofien  (0:  beliebig  veranderbar) 

Anzahl  der  verfiigbaren  Zeichensatze  (kann  mehr  als  einer  sein!) 

Anzahl  der  Muster 

Anzahl  der  Schraffuren 

Anzahl  der  vordefinierten  Farben 

Anzahl  der  Grafikgmndfunktionen  (GDP) 

Liste  der  unterstiitzten  Grafikgrundfunktionen  (GDP). 

Das  Ende  ist  durch  -1  gekennzeichnet. 

GEM  VDI  unterstiitzt  die  folgenden  10  Gmndfunktionen: 

1:  Balken 

2:  Bogen 

3 :  Kreissegment  (-ausschnitt) 

4:  Kreis 

5 ;  Ellipse 

6:  elliptische  Bogen 

7 :  Ellipsensegment  (-ausschnitt) 
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work_out[25]  bis 
work_out[34]: 


work_out[35] 

work_out[36] 

work_out[37] 

work_out[38] 

work_out[39] 


work_out[40]: 


work__out[41]: 


work_out[42]: 


work_out[43]: 


work_out[44]: 

0 

1 

2 

3 

4 

work_out[45]: 

work_out[46]: 


8:  Rechteck  mit  abgerundeten  Ecken 

9:  ausgefalltes,  abgerundetes  Rechteck 

10:  justierter  Grafiktext 

Liste  moglicher  Attribute  der  Grafikgrundfunktionen: 

0:  Linie 

1 :  Marker 

2:  Text 

3:  ausgefiillter  Bereich 

4:  kein  Attribut 

Farbdarstellungs-Flag  (0  nicht  verfiigbar,  1  verfiigbar) 
Textrotations-Flag  (0  nicht  verfiigbar,  1  verfiigbar) 

Flachenfiillung  (0  nicht  verfiigbar,  1  verfiigbar) 

Flag  fiir  die  Funktion  CELLARRAY  (0  nicht  verfiigbar,  1  verfiigbar) 

Anzahl  aller  verfiigbaren  Farben  oder 

0:  mehr  als  32767  Farben  (kontinuierliche  Verteilung) 

2:  monochrom 

Kennzeichnung  fiir  Grafik-Cursor-Kontrolle 
0:  keine 

1:  Tastatur  (allein) 

2:  Tastatur  und  anderes  Gerat  (Maus) 

Eingabegerat  fiir  variierende  Eingaben 

0:  keine 

1 :  Tastatur 

2:  anderes  Gerat 

Auswahltasten 

0:  keine 

1 :  Funktionstasten  auf  der  Tastatur 

2:  anderes  Tastenfeld 

alphanumerische  Eingabe  (String) 

0:  keine 

1 :  Tastatur 

Ein-/Ausgabegerat-Typ 
nur  Ausgabe 
nur  Eingabe 
Ein-/Ausgabe 
reserviert 
Metafile- Ausgabe 
geringste  Zeichenbreite 

geringste  Zeichenhohe  bzgl,  der  Y  -Achse  des  verwendeten  Koordinaten- 
systems  (Abstand  zwischen  Baseline  und  Topline) 
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work_out[47]: 

work_out[48]: 

work_out[49]: 

work_out[50]: 

work_out[51]: 

work_out[52]: 

work_out[53]: 

work_out[54]: 

work_out[55]: 

work_out[56]: 


groBte  Zeichenbreite 

groBte  Zeichenhohe  bzgl.  der  Y-Achse  des  verwendeten  Koordinaten- 

systems  (Abstand  zwischen  Baseline  und  Topline) 

geringste  Linienbreite  bzgl.  der  X-Achse  des  verwendeten  Koordinaten- 

systems 

immer  0 

groBte  Linienbreite  bzgl.  der  X-Achse  des  verwendeten  Koordinaten- 

systems 

immer  0 

geringste  Markerbreite  bzgl.  der  X-Achse 
geringste  Markerhohe  bzgl.  der  X-Achse 
groBte  Markerbreite  bzgl.  der  X-Achse 
grbfite  Markerhohe  bzgl.  der  X-Achse 


Bemerkungen 

contrl[6]  ist  hier  ein  Ausgabeparameter,  der  fur  die  anderen  Funktionen  als  Eingabeparameter 
benotigt  wird.  Die  geringste  Zeichenbreite  und  -hohe  bezeichnet  die  effektive  ZeichengroBe, 
nicht  die  der  Box  mit  Platz  etwa  fur  Unterstreichung. 


Vergleiche  auch  Anhang,  dort  sind  die  speziellen  Werte  des  ST  aufgefiihrt  sowie  “EXTENDED 
INQUIRE  FUNCTION”  (VDI 102). 


Zusatzliche  Funktion  fiir  Matrixdrucker  -  es  kann  die  maximale  Auflosung  angegeben 
werden: 

ptsin[0]:  maximale  X-Auflosung 

ptsinfl]:  maximale  Y-Aufl5sung 

contrl[l]:  auf  1  setzen 


Zusatzliche  Funktion  fiir  den  Atari-Page-Printer  -  die  Adresse  des  intemen  Buffers  wird 
zuriickgeliefert: 

contrl[0]:  High-Word  der  Adresse 

contrl[l]:  Low-Word  der  Adresse 


Standardattribute: 


Attribut 

Standardwert 

VDI-Funktion 

Zeichenhohe 

nominelle  Zeichenhohe 

vst_height 

Basislinienwinkel 

OGrad 

vst_rotation 

Textausrichtung 

links,  Basislinie 

vst_alignment 
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Attribut 

Standardwert 

VDI-Funktion 

Texteffekt 

normal 

vst_effects 

Linienstarke 

nominelle  Linienstarke 

vst_width 

MarkergroBe 

nominelle  MarkergroBe 

vsmjheight 

Aussehen  der  Linienenden 

rechteckig 

vsl_ends 

Schreibmodus 

Replace 

vswr_mode 

Eingabemodus 

REQUEST  (alle  Eingabegerate) 

vsinjnode 

Umrahmung 

sichtbar 

vsf_perimeter 

frei  definierbares  Linienmuster 

durchgehend 

vsi_udsty 

frei  definierbares  Fiillmuster 

Logo  des  Herstellers 

vsf_udpat 

Cursor 

versteckt 

v_show_c  und 
v_hide_c 

Clipping 

abgeschaltet 

vs_clip 

Standardfarben: 


Index 

Farbe 

Bezeichnung 

0 

weiS 

WHITE 

1 

schwarz 

BLACK 

2 

rot 

RED 

3 

griin 

GREEN 

4 

blau 

BLUE 

5 

cyan 

CYAN 

6 

gelb 

YELLOW 

7 

magenta 

MAGENTA 

8 

hellgrau 

LWHITE 

9 

dunkelgrau 

LBLACK 

10 

dunkelrot 

LRED 

11 

dunkelgriin 

LGREEN 

12 

dunkelblau 

LBLUE 

13 

dunkelcyan 

LCYAN 

14 

dunkelgelb 

LYELLOW 

15 

dunkelmagenta 

LMAGENTA 

dariiber: 

gerateabhangig 
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CLOSE  WORKSTATION  (VDI 2) 


Mit  “CLOSE  WORKSTATION”  wird  das  mil  “OPEN  WORKSTATION”  geoffnete  Ein -/ 
Ausgabegerat  geschlossen  und  jede  weitere  Ausgabe  zu  diesem  Gerat  unterbunden.  Es  muB 
unbedingt  darauf  geachtet  werden,  da6  vor  Benutzung  von  “CLOSE  WORKSTATION”  alle 
virtuellen  Workstations  geschlossen  werden. 

CLOSE  WORKSTATION  bewirkt  auf  den  genannten  Geratetypen  folgende  Ereignisse: 

Bildschirm  Umschaltung  in  den  Alphamodus 

Plotter  Update 

Drucker  Update  (falls  nicht  unmittelbar  vorher  einer  stattgefunden  hat) 

Metafile  Datei  wird  ordnungsgemtB  gescldossen 

Kamera  Update 


Deklaration  in  C: 

void  v_clswk  (WORD  handle) 

{ 

contrl [0]  =  2; 
eontrl[l]  =  contrl[3]  =  0; 
contrl [6]  =  handle; 
vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

2 

Opcode  fur  V  CLSWK 

contrl+2 

control] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl(2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 
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OPEN  VIRTUAL  SCREEN  WORKSTATION  (VDI 100) 


Es  wird  ein  virtuelles  Ausgabegerat  auf  einem  bereits  geoffneten  physikalischen  Ausgabegerat 
geoffnet.  Das  entsprechende  Gerat  mufi  zuvor  mit  “OPEN  WORKSTATION”  geoffnet 
worden  sein.  Sinn  und  Zweck  des  Ganzen  ist,  dafi  mehrere  Programme  gleichzeitig  das  Gerat 
benutzen  konnen,  ohne  einander  in  die  Quere  zu  kommen  (zum  Beispiel  das  eigene  Programm 
und  die  AES).  Auch  innerhalb  eines  Programmes  kann  es  sinnvoll  sein,  mit  mehreren 
Workstations  gleichzeitig  zu  arbeiten  -  beispielsweise  wenn  man  zwischen  zwei  haufig 
benutzten  Mengen  von  Attributen  hin-  und  herschalten  mochte. 


Diese  Funktion  ist  nur  fur  den  Bildschirmtreiber  defmiert.  Die  Geratekennung  der  aktuellen 
physikalischen  Bildschirm-Workstation  mufi  man  beim  AES  mit  “graf_handleO”  erfragen! 

Das  VDI  besitzt  keinen  Mechanismus,  urn  die  Eingabegerate  bei  mehreren  virtuellen 
Workstations  zu  verwalten.  Diese  Aufgabe  mu 6  die  Applikation  iibemehmen,  die  die 
physikalische  Bildschirm-Workstation  offnet. 

In  den  TOS-Versionen  1 .00, 1 .04, 1 .06, 1 .62  und  2.05  gibt  es  einen  Fehler  bei  der  Verwaltung 
der  virtuellen  Workstations:  Folge  kann  sein,  daB  Handles  mehrfach  vergeben  werden,  so  daS 
unvermittelt  Workstation- Attribute  verstellt  werden.  Dies  passiert  genau  dann,  wenn  in  der 
Bildschirmtreiber-intemen  Workstation-Liste  “Liicken”  entstehen.  Einzige  Abhilfe:  das 
Programm  “VDIFIX”  von  Karsten  Isakovic  im  AUTO-Ordner  installieren  (man  bekommt  es 
direkt  vom  Autor,  in  den  meisten  Mailboxen  und  unter  Umstanden  auch  beim  Fachhandler). 

Deklaration  in  C: 

void  v_opnvwk  (WORD  *work_in,  WORD  *handle,  WORD  *work_out) 

{ 

iioff  =  work_in; 
iooff  =  work_out; 
pooff  =  work__out+45; 
contrl[0]  =  100; 
contrl[l]  =  0; 

contrl[3]  =  11;  contrl[6]  =  *handle; 

vdi  (); 

*handle  =  contrl[6]; 
iioff  =  intin; 
iooff  =  intout; 
pooff  =  ptsout; 

} 


338 


ATARI  Profibuch 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

100 

Opcode  fur  V.OPNVWK 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

6 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

11 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

45 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle  Geratekennung 

intin 

intin[0..10] 

work_in[0..10] 

intout 

intout[0..44] 

work_out[0..44] 

ptsout 

ptsout[0..11] 

work_out[45..56] 

Bemerkungen 

Die  Ein-  und  Ausgabeparameter  sind  mit  denen  von  OPEN  WORKSTATION  (VDI  1) 
identisch. 

contrl[6]  ist  beim  Aufruf  die  Nummer  der  physikalischen  Workstation,  auf  der  die  virtuelle 
Workstation  geoffnet  werden  soli.  Bei  der  Ruckkehr  enthalt  contrl[6]  die  Nummer  der 
geoffneten  Workstation  Oder  den  Fehlercode  0. 

“v_opnvwk()”  alloziert  Speicher,  weshalb  bei  Accessories  Vorsicht  geboten  ist.  Um  Proble- 
men  vorzubeugen,  sollte  eine  virtuelle  Workstation  von  einem  Accessory  moglichst  sofort 
geoffnet  und  nie  geschlossen  werden. 
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CLOSE  VIRTUAL  SCREEN  WORKSTATION  (VDI 101) 


Mit  “CLOSE  VIRTUAL  SCREEN  WORKSTATION”  wird  das  mjt  “OPEN  VIRTUAL 
SCREEN  WORKSTATION”  geoffnete  virtuelle  Ein-/Ausgabegerat  geschlossen  und  jede 
weitere  Ausgabe  zu  diesem  Gerat  unterbrochen. 

Vorsicht!  Wenn  beim  Offnen  der  Workstation  ein  Fehler  aufgetreten  ist,  darf  man  diese 
Funktion  nicht  aufrufen! 


Deklaration  in  C: 

void  v_clsvwk  (WORD  handle) 

{ 

contrl [0]  =  101; 
contrl[l]  =  contrl[3]  =  0; 
contrir6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

101 

Opcode  fur  V_CLSVWK 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 
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CLEAR  WORKSTATION  (VDI 3) 


Mit  “CLEAR  WORKSTATION”  wird  der  Bildschirm  geloscht  und  auf  die  ausgewahlte 
Hintergrundfarbe  (Index  0  in  der  Farbtabelle)  gesetzt.  Analog  wird  bei  einem  Plotter  der  Puffer 
geloscht  und  bei  einem  Drucker  zusatzlich  ein  Seitenvorschub  durchgefuhrt.  Bei  einem 
Metafile  wird  lediglich  der  Opcode  gespeichert,  bei  einer  Kamera  wird  die  Ausgabe  geloscht 
und  die  Hintergrundfarbe  gesetzt.  Ein  Aufruf  von  “OPEN  WORKSTATION”  loscht  das 
Display  (Bildschirm  o.  a.)  automatisch. 


Deklaration  in  C: 

void  v_clrwk  {WORD  handle) 

{ 

contrl[0]  =  3; 
contrl[l]  =  contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

3 

Opcode  fur  V_CLRWK 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

|  handle  Geratekennung 
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UPDATE  WORKSTATION  (VDI 4) 


“UPDATE  WORKSTATION”  wird  benotigt,  um  einem  Ein-/Ausgabegerat  mitzuteilen,  alle 
gepufferten  Grafikkommandos  auszufiihren. 


Auf  einem  Bildschirm  wird  diese  Funktion  nicht  benotigt,  da  die  Grafikkommandos  hier 
umgehend  ausgefiihrt  werden  (sie  ist  im  ROM  auch  nicht  implementiert).  So  speichem  bei- 
spielsweise  Druckertreiber  die  Kommandos  in  einem  Puffer  (wird  beim  Druckertreiber  auch 
“Display-List”  genannt). 

Die  Ausgabe  iiber  diese  Gerate  erfolgt  erst  nach  Aufruf  der  “UPDATE  WORKSTATION”- 
Funktion.IstderPufferfurdasAusgabegeratgeleert,kehrtdie“UPDATEWORKSTATION”- 
Funktion  zuriick.  Zu  beachten  ist  hierbei,  daB  bei  einem  Drucker  kein  Seitenvorschub  gegeben 
wird.  Bei  einem  Metafile  wird  lediglich  der  Opcode  in  den  Metafile-Puffer  geschrieben. 


Dekiaration  in  C: 

void  v_updwk  (WORD  handle) 

{ 

contrl[0]  =  4; 
contrl[l]  =  contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

4 

Opcode  fur  V_UPDWK 

contrl+2 

contrl  [1] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

Bemerkungen 

Zusatzliche  Funktion  fur  Druckertreiber:  Statt  der  aktuellen  Seite  kann  ein  eigener  Buffer  auf 
dem  Drucker  ausgegeben  werden. 
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contrl[3]  =  2;  /*  zwei  Werte  in  intin []  */ 

intin [0]  /*  High-Word  der  Anfangsadresse  */ 

intin [1]  /*  Low-Word  der  Anfangsadresse  */ 

contrl[l]  =  1;  /*  Buffer  nicht  loschen  */ 

contrl [0]  =  4; 

contrl[6]  =  handle; 

vdi  ( ) ;  ... 

Zusatzliche  Funktion  fur  die  Atari-SLM-Laserdrucker:  In  intout[0]  wird  der  Status  des 

Druckers  zuriickgeliefert. 


intout[0] 

Fehler 

0 

NO  ERROR 

2 

PRINTER  NOT  READY 

3 

TONER  EMPTY 

5 

PAPER  EMPTY 

VDI-Betriebssystemroutinen 
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LOAD  FONTS  (VDI 119) 


Mit  dieser  Funktion  kann  man  zusatzlich  zu  den  fest  installierten  System  zeichensatzen  weitere 
Zeichensatze  laden.  Als  Ergebnis  erhalt  man  die  Zahl  der  hinzugekommenen  Zeichensatze 
(wenn  man  also  “vst_load_fonts()”  fur  eine  Workstation  mehrfach  aufruft,  erhalt  man  keine 
weiteren  Zeichensatze  und  daher  als  Ergebnis  eine  0). 

Fur  diese  Funktion  muB  GDOS  installiert  sein  (“vq_gdos()”  benutzen !),  sonst  gibt  es  bedauer- 
licherweise  einen  Sy  stemabsturz.  Die  zusatzlichen  Zeichensatze  miissen  in  der  ASSIGN. SY S- 
Datei  vermerkt  sein.  Dafi  “vstJoadJfontsO”  ohne  GDOS  nicht  funktioniert,  hat  einen  guten 
Grund.  GDOS  selbst  benutzt  namlich  diesen  Funktionsaufruf,  urn  die  Zeichensatzheader  an 
den  entsprechenden  Geratetreiber  weiterzuleiten.  Ohne  GDOS  dient  diese  Funktion  also  zur 
Installation  bereits  geladener  GEM-Zeichensdtze,  Nur  mit  GDOS  ist  sie  fur  Anwenderpro- 
gramme  interessant. 

Und  so  ladt  man  auf  korrekte  Art  und  Weise  Zeichensatze: 

1 .  Nach  “v_opnvwk()”  die  Anzahl  der  SystemzeichensStze  (aus  work_out[l  0])  merken. 

2.  Mit  “vq_gdos()”  sicherstellen,  daB  “vst_load_fonts()”  aufgerufen  werden  darf. 

3 .  Den  Retum-Wert  zur  Zahl  der  Systemzeichensatze  addieren.  Damit  hat  man  die  Gesamt- 
zahl  der  Zeichensatze. 

4.  Fur  alle  Zeichensatznummem  von  1  bis  zur  Gesamtzahl  “vqt„name()”  aufrufen.  Damit 
erfahrt  man  den  Zeichensatznamen  und  den  Zeichensatzindex,  unter  dem  man  den  Zei- 
chensatz  spater  abrufen  kann. 

5.  Am  Ende  des  Programms  “vst_unload_fonts()”  nicht  vergessen! 

Deklaration  in  C: 

WORD  vst_load_fonts  (WORD  handle,  WORD  select) 

{ 

contrl(0]  =  119; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
intin [0]  =  select; 
vdi  ( ) ; 

return  intout [0] ; 


) 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

119 

Opcode  fur  VST_LOAD_FONTS 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intout 

intin  [0] 
intoutfO] 

select 

Retum-Wert 

Parameter: 

select:  0  (reserviert  fur  zukiinftige  Benutzung) 

vst_load_fonts():  Anzahl  der  zusatzlich  verfilgbaren  Zeichensatze 

Bemerkungen 

“vst _load_fonts()”  kann  Speicher  allozieren,  daher  ist  bei  Accessories  Vorsicht  geboten.  Um 
Problemen  vorzubeugen, 1  sollte  die  Funktion  entweder  nicht  oder  sofort  nach  dem  Start 
aufgemfen  werdcn. 
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UNLOAD  FONTS  (VDI 120) 


Durch  “UNLOAD  FONTS”  werden  die  durch  “vst_load_fonts()”  geladenen  Zeichensatze 
wieder  entfemt.  Da  die  Zeichensatze  nur  einmal  pro  physikalische  Workstation  geladen 
werden,  werden  sie  natiirlich  erst  dann  wieder  aus  dem  Speicher  entfernt,  wenn  alle 
“benutzenden”  Workstations  (beim  Bildschirm  also  die  verschiedenen  virtuellen) 
“vst_unload_fonts()”  aufgerufen  haben. 

Die  Systemzeichensatze  bleiben  von  dieser  Funktion  unberiihrt. 

Deklaration  in  C: 

void  vst_unload_fonts  (WORD  handle,  WORD  select) 

( 

intin [0]  =  select; 
contrltO]  =  120; 
contrl  [1]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  <); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0J 

120 

Opcode  fur  VST_UNLOAD_FONTS 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl  +8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

select 

Parameter: 

select:  0  (reserviert  fur  zukilnftige  Benutzung) 
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SET  CLIPPING  RECTANGLE  (VDI 129) 


MitdieserFunktionwirdeinArbeitsbereichfestgelegtoderfreigegeben.WirdeinArbeitsbereich 
festgelegt,  so  werden  alle  Grafikoperationen  auf  diesen  Bereich  beschrankt.  Uberstehcnde 
Bereiche  werden  abgeschnitten.  Wenn  man  kein  Clip-Rechteck  setzt,  wird  auch  an  den  Bild- 
schirmgrenzen  nicht  geelippt! 

Deklaration  in  C: 

void  vs__clip  (WORD  handle,  WORD  clip_flag,  WORD  *pxyarray) 

{ 

pioff  =  pxyarray; 
intin  [0]  =  clip_flag; 
contrl[0]  =  129; 
contrl [ 1 ]  =  2 ; 
contrl[3]  =  1; 
contrl [6]  =  handle; 
vdi  ( ) ; 

pioff  =  ptsin; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

129 

Opcode  fttr  VS_CLIP 

contrl+2 

contrlfl] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

clip_flag 

ptsin 

ptsin[0..3] 

pxyarray[0..3] 

Parameter: 

clip_flag: 

pxyarray[0]: 

pxyarray[l]: 

pxyarray[2]: 

pxyarray[3]: 


0:  Clippen  des  Arbeitsbereichs  aus 

1:  Clippen  des  Arbeitsbereichs  ein 

X-Koordinate  des  Eckpunktes 

Y-Koordinate  des  Eckpunktes 

X-Koordinate  der  diagonal  gegeniiberliegenden  Ecke 

Y-Koordinate  der  diagonal  gegenuberliegenden  Ecke 
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Ausgabefunktionen 

\  POLYLINE  (VDI 6) 


Diese  Funktion  dient  dazu,  einen  Polygonzug  zu  zeichnen. 

Die  Koordinaten  des  ersten  Punktes  bestimmen  den  Startpunkt  des  Linienzuges.  Nacheinan- 
der  werden  dann  alle  Punkte  durch  eine  Linie  verbunden. 

Einzelne  Punkte  konnen  durch  ein  einzelnes  Koordinatenpaar  nicht  gezeichnet  werden,  je- 
doch  durch  eine  Linie  der  Lange  Null,  also  zwei  gleiche  Koordinatenpaare. 

Die  Linienattribute  und  die  Einstellung  des  Schreibmodus  werden  beriicksichtigt. 


Deklaration  in  C: 

void  vjoline  (WORD  handle,  WORD  count,  WORD  *pxyarray) 

{ 

pioff  =  pxyarray; 
contrl [0]  =  6; 
contrl[l]  =  count; 
contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  ( ) ; 

pioff  =  ptsin; 

1 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

6 

Opcode  fur  V_PLINE 

contrl+2 

contrl[l] 

count  (n) 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

ptsin 

ptsin[0..2n-l] 

pxyarray[0. 

.2n-l] 
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Parameter: 

pxy  array  [0]: 
pxyarray[l]: 
pxyarray[2]: 
pxyarray[3]: 


X-Koordinate  des  ersten  Punktes 
Y-Koordinate  des  ersten  Punktes 
X-Koordinate  des  zweiten  Punktes 
Y-Koordinate  des  zweiten  Punktes 


pxy  array  [2n-2]:  X-Koordinate  des  letzten  (n-ten)  Punktes 

pxyarray[2n-l]:  Y-Koordinate  des  letzten  (n-ten)  Punktes 
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POLYMARKER  (VDI 7) 


Diese  Funktion  zeichnet  Marker  an  vorgegebene  Stellen.  Die  Markerattribute  und  der 
eingestellte  Schreibmodus  werden  benutzt. 

Anwendung  finden  die  Marker  etwa  bei  grafischer  Darstellung  von  Statistiken. 


Deklaration  in  C: 

void  vjomarker  (WORD  handle,  WORD  count,  WORD  *pxyarray) 
{ 

pioff  =  pxy array ; 
contrl[0]  =7; 
cont  r 1 [ 1 ]  =  count ; 
contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  ()  ; 

pioff  =  ptsin; 

1 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

7 

Opcode  fiir  V_PMARKER 

contrl+2 

contrl[l] 

count  (n) 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

ptsin 

ptsin[0..2n-l] 

pxyarraytO. 

•2n-l] 

Parameter: 

count: 

pxyarray[0]: 

pxyarray[l]: 

pxyarray[2]: 


Anzahl  der  Marker 
X-Koordinate  des  ersten  Markers 
Y-Koordinate  des  ersten  Markers 
X-Koordinate  des  zweiten  Markers 
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pxyarray[3]: 


pxyarray[2n-2]: 

pxyarray[2n-l]: 


Y-Koordinate  des  zweiten  Markers 


X-Koordinate  des  letzten  (n-ten)  Markers 
Y-Koordinate  des  letzten  (n-ten)  Markers 
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TEXT  (VDI 8) 


Diese  Funktion  schreibt  einen  Text  auf  den  Grafikbildschirm. 

Das  Koordinatenpaar  bestimmt  die  Position  des  Textes.  Der  Text  wird  linksjustiert  ausgege- 
ben.  Die  Basislinie  liegt  in  Richtung  der  X-Achse,  wird  also  in  der  Hohe  durch  die  Y-Koor- 
dinate  bestimmt.  Der  Text  kann  durch  diverse  Attribute  auch  anders  ausgerichtet  werden. 
Jedes  einzelne  Zeichen  (Character)  wird  durch  die  Bits  0...7  bestimmt.  Die  Textattributeund 
der  Schreibmodus  werden  beriicksichtigt. 

Man  kann  die  Ausgabegeschwindigkeit  beschleunigen,  wenn  man  folgende  Punkte  beachtet: 

-  auf  Bytegrenzen  justiert  ausgeben  (das  niitzt  natiirlich  nur  bei  acht  Pixel  breiten,  nicht- 
proportionalen  Zeichensatzen  etwas) 

-  moglichst  ohne  Clipping  ausgeben 

-  beim  Systemzeichensatz  (allgemein:  bei  nichtproportionalen,  acht  Pixel  breiten  Zei¬ 
chen)  im  Replace-Modus  und  ohne  Clipping  ausgeben,  ansonsten  den  TRANSPA- 
RENT-Modus  wahlen. 

Ein  C-Binding  benotigt  einen  Byte-orientierten  und  Null-terminierten,  ein  Assembler- 
Binding  einen  Word-orientierten  String.  Xm  Zeichensatz  fehlende  Zeichen  werden  durch  ein 
Ersatzzeichen  (im  allgemeinen  das  Fragezeichen)  ersetzt. 


Deklaration  in  C: 

void  v_gtext  {WORD  handle,  WORD  x,  WORD  y,  const  char  *string) 
{ 

WORD  i; 
ptsin[0]  =  x; 
ptsin[l]  =  y; 
i  =  0; 

while  (intin [i++]  =  *string++) ; 

contrl[Q]  =  8; 

contrl[l]  =  1; 

contrl[3]  =  -i; 

contrl[6]  =  handle; 

vdi  ( ) ; 


} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

8 

Opcode  fur  V.GTEXT 

contrl+2 

contrl[  1] 

1 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

n 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0..n-l] 

string[0..n-l] 

ptsin 

ptsin  [0] 

X 

ptsin+2 

ptsin[l] 

y 

Parameter: 

x:  X-Koordinate  des  Textes 

y:  Y-Koordinate  des  Textes 

string:  Zeiger  auf  auszugebende  Zeichenkette 
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FILLED  AREA  (VDI  9) 


Diese  Funktion  fiillt  eine  von  einem  Polygonzug  umrahmte  Flache  aus.  Dabei  werden  die 
Fiiliattribute  beachtet.  Die  ausgefiiUte  Flache  wird  von  einer  Linie  in  der  Fiillfarbe  umgeben. 
Anderungen  der  Attribute  bzw.  des  Schreibmodus  sind  iiber  die  Attributfunktionen  moglich. 

Sollte  das  Ausgabegerat  keine  Ausfiillmbglichkeit  haben,  so  wird  die  Flache  nur  mit  der 
aktuellen  Fiillfarbe  umgeben.  Es  milssen  mindestens  drei  Koordinatenpaare  ubergeben  wer¬ 
den.  Eine  Nullflache  (nur  ein  Koordinatenpaar)  wird  nur  dann  als  Punkt  gezeichnet,  wenn  die 
automatische  Umrahmung  der  Flache  (siehe  SET  FILL  PERIMETER  VISIBILITY)  einge- 
schaltet  ist. 

Eine  Linie  wird  nicht  ausgegeben.  Offene  Polygonziige  werden  selbsttatig  geschlossen. 


Deklaration  in  C: 

void  v_fillarea  (WORD  handle,  WORD  count,  WORD  *pxyarray) 
{ 

pioff  --  pxyarray; 
contrl[0]  =  9; 
contrl[l]  =  count; 
contrl(3]  =  0; 
contrl[6]  =  handle; 
vdi  (); 

pioff  =  ptsin; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

'  9 

Opcode  fur  VJFILLAREA 

contrl+2 

control] 

count  (n) 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

ptsin 

ptsin[0..2n-l] 

pxyarray[0..2n-l] 
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Parameter: 

count 

pxyarray[0] 

pxyarray[l] 

pxyarray[2] 

pxyarray[3] 


Anzabl  der  Punkte 
X-Koordinate  des  ersten  Punktes 
Y-Koordinate  des  ersten  Punktes 
X-Koordinate  des  zweiten  Punktes 
Y-Koordinate  des  zweiten  Punktes 


pxyarray[2n-2]:  X-Koordinate  des  letzten  (n-ten)  Punktes 

pxyarray[2n-l]:  Y-Koordinate  des  letzten  (n-ten)  Punktes 
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CELL  ARRAY  (VDI 10) 


Diese  Funktion  erlaubt  einen  komplexeren  Farbaufbau  des  Bildschirms.  Die  Farbe  der 
gesetzten  Pixel  (nichtganzer  Objekte  wie  Linien)  ist  ortsabhangig  und  nicht,  wie  sonst  iiblich, 
objektabhiingig.  Ein  frei  definierbares  Rechteck  wird  in  einzelne  Teile  -  Zellen  -  durch  Zeilen 
und  Spalten  unterteilt.  Jeder  dieser  Zellen  wird  eine  Farbe  zugeordnet,  die  fur  die  Pixelfarbe 
zustandig  ist.  Werden  nun  die  Zellen  beschrieben,  so  erscheinen  die  gesetzten  Pixel  in  der 
Farbe.diefurdiejeweiligeZellebestimmtwurde.DieseFunktionistimROM-Bildschirmtreiber 
nicht  implementiert. 


Deklaration  in  C: 

void  v_cellarray  (WORD  handle,  WORD  *pxyarray,  WORD  row_length, 
WORD  el_used,  WORD  num_rows,  WORD  wrt_mode, 
WORD  *colarray) 

( 

iioff  =  colarray; 
pioff  =  pxyarray; 
contrl [0]  =  10; 
contrl [1]  =  2; 

contrl[3]  =  row_lenght*num_rows; 
contrl[6]  =  handle; 
contrl[7]  =  row_length; 
contrl[8]  =  el_used; 
contrl[9]  =  num_rows; 
contrl[10]  =  wrt_mode; 
vdi  ( ) ; 

iioff  =  intin; 
pioff  =  ptsin; 

} 

GEM-Arrays; 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl[0] 

10 

Opcode  fur  V_CELLARRAY 

contrl+2 

contrlfl] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

n 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 
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Adresse 

Feldelement 

Belegung 

contrl+12 

contrl[6] 

handle  Geratekennung 

contrl+14 

contrl[7] 

rowjength 

contrl+16 

contrl[8] 

el_used 

contrl+18 

contrl[9] 

num_rows 

contrl+20 

contrl[I0] 

wrt_mode 

intin 

intin[0..n-I] 

colarray[0..n-l] 

ptsin 

ptsin[0..3] 

pxyarray[0..3] 

Parameter: 


rowjength:  Zeilenlange  im  Farbindexarray 
el_used:  Zonenanzahl  pro  Zeile  (also  Spaltenanzahl) 

numjrows:  Anzahl  der  Zeilen 
wrtjmode:  Schreibmodus 
colarray[0]  bis 

colarray[n-l]:  Farbindexarray,  enthalt  die  Farbinformation  zeilenweise 
pxyarray[0]:  X-Koordinate  der  unteren  linken  Ecke  des  Begrenzungsrechteckes 
pxyaiTay[l]:  Y-Koordinate  der  unteren  linken  Ecke  des  Begrenzungsrechteckes 
pxyarray[2]:  X-Koordinate  der  oberen  rechten  Ecke  des  Begrenzungsrechteckes 
pxyarray[3]:  Y-Koordinate  der  oberen  rechten  Ecke  des  Begrenzungsrechteckes 


Bemerkungen 

n  ist  hier  die  #  Zeilen  *  #  Spalten  der  Zellenaufteilung.  Hat  man  etwa  ein  Feld  von  horizontal 
zehn  und  vertikal  vier  Zeilen,  so  sind  dies  zehn  Spalten  und  vier  Zeilen. 


Somit  ist  n  =  4  *  10  =  40. 
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CONTOUR  FILL  (VDI 103) 


Diese  Funktion  fiillt  eine  Flache  abhangig  vom  Startpunkt  aus.  Die  Fiillflache  wird  durch  den 
Bildschirmrand  oder  durch  eine  definierte  Farbe  begrenzt.  Die  aktuellen  Fiillattribute  werden 
beachtet.  Einige  Ausgabegeriite  unterstiitzen  diese  Funktion  nicht  (kann  mit  “vq_extnd()” 
erfragt  werden). 


Deklaration  in  C: 

void  v_contourfill  (WORD  handle,  WORD  x,  WORD  y,  WORD  index) 

{ 

intin [0]  =  index; 
ptsin[0]  =  x; 
ptsin  [1J  =■  y; 
contrl[0]  =  103; 
contrl[l]  =  contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

103  Opcode  fOr  V_CONTOURFILL 

contrl+2 

contrl[l] 

1  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3j 

1  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

0  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

index 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsinfl) 

y 

Parameter: 

index:  Farbindex  (bei  negativem  Parameter  wird  gefullt,  bis  ein  andersfarbiges  Pixel  ange- 
troffen  wird) 

x:  X-Koordinate  des  Startpunktes 

y:  Y--Koordinate  des  Startpunktes 
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FILL  RECTANGLE  (VDI  114) 

Diese  Funktion  fiillt  ein  Rechteck  unter  Beachtung  der  Attribute  (ahnlich  “FILLED  AREA” 
(VDI  9))  aus,  ohne  “Perimeter”  (Umrahmungseinstellung)  zu  beriicksichtigen. 

Deklaration  in  C: 

void  vr_recfl  (WORD  handle,  WORD  *pxyarray) 

{ 

pioff  =  pxyarray; 
contrl[0]  =  114; 
contrl[l]  =  2; 
contrlf3]  =  0; 
cont  r 1 [ 6 ]  =  handle ; 
vdi  ( ) ; 

pioff  =  ptsin; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

114 

Opcode  fiir  VR_RECFL 

contrl+2 

contrl[l] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

ptsin 

ptsin[0..3] 

pxyarray  [0..  3] 

Parameter: 


pxyarray[0]: 
pxyarray[I]: 
pxyarray[2]: 
pxyarray  [3]: 


X-Koordinate  des  Eckpunktes 

Y-Koordinate  des  Eckpunktes 

X-Koordinate  der  diagonal  gegentiberliegenden  Ecke 

Y-Koordinate  der  diagonal  gegeniiberliegenden  Ecke 


Bemerkungen 

Vorsicht:  Nicht  auf  alien  Ausgabegeraten  verfugbar!  Im  Zweifel  besser  “v_bar()”  benutzen! 
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GENERALIZED  DRAWING  PRIMITIVE  (VDI 11)  (GDP) 


Die  GDP-Funktion  erlaubt  eine  einfache  Handhabung  einerReihe  von  Grafikgrundfunktionen. 
Diezehn  moglichen  Grafdcgrundfimktionen  sind  in  derReihenfolge  ihrerldentifikationsnummer 
aufgefuhrt. 

Einige  der  Funktionen  sind  nicht  auf  alien  Ausgabegeraten  verfiigbar. 
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BAR  (VDI 11,  GDP  1) 

Die  Funktion  BAR  zeichnet  ein  ausgefiilltes  Rechteck.  Benutzt  wird  die  Grundfunktion  etwa 
fur  Balkendiagramme.  Die  Fiillattribute  sowie  der  Schreibmodus  werden  beriicksichtigt. 

Deklaration  in  C: 

void  vjoar  (WORD  handle,  WORD  *pxyarray) 

{ 

pioff  =  pxyarray; 
contrl [0]  =  11; 
contrl[l]  =  2; 
contrl[3]  =  0; 
contrl[5]  =  1; 
contrl[6]  =  handle; 
vdi  {); 

pioff  =  ptsin; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl[0] 

11 

Opcode  fur  GDP 

contrl+2 

contrl[l] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

eontrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

eontrl[5] 

1 

VJBAR 

contrl+12 

contrl[6] 

handle  Geratekennung 

ptsin 

ptsin[0..3] 

pxyarray[0..3] 

Parameter: 

pxyarrayfOj:  X-Koordinate  des  Eckpunktes 

pxyarray [1  ] :  Y -Koordinate  des  Eckpunktes 

pxyarray [2]:  X-Koordinate  der  diagonal  gegeniiberiiegenden  Ecke 

pxyarray[3]:  Y-Koordinate  der  diagonal  gegenuberliegenden  Ecke 
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ARC  (VDI 11,  GDP  2) 

Die  Funktion  ARC  zeichnet  einen  Kreisbogen,  Es  werden  die  Linienattribute,  “Perimeter” 
(Umrahmung),  der  Sehreibmodus  und  die  tatsachliche  PixelgroBe  beriicksichtigt. 

Der  Bogen  wird  entgegen  dem  Uhrzeigersinn  (positiv)  gezeichnet.  Nulldurchgange  sind 
durchaus  moglich.  Die  Angabe  des  Radius  bezieht  sich  auf  die  X-Achse. 

Die  Winkelmessung  erfolgt  in  1/10  Grad: 


900 


2700 


Deklaration  in  C: 

void  v_arc  (WORD  handle,  WORD  x,  WORD  y,  WORD  radius,  WORD  begang, 
WORD  endang) 

{ 

ptsin [0]  =  x; 
ptsin [1]  =  y; 

ptsin[2]  =  ptsin [3]  =  ptsin [4]  =  ptsin [5]  =  0; 

ptsin [6]  =  radius; 

ptsin [7]  =  0; 

intin [ 0 ]  =  begang; 

intin [1]  =  endang; 

contrl[0]  =  11; 

contrl[l]  ~  4; 

contrl[3]  =  contrl[5]  =  2; 

cont  r 1 [ 6 ]  =  handle ; 

vdi  (); 

} 
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GEM-Arrays: 


Adresse 

Feldelement 

contrl 

contrl[0] 

contrl+2 

contrl[l] 

contrl+4 

contrl  [2] 

contrl+6 

contrl  [3] 

contrl+8 

contrl  [4] 

contrl+10 

contrl[5] 

contrl+12 

contrl[6] 

intin 

intin[0] 

intin+2 

intinfl] 

ptsin 

ptsin[0] 

ptsin+2 

ptsin[l] 

ptsin+4 

ptsin[2..5] 

ptsin+12 

ptsin[6] 

ptsin+14 

ptsin[7] 

Belegung 


1 1  Opcode  fur  GDP 

4  #  Eintrage  in  ptsin 

0  #  Eintrage  in  ptsout 

2  #  Eintrage  in  intin 

0  #  Eintrage  in  intout 

2  V_ARC 

handle  Geratekennung 

begang 

endang 

x 

y 

o 

radius 

0 


Parameter: 


begang: 

endang: 

x: 

y: 

radius: 


Startwinkel  fiir  den  Bogen  (0..3600) 
Endwinkel  fur  den  Bogen  (0..3600) 
X-Koordinate  fiir  den  Mittelpunkt 
Y-Koordinate  fiir  den  Mittelpunkt 
Radius  (bzgl.  der  X-Achse) 
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Die  FunktionPIESLICE  zeichnet  einen  Kreisflachenausschnitt,  wie  er  auch  fiirTortengraf iken 
benutzt  wird.  Es  werden  die  Fullattribute,  der  Schreibmodus  und  das  PixelgrdBenverhaltnis 
beriicksichtigt.  Der  Kreisflachenausschnitt  wird  entgegen  dem  Uhrzeigersinn  beginnend 
beim  Startwinkel  und  endend  beim  Endwinkel  gezeichnet,  wobei  der  Radius  an  der  X- Achse 
gemessen  wird.  Nulldurchgange  sind  durchaus  moglich. 

Die  Winkel  werden  in  1/10  Grad  gemessen: 


900 


2700 


Deklaration  in  C: 

void  v_pieslice  (WORD  handle,  WORD  x,  WORD  y,  WORD  radius, 
WORD  begang,  WORD  endang) 

{ 

ptsin[0J  =  x; 

ptsin [1]  =  y; 

ptsin[2]  =  ptsin [3]  =  ptsin [4]  =  ptsin [5]  =  0/ 

ptsin [6]  =  radius; 

ptsin [7]  =  0; 

intin [0]  =  begang; 

intinfl]  =  endang; 

contrl[0]  =  11; 

contrlfl]  =  4; 

contrl[3]  =  2; 

contrl[5]  =  3; 

contrl[6]  =  handle; 

vdi  { ) ; 

} 
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GEM-Arrays: 


Adresse 

Feldelement 

contrl 

contrl[0] 

contrl+2 

contrl[l] 

contrl+4 

contrl  [2] 

contrl+6 

contrl[3] 

contrl+8 

contrl[4] 

contrl+10 

contrl[5] 

contrl+12 

contrl[6] 

intin 

intin[0] 

intin+2 

intin[l] 

ptsin 

ptsin[0] 

ptsin+2 

ptsin[l] 

ptsin+4 

ptsin[2..5] 

ptsin+12 

ptsin[6] 

ptsin+14 

ptsin[7] 

Belegung 


1 1  Opcode  fiir  GDP 

4  #  Eintrage  in  ptsin 

0  #  Eintrage  in  ptsout 

2  #  Eintrage  in  intin 

0  #  Eintrage  in  intout 

3  V_PIESLICE 
handle  Geratekennung 

begang 

endang 

x 

y 

o 

radius 

0 


Parameter: 


begang: 

endang: 

x: 

y: 

radius: 


Startwinkel  fur  den  Kreisausschnitt  (0..3600) 
Endwinkel  fiir  den  Kreisausschnitt  (0..3600) 
X-Koordinate  fiir  den  Mittelpunkt 
Y-Koordinate  fiir  den  Mittelpunkt 
Radius  (bzgl.  der  X-Achse) 
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CIRCLE  (VDI 11,  GDP  4) 


DieFunktionCIRCLEzeichneteineKreisflache.EswerdendieFullattribute,derSchreibmodus 
und  das  PixelgrbBenverhaltnis  beriicksichtigt.  Der  Radius  wird  anhand  der  X-Achse  be- 
stimmt. 


Deklaration  in  C: 

void  v_circle  (WORD  handle,  WORD  x,  WORD  y,  WORD  radius) 
{ 

ptsin[0]  =  x; 
ptsin [1]  =  y; 
ptsin[2]  =  ptsin [3]  =  0; 
ptsin[4]  =  radius; 
ptsin  [5]  =  0; 
contrl[0]  =  11; 
contrl [1]  =  3; 
contrl[3]  =  0; 
contrl[5]  =  4; 
contrl[6]  =  handle; 
vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

11  Opcode  fur  GDP 

contrl+2 

control] 

3  #  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0  #  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  intout 

contrl+10 

contrl[5] 

4  V_CIRCLE 

contrl+12 

contrl  [6] 

handle  Geratekennung 

ptsin 

ptsin  [0] 

X 

ptsin+2 

ptsin[l] 

y 

ptsin+4 

ptsin[2..3] 

0 

ptsin+8 

ptsin  [4] 

radius 

ptsin+10 

ptsin[5] 

0 
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Parameter: 

x:  X-Koordinate  fur  den  Mittelpunkt 

y:  Y-Koordinate  fUr  den  Mittelpunkt 

radius:  Radius  (bzgl.  der  X-Achse) 
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ELLIPSE  (VDI 11,  GDP  5) 


Die  Funktion  ELLIPSE  zeichnet  eine  Ellipsenflache. 

Die  Ftillattribute  und  der  Schreibmodus  wcrflen  beriicksichtigt.  Das  PixelgrolJenverhaltnis 
wird  ignoriert;  der  Radius  fiir  die  X-  und  Y-Achse  ist  getrennt  zu  tibergeben. 


Deklaration  in  C: 


void  v_ellipse 
{ 


(WORD  handle,  WORD  x,  WORD  y, 
WORD  yradius) 


ptsin[0]  =  x; 
ptsin [1]  =  y; 
ptsin[2]  =  xradius; 
ptsin [3]  =  yradius; 
contrl[0]  =  11; 
contrl [1]  =  2; 
contrl[3]  =  0; 
contrl[5]  =  5; 
contrl[6]  =  handle; 
vdi  (); 


WORD  xradius. 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

1 1  Opcode  fiir  GDP 

contrl+2 

contrl[l] 

2  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

0  #  Eintrage  in  intout 

contrl+10 

contrl  [5] 

5  V_ELLIPSE 

contrl+12 

contrl[6] 

handle  Geratekennung 

ptsin 

ptsinfO] 

X 

ptsin+2 

ptsinfl] 

y 

ptsin+4 

ptsin[2] 

xradius 

ptsin+6 

ptsin[3] 

yradius 
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Parameter: 

x:  X-Koordinate  fiir  den  Mittelpunkt 

y:  Y-Koordinate  fiir  den  Mittelpunkt 

xradius:  Radius  der  Ellipse  in  X-Richtung 
yradius:  Radius  der  Ellipse  in  Y-Richtung 
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ELLIPTICAL  ARC  (VDI 11,  GDP  6) 

Die  Funktion  ELLIPTICAL  ARC  zeichnet  einen  Ellipsenbogenausschnitt.  Die  Linienattribute 
und  der  Schreibmodus  werden  beriicksichtigt. 

Das  Pixelgrofienverhaltnis  wird  ignoriert,  dieRadien  in  X-  und  Y-Richtung  sind  also  getrennt 
zu  iibergeben.  Die  Ausgabe  der  Ausscbnitts  erfolgt  entgegen  dem  Uhrzeigersinn  vom 
Anfangs-  bis  zum  Endwinkel. 

Die  Winkel  werden  in  1/10  Grad  gemessen: 


900 


2700 


Dekiaration  in  C: 

void  v_ellarc  (WORD  handle,  WORD  x,  WORD  y,  WORD  xradius, 
WORD  yradius,  WORD  begang,  WORD  endang) 

1 

ptsin[0]  =  x; 
ptsintl]  =  y; 
ptsin[2]  =  xradius; 
ptsin[3]  =  yradius; 
intin [0]  =  begang; 
intin [1]  =  endang; 
contrl[0]  =  11; 
contrlfl]  =  contrl[3]  =  2; 
contrl[5]  =  6; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

1 1  Opcode  fiir  GDP 

contrl+2 

contrl[l] 

2  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2  #  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  intout 

contrl+10 

contrl[5] 

6  VJELLARC 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

begang 

intin+2 

intinfl] 

endang 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsinfl] 

y 

ptsin+4 

ptsin[2] 

xradius 

ptsin+6 

ptsin[3] 

yradius 

Parameter: 

begang:  Startwinkel  fiir  den  EUipsenbogen  (0..3600) 

endang:  Endwinkel  fiir  den  EUipsenbogen  (0..3600) 

x:  X-Koordinate  fiir  den  Mittelpunkt 

y:  Y-Koordinate  fiir  den  Mittelpunkt 

xradius:  Radius  der  Ellipse  in  X-Richtung 

yradius:  Radius  der  Ellipse  in  Y-Richtung 
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ELLIPTICAL  PIE  (VDI 11,  GDP  7) 


Die  Funktion  ELLIPTICAL  PIE  zeichnet  einen  Ellipsenflachenausschnitt,  wie  er  auch  fur 
Tortengrafiken  benutzt  werden  kann.  Es  werden  die  Fiillattribute  und  der  Schreibmodus 
beriicksichtigt. 

Das  PixelgroBenverhaltnis  wird  ignoriert,  die  Radien  in  X-  und  Y-Richtung  sind  folglich  ge- 
trennt  zu  betrachten.  Der  Ausschnitt  wird  vom  Anfangs-  bis  zum  Endwinkel  entgegen  dem 
Uhrzeigersinn  ausgegeben. 

Die  Winkel  werden  in  1/10  Grad  gemessen: 


900 


1800 


0 


2700 


Deklaration  in  C: 

void  v_ellpie  (WORD  handle,  WORD  x,  WORD  y,  WORD  xradius, 
WORD  yradius,  WORD  begang,  WORD  endang) 


ptsin[0]  =  x; 
ptsin [1]  =  y; 
ptsin[2)  =  xradius; 
ptsin  [3]  =  yradius; 
intin [0]  =  begang; 
intin [1]  =  endang; 
contrl[0]  =  11; 
contrl[l]  =  contrl[3]  =  2; 
contrl[5]  =  7; 
contrl[6]  =  handle; 
vdi  (); 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

1 1  Opcode  fiir  GDP 

contrl+2 

contrl[l] 

2  #  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

0  #  Eintrage  in  intout 

contrl+10 

contrl  [5] 

7  V_ELLPIE 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

begang 

intin+2 

intin[l] 

endang 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsin[l] 

y 

ptsin+4 

ptsin[2) 

xradius 

ptsin+6 

ptsin[3] 

yradius 

Parameter: 


begang: 

endang: 

x: 

y: 

xradius: 

yradius: 


Startwinkel  fiir  den  Ellipsenausschnitt  (0..3600) 
Endwinkel  fiir  den  Ellipsenausschnitt  (0..3600) 
X-Koordinate  ftir  den  Mittelpunkt 
Y-Koordinate  fiir  den  Mittelpunkt 
Radius  der  Ellipse  in  X-Richtung 
Radius  der  Ellipse  in  Y-Richtung 
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ROUNDED  RECTANGLE  (VDI 11,  GDP  8) 

Die  Funktion  ROUNDED  RECTANGLE  zeichnet  ein  Rechteck  mit  abgerundeten  Ecken.  Es 
werden  die  Linienattribute,  der  Scbreibmodus  und  das  PixelgroBenverhaltnis  (beziiglich  der 
Bdgen)  beriicksichtigt. 

Deklaration  in  C: 

void  v_rbox  (WORD  handle,  WORD  *xyarray) 

{ 

pioff  =  pxyarray; 
contrl[0]  =  11; 
contrl[l]  =  2; 
contrl[3]  =  0; 
contrl[5]  =  8; 
contrl[6]  =  handle; 
vdi  ( ) ; 

pioff  =  ptsin; 

} 

GEM-Arrays: 


Adresse 

Feldeiement 

Belegung 

contrl 

contrl  [0] 

11 

Opcode  fiir  GDP 

contrl+2 

contrlfl] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

8 

VJEtBOX 

contrl+12 

contrl[6] 

handle  Geratekennung 

ptsin 

ptsin[0..3] 

xyarray[0..3] 

Parameter: 

xyarray[0]:  X-Koordinate  des  Eckpunktes 
xyarray[l]:  Y-Koordinate  des  Eckpunktes 
xyarray[2]:  X-Koordinate  der  diagonal  gegeniiberliegenden  Ecke 
xyarray[3]:  Y-Koordinate  der  diagonal  gegeniiberliegenden  Ecke 
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FILLED  ROUNDED  RECTANGLE  (VDI 11,  GDP  9) 

Die  Funktion  FILLED  ROUNDED  RECTANGLE  zeichnet  ein  ausgefiilltes  Rechteck  mit 
abgerundetenEcken.Es  werdenFullattribute,derSchreibmodusunddasPixelgroBenverhaltnis 
(beziiglich  der  Bogen)  beriicksichtigt. 

Deklaration  in  C: 

void  v_rfbox  (WORD  handle,  WORD  *xyarray) 

{ 

pioff  =  xyarray; 
contrl [0]  =  11; 
contrl[l]  =  2; 
contrl[3]  =  0; 
contrl[5]  =  9; 
contrl[6]  =  handle; 
vdi  0; 

pioff  =  ptsin; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

11 

Opcode  fur  GDP 

contrl+2 

contrlf  1  j 

2 

#  Eintrage  in  ptsin 

eontrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrI+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

9 

v_rfbox 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

ptsin 

ptsin[0..3] 

xyarray[0..3] 

Parameter: 

xyarray  [0]:  X-Koordinate  des  Eckpunktes 
xyarrayfl]:  Y-Koordinate  des  Eckpunktes 
xyarray[2]:  X-Koordinate  der  diagonal  gegeniiberliegenden  Ecke 
xyarray[3]:  Y-Koordinate  der  diagonal  gegeniiberliegenden  Ecke 
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JUSTIFIED  GRAPHICS  TEXT  (VDI 11,  GDP  10) 


JUSTIFIED  GRAPHICS  TEXT  erlaubt  die  wenig  aufwendige  Ausgabe  ernes  Textes,  genauer 
einer  Zeichenkette. 

Der  Text  wird  links  und  rechts  bezogen  auf  den  Startpunktund  die  Lange  justiert.  Um  den  Text 
auf  die  erforderliche  Lange  zu  bringen,  hat  man  die  Wahl  zwischen  Dehnung  der  Wort-  und/ 
oder  Zeichenzwischenraume. 

Die  Ausdehnung  kann  auch  unterbleiben.  Es  werden  die  Textattribute  und  der  Schreibmodus 
beriicksichtigt. 

Bei  einem  C-Binding  ist  der  String  Byte-orientiert  und  Null-terminiert,  bei  einem  Assembler- 
Binding  Word-orientiert 

Im  Zeichensatz  fehlende  Zeichen  werden  durch  ein  Ersatzsymbol  (meist  ein  Fragezeichen) 
ersetzt. 


Deklaration  in  C: 


void  v_  justified 
{ 

WORD  *tmp; 


(WORD  handle,  WORD  x,  WORD  y,  const  CHAR  *string, 
WORD  length,  WORD  word_space,  WORD  char__space) 


ptsin[0]  =  x; 
ptsin[l]  =  y; 
ptsin[2]  =  length; 
ptsin[3]  =  0; 
intin [0]  =  word_space; 
intin [1]  =  char_space; 
tmp  =  & (intin [2] ) ; 
while  (*tmp++=*string++)  ; 
contrl[0]  =  11; 
contrlfl]  =  2; 

contrl[3]  =  (int) (tmp-& (intin) ) -1; 
contrl[5]  =  10; 
contrl[6]  =  handle; 
vdi  (); 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

1 1  Opcode  fiir  GDP 

contrl+2 

contrl[l] 

2  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

n+2  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

0  #  Eintrage  in  intout 

contrl+10 

contrl[5] 

10  V_JUSTIFIED 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin  [0] 

word_space 

intin+2 

intin[l] 

char_space 

intin+4 

intin[2..n+l] 

string[0..n-l] 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsin[l] 

y 

ptsin+4 

ptsin  [2] 

length 

ptsin+6 

ptsin[3] 

0 

Parameter: 

workspace:  Flag  fiir  Wortzwischenraume 

0:  keine  Dehnung  der  Wortzwischenraume 

nicht  0:  Dehnung  der  Wortzwischenraume 
char_space:  Flag  fiir  Zeichenzwischenraume 

0:  keine  Dehnung  der  Zeichenzwischenraume 

nicht  0:  Dehnung  der  Zeichenzwischenraume 
string:  Zeiger  auf  Zeichenkette 

x:  X-Koordinate  des  Textausrichtungspunktes 

y:  Y-Koordinate  des  Textausrichtungspunktes 

length:  Texdange  (bzgl.  der  X-Achse) 
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Attributfunktionen 


SET  WRITING  MODE  (VDI32) 


SET  WRITING  MODE  bestimmt,  auf  welche  Art  und  Weise  Quellpixel  (also  zum  Beipiel  die 
aktuelle  Linienfarbe)  und  Zielpixel  (also  der  aktuelle  Hintergrund)  verkniipft  werden,  um  die 
resultierenden  Farbwerte  zu  ermitteln.  Normaler  Schreibmodus  ist  der  REPLACE-Modus. 

Die  Anzahl  der  verfiigbaren  Schreibmodi  erhalt  man  iiber  die  Funktion  EXTENDED 
INQUIRE  FUNCTION. 


Deklaration  in  C: 


WORD  vswr_mode  (WORD  handle, 
1 


intin [0]  -  mode; 
contrl[0]  =  32; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl [6]  =  handle; 
vdi  ( ) ; 

return  intout [0] ; 


WORD  mode) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

32 

Opcode  fur  VSWR_MODE 

contrl+2 

contrl  [1] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

o 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

mode 

intout 

intout[0] 

Retum-Wert 
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Parameter: 

mode:  Schreibmodus 

MD_REPLACE  (1):  Replace 

MD_TRANS  (2):  Transparent 

MD._XOR  (3):  XOR 

MD_ERASE  (4):  Reverse  Transparent 

vswr_mode():  ausgewahlter  Schreibmodus  (bei  Wahl  eines  ungiiltigen  Parameters  wird 

der  Replace-Modus  gesetzt) 

Die  Verkniipfungen  der  Schreibmodi: 

Folgende  Bezeichnungen  werden  benutzt: 

Maske:  Grafikobjekt  (Linie,  Fiillmuster,  Grafiktext,  Marker) 

Vom:  Vordergrundfarbe  des  neuen  Grafikobjektes 

Hinten:  Hintergrundfarbe  des  neuen  Grafikobjektes 

Alt:  gegenwartige  Farbe 

Neu:  resultierende  Farbe 

Die  Erfahrung  zeigt,  dafi  man  die  Unterschiede  zwischen  den  verschiedenen  Modi  am  besten 
anhand  eines  Beispiels  versteht.  Daher  lehnen  wir  uns  in  den  folgenden  Ausfuhrungen  an  das 


Abb.  3.3:  Die  Verkniipfungen  der  Schreibmodi 


VDI-Betriebssystemroutinen 


379 


“GEM  Programmier-Handbuch”  (ebenfalls  bei  SYBEX  erschienen,  mittlerweile  leider  aber 
nicht  mehr  erhaltlich)  an. 

In  der  fol  genden  Beschreibung  der  Verkniipfungen  gehen  wir  von  der  in  Abbildung  3.3  gezeig- 
ten  Sachlage  aus:  der  Hintergrund  ist  in  eine  schwarze  und  eine  weifie  Halfte  geteilt.  Anf  die- 
sem  Hintergrund  wird  nun  die  rechts  gezeigte  Figur  ausgegeben.  Die  gemusterten  Flachen  ste- 
hen  fiir  gesetzte  Bits,  die  weiBen  fur  nicht  gesetzte.  Die  folgenden  vier  Beispiele  zeigen  die 
Auswirkungen  der  verschiedenen  Verkniipfungen: 

MD_REPLACE 

Diese  Darstellungsart  ist  einfach  zu  verstehen.  Wenn  das  VDI  ein  Bild  ausgibt,  iiberschreibt 
es  den  Hintergrund  mit  der  Vordergrundfarbe,  wenn  das  entsprechende  Bit  gesetzt  ist,  oder 
es  setzt  ein  weiBes  Pixel,  wenn  das  Bit  0  ist.  Die  logische  Verkniipfung  lautet: 

Neu  (Vorn  AND  Maske)  OR  (Hinten  AND  NOT  maske) . 

Um  das  Ganze  auf  Papier  und  Bleistift  zu  ubertragen:  zunachst  malt  man  die  Figur  auf  weiBes 
Papier,  schneidet  sie  dann  aus  und  klebt  den  Schnipsel  dann  auf  die  Grafik. 

MDJTRANS 

Bei  der  transparenten  Darstellung  ignoriert  das  VDI  alle  Bits  der  zu  zeichnenden  Form,  die 
auf  0  gesetzt  sind,  und  gibt  lediglich  die  Bits  aus,  die  gesetzt  sind.  Die  logische  Verkniipfung 
lautet: 

Neu  :=  (Vorn  AND  Maske)  OR  (ALT  AND  NOT  Maske) 

Und  wieder  die  Papieranalogie:  dieser  Modus  entspricht  dem  Ersetzen,  nur  daB  man  auf 
durchsichtige  Folie  zeichnet. 

MD_XOR 

Diese  Darstellungsart  eignet  sich  vorziiglich  fur  das  Zeichnen  von  Figuren,  die  ohne  Anderung 
des  Hintergrunds  wieder  geloscht  oder  bewegt  werden  sollen.  Die  Bits  der  Hintergrunds  und 
der  zu  zeichnenden  Figur  werden  mit  einem  Exldusiv-ODER  (XOR)  verkntipft,  Diese 
Verkniipfung  hat  eine  sehr  interessante  Eigenschaft. 

Wenn  Sie  die  Figur  eine  zweites  Mai  in  der  Darstellungsart  XOR  ausgeben,  ist  die  Figur 
plotzlich  wieder  verschwunden.  Der  Grund  hierfiir  liegt  in  der  Tatsache,  daB  die  XOR- 
Verkniipfung  eines  Bits  mit  sich  selbst  den  inversen  Wert  ergibt. 

Sie  konnen  diese  Darstellungsart  ftir  einfache  Animationen  wie  eine  Gummibox  einsetzen. 
Auch  bewegte  Objekte  konnen  auf  diese  Art  und  Weise  gezeichnet  werden: 
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1 .  Das  Objekt  einmal  ausgeben. 

2.  Das  gleiche  Objekt  emeut  ausgeben  (nun  ist  es  wieder  verschwunden). 

3.  Objekt  verandem  (GroBe,  Position). 

4.  Zuriick  zu  Schritt  1 . 


Die  logische  Verkiipfung  fiir  MD_XOR: 

Neu:=  (Maske  XOR  Alt) 

Man  beachte,  daB  das  Resultat  vollig  unabhangig  von  der  eingestellen  Ausgabefarbe  ist! 


Abb.  3.4:  Der  XOR-Modus 
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In  Farbauflosungen  werden,  wie  auch  im  monochrotnen  Modus,  die  Pixelwerte  exklusiv- 
oderiert,  jedoch  ist  der  Effekt  schwerer  vorherzusehen.  Im  XOR-Modus  werden  die  Bits 
gemaB  der  gemalten  Figur  mit  XOR  logisch  verknlipft,  unabhangig  von  der  Farbe  des  Musters 
oder  der  gemalten  Figur! 

Beispielsweise  wird  aus  einem  Pixel wert  (bei  vier  Farbebenen)  0x1011  in  Verbindung  mit 
XOR  0x0100,  Vor  allem  ist  damit  klar,  daB  aus  Schwarz  Weifl  wird  und  umgekehrt.  Alles 
andere  ist  nicht  fest  definiert.  Stehen  vier  Farben  zur  Verfugung  (beispielsweise  niedrige  ST- 
Auflosung),  so  wird  aus  Rot  durch  XOR  Grim  und  umgekehrt.  Stehen  jedoch  16  Farben  zur 
Verfugung  (beispielsweise  mittlere  TT -Auflosung),  so  wird  aus  Rot  Dunkelcyan  und  aus  Grim 
Dunkelmagenta!  Der  monochrome  Modus  ist  folglich  nur  ein  (sehr  einfacher)  Spezialfall! 

MDJ5RASE  (“Reverse  Transparent) 

Bei  der  invers  transparenten  Darstellung  werden  nur  die  auf  0  gesetzten  Pixel  des  zu 
zeichnenden  Bildes  beriicksichtigt  (im  Gegensatz  zur  transparenten  Darstellung).  Alle  nicht 
gesetzten  Bits  werden  beim  Zeichnen  in  der  Vordergrundfarbe  ausgegeben, 

Diese  Darstellungsart  bietet  einige  interessante  Einsatzmoglichkeiten.  Sie  konnen  die  trans- 
parente  und  die  invers  transparente  Darstellung  gemeinsam  benutzen,  um  beispielsweise  eine 
zweifarbige  unterbrochene  Linie  oder  Text  mit  einer  zusatzlichen  Hintergrundfarbe  erschei- 
nen  zu  lassen. 

In  beiden  Fallen  geben  Sie  die  Figur  erst  in  der  transparenten  Darstellung  mit  einer 
Vordergrundfarbe  aus,  andem  dann  die  Vordergrundfarbe  und  geben  die  Figur  ein  zweites  Mai 
mit  invers  transparenter  Darstellung  aus. 

Die  logische  Verkniipfung  fiir  MD_ERASE: 


Neu  :=  (Alt  AND  Maske)  OR  (Vorn  AND  NOT  Maske) 
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Diese  Funktion  wahlt  die  Farbintensitat  zu  den  einzelnen  Farbregistem.  Gewahlt  wird  mit 
einer  Intensitat  der  RGB-Farben  (Rot,  Griin,  Blau)  zwischen  0  und  1000  (Promille).  Sollte  eine 
ungiiltige  Farbnummer  iibergeben  werden,  so  werden  die  erreichbaren  Werte  angenommen, 
also  bei  negativen  Werten  0  und  bei  zu  grofien  Werten  1000. 


Ublicherweise  verfiigt  nicht  jedes  Ausgabegerat  iiber  1000  mogliche  Farbabstufungen. 
Folglich  sind  fur  verschiedene  Eingabe-Intensitaten  der  RGB-Farben  die  tatsachlich  einge- 
stellten  Intensitaten  gleich.  Die  Anzahl  der  Farbindizes  ist  gerateabhangig  und  kann  beim 
Offnen  der  (virtuellen)  Workstation  abgeffagt  werden. 


SET  COLOR  REPRESENTATION  kann  nur  benutzt  werden,  wenn  “Lookup-table”-Unter- 
stiitzung  vorhanden  ist  (anderenfalls  gibt  es  ja  keine  Farbregister,  die  man  setzen  konnte). 


Deklaration  in  C: 

void  vs_color  (WORD  handle,  WORD  index,  WORD  *rgb_in) 
! 

WORD  i; 

intin [0]  =  index; 
for  (i=l;  i<4;  i++) 

intin [i]  =  *rgb_in++; 
contrl[0]  =  14; 
contrl[l]  =  0; 
contrl[3]  =  4; 
contrl[6]  =  handle: 
vdi  ( ) ; 

} 


GEM- Arrays: 


Adresse 

Feldelement 

contrl 

contrl[0] 

contrl+2 

contrl[l] 

contrl+4 

contrl  [2] 

contrl+6 

contrl[3] 

contrl+8 

contrl  [4] 

contrl+12 

contrl  [6] 

Belegung 

1 4  Opcode  fur  VS_COLOR 

0  #  Eintrage  in  ptsin 

0  #  Eintrage  in  ptsout 

4  #  Eintrage  in  intin 

0  #  Eintrage  in  intout 

handle  Geratekennung 
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Adresse 

Feldelement 

Belegung 

intin 

intin[0] 

index 

intin+2 

intin[1..3] 

rgb_in[0..2] 

Parameter: 


index: 

rgbJntO]: 

rgb_in[l]: 

rgb_in[2]: 


Farbnummer  (die  ersten  16  Farbnummem  werden  vom  AES  benutzt 
und  sollten  deshalb  nicht  verandert  werden!) 

Farbintensitat  von  Rot 
Farbintensitat  von  Griin 
Farbintensitat  von  Blau 


Tabelle  der  VDI-Standardfarben: 


Index 

Farbe 

Bezeichnung 

0 

weiB 

WHITE 

1 

schwarz 

BLACK 

2 

rot 

RED 

3 

griin 

GREEN 

4 

blau 

BLUE 

5 

cyan 

CYAN 

6 

gelb 

YELLOW 

7 

magenta 

MAGENTA 

8 

hellgrau 

LWHITE 

9 

dunkelgrau 

LBLACK 

10 

dunkelrot 

LRED 

11 

dunkelgriin 

LGREEN 

12 

dunkelblau 

LBLUE 

13 

dunkelcyan 

LCYAN 

14 

dunkelgelb 

LYELLOW 

15 

dunkelmagenta 

LMAGENTA 

dariiber: 

gerateabhangig 

384 


ATARI  Profibuch 


SET  POLYLINE  LINE  TYPE  (VDI 15) 

Diese  Funktion  wahlt  die  (Polyline-)Liniendarstellung  aus.  Die  Anzahl  der  verfiigbaren 
Darstellungen  ist  quasi  unbegrenzt,  Sechs  Linienformen  sind  fiir  alle  Gerate  fest  vorgegeben. 
Weitere  sind  gerateabhangig  bzw.  konnen  selbst  defmiert  werden. 

Ist  ein  gewahlter  Linientyp  nicht  verfiigbar,  so  wird  der  Linientyp  “durchgezogen”  (oder 
genauer:  LTJSOLID)  gewahlt.  Bei  der  Benutzung  dickerer  Linien  wird  unter  Umstanden  auf 
den  Defaulttyp  gewechselt  und  auch  der  Schreibmodus  verandert. 

Die  entsprechenden  Verfiigbarkeiten  bei  dem  Ausgabegerat  konnen  mit  EXTENDED 
INQUIRE  FUNCTION  abgefragt  werden. 

Deklaration  in  C: 

WORD  vsl__type  (WORD  handle,  WORD  style) 

{ 

intin [0]  =  style; 
contrl[0]  =  15; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  (); 

return  intout [0]; 

} 


GEM-Arrays; 


Adresse 

Feidelement 

Belegung 

contrl 

contrl[0] 

15 

Opcode  fur  VSLJTYPE 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

I 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

1 

#  Eintrage  in  intout 

contrl+ 12 

contrl  [6] 

handle 

Geratekennung 

intin 

intout 

intin[0] 

intout[0] 

style 

Retum-Wert 
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Parameter: 

style:  Linienstil  (1  =  gesetztes  Pixel,  0  =  nicht  gesetztes  Pixel),  16  Bits 


style 

LTJSOLID  (1) 
LT_LONGDASH  (2) 
LT_DOTTED  (3) 
LT_DASHDOT  (4) 
LT_DASHED  (5) 
LT_DASHDOTDOT  (6) 
LT_USERDEF  (7) 

8  und  mehr 

vsl_type():  ausgewahlter  Linienstil 


MSB  LSB 

1111111111111111  (durchgehend) 
1111111111110000  Ganger  Stricb) 
1110000011100000  (Punkte) 
111111100011 1000  (Strich,  Punkt) 
1111111100000000  (Strich) 

111  10001 10011 000  (Strich,  Punkt,  Punkt) 
frei  definierbar  (Default:  LT_SOLID) 
abhangig  vom  Ausgabegerat 
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SET  USER-DEFINED  LINE  STYLE  PATTERN  (VDI 113) 


Mit  dieser  Funktion  kann  der  siebte  (frei  definierbare)  Linientyp  von  SET  POLYLINE  LINE 
TYPE  (VDI  15)  festgelegt  werden.  Als  erster  Punkt  der  Linie  wird  das  hochstwertige  Bit  des 
1 6-Bit- Wortes  gewahlt.  Standardwert  ist  eine  durchgezogene  Linie. 


Deklaration  in  C: 


void  vsl__udsty  (WORD  handle,  WORD  pattern) 

{ 


} 


intin [0] 
contrl [0] 
contrl [1] 
contrl [3] 
contrl [6] 
vdi  (); 


=  pattern; 
=  113; 

=  0; 

=  If 

=  handle; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

113 

Opcode  fur  VSLJJDSTY 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

pattern 

Parameter; 

pattern:  Linienmuster  als  16-Bit-Wort 
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SET  POLYLINE  LINE  WIDTH  (VDI 16) 

Mit  dieser  Funktion  wahlt  man  die  Linienbreite.  Die  Funktion  ist  nicht  auf  alien  Ausgabegeraten 
einsetzbar.  Die  gesetzte  Breite  ist  kleiner  oder  gleich  der  gewahlten  Breite.  Eine  Korrektur  der 
Breite  seitens  der  Funktion  kann  notig  sein,  wenn  kein  passender  Wert  (eine  ungerade  Zahlen) 
iibergeben  wurde.  Die  Breite  der  Linie  bezieht  sich  immer  auf  Koordinaten  in  X-Richtung. 

Deklaration  in  C: 

WORD  vsl_width  (WORD  handle,  WORD  width) 

{ 

ptsin [0]  =  width; 
ptsin [1]  =  0; 
contrl [0]  =  16; 
contrl [1]  =  1; 
contrl[3]  =  0; 
contrl [6]  =  handle; 
vdi  ( ) ; 

return  ptsout [ 0 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

16 

Opcode  fur  VSLWIDTH 

contrl+2 

contrl[l] 

1 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

ptsin 

ptsin[0] 

width 

ptsin+2 

ptsin[l] 

0 

ptsout 

ptsout[0] 

Retum-Wert 

ptsout+2 

ptsout[l] 

0 

Parameter: 

width:  Linienbreite  (nur  ungerade  Werte  ab  1 ;  bei  falscher  Wahl  wird  die  nachstkleinere 

mogliche  Linienbreite  gewahlt) 

vsl_width():  ausgewahlte  Linienbreite  (beziiglich  der  X-Achse) 
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SET  POLYLINE  COLOR  INDEX  (VDI 17) 

Mit  dieser  Funktion  kann  die  Linienfarbe  gewahlt  werden.  Die  zwei  Standardindizes  0  und 
1  sind  auf  alien  Geraten  verfiigbar.  Weitere  hangen  vom  Ausgabegerat  ab. 

Deklaration  in  C: 

WORD  vsl_color  (WORD  handle,  WORD  color_index) 

{ 

intin [0]  =  color_index; 
contrl [0]  =17; 
contrl [1]  =  0; 
contrl [3]  =  1; 
contrl[6]  =  handle; 
return  intout [0]; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

1 7  Opcode  fur  VSLJZOLOR 

contrl+2 

contrl[  1  ] 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1  #  Eintrage  in  intin 

eontrl+8 

contrl  [4] 

1  #  Eintrage  in  intout 

contrl+12 

contrlf6] 

handle  Geratekennung 

intin 

intin[0] 

color_index 

intout 

intout[0] 

Retum-Wert 

Parameter: 

colorjndex:  Linienfarbe 

vsLeolor():  ausgewahlte  Linienfarbe  (bei  ungiiltigem  Farbindex:  I) 
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SET  POLYLINE  END  STYLES  (VDI 108) 


Mit  dieser  Funktion  wird  das  Aussehen  der  Linienenden  gewahlt.  Das  normale  Aussehen  der 
Enden  ist  ein  eckiger  LinienabschluB. 


Zusatzlich  gibt  es  noch  abgerundete  Enden  Oder  Enden  mit  Pfeilspitzen.  Audi  ein  ganzer 
Polygonzug  wird  als  Linie  betrachtet.  Das  Ende  der  Linie  ist  bei  der  Pfeilspitze  in  der  Spitze, 
bei  dem  abgerundeten  Ende  jedoch  im  Zentrum  des  (Halb-)Kreises,  der  das  Ende  darstellt. 


Abb.  3.5:  Die  verschiedenen  Linien-Endstile 


Deklaration  in  C: 

void  vsl_ends  (WORD  handle,  WORD  beg_style,  WORD  end_style) 
{ 

intin [0]  =  beg_style; 
intin [1]  =  end_style; 
contrl(0]  =  108; 
contrl[l]  =  0; 
contrl[3]  =  2; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

108 

Opcode  fur  VSLJ3NDS 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3j 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intinfO] 

beg_style 

intin+2 

intinf  1] 

end_style 

Parameter: 

beg_style:  Aussehen  des  Linienendes  am  Anfangspunkt  der  Linie. 

LE_SQUARED(0):  eckig 
LE_ARROWED  (1):  Pfeilform 
LE_ROUNDED  (2):  abgerundet 
end_style:  analog  mit  dem  Endpunkt 
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SET  POLYMARKER  TYPE  (VDI 18) 


Mit  dieser  Funktion  kann  das  Aussehen  der  Marker  ausgewahlt  werden,  von  denen  es 
mindestens  die  aufgefiihrten  sechs  gibt.  Bei  Ubergabe  einer  ungiiltigen  Nummer  wird  der 
dritte  Typ  gewahlt.  Der  erste  Typ  (der  Punkt)  kann  in  der  GroBe  nicht  verandert  werden. 


Abb.  3.6:  Die  Markertypen 


Deklaration  in  C: 

WORD  vsm_type  (WORD  handle,  WORD  symbol) 
{ 

intin [0]  =  symbol; 
contrl[0]  =  18; 
contrl[l]  =  0; 
contrl[3]  -  1; 
contrl [6]  =  handle; 
vdi  ( ) ; 

return  i nt  out [ 0 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

18 

Opcode  fur  VSMJTYPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

symbol 

intout 

intout[0] 

Retum-Wert 
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Parameter: 

symbol: 


vsmjype(): 


Markertyp 

MT_DOT  (I):  Punkt 

MT_PLUS  (2):  Plus 

MT_ASTERISK  (3):  Sternchen 
MT_SQUARE  (4):  Quadrat 

MT_DCROSS  (5):  Kreuz 

MT_DIAMOND  (6):  Raute 


iiber  7:  gerateabhangig 

ausgewahlter  Markertyp  (bei  falschen  Eingabewerten  wird  MT_ASTERISK 
gewahlt) 
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SET  POLYMARKER  HEIGHT  (VDI 19) 

Mit  dieser  Funktion  kann  die  Markerhohe  (auBcr  bei  Typ  1)  beziiglich  der  Y-Achse  gewahlt 
werden,  wobei  die  Breite  angepaBt  wird. 

Bei  Angabe  einer  ungiiltigen  (zu  groBen)  Hohe  wird  die  nachstkleinere  gewahlt.  Die  Anzahl 
der  verfiigbaren  Hohen  wird  beim  Offnen  der  (virtuellen)  Workstations  zuriickgegeben. 

Deklaration  in  C: 

WORD  vsm_height  (WORD  handle,  WORD  height) 

{ 

ptsin[0]  =  0; 
ptsin[l]  =  height; 
contrl[0]  =  19; 
contrl[l]  =  1; 
contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  ()  ; 

return  ptsout  [1] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

1 9  Opcode  fur  VSMJHEIGHT 

contrl+2 

contrl[l] 

1  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

1  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0  #  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  intout 

contJl+12 

contrl[6] 

handle  Gcratekennung 

ptsin 

ptsin  [0] 

0 

ptsin+2 

ptsin[l] 

height 

ptsout 

ptsout[0] 

set„height_x 

ptsout+2 

ptsout[l] 

Retum-Wert 
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Parameter: 

height: 

set_height„x: 

vsm_height(): 


Markerhohe  bzgl.  Y -Richtung  (bei  falscher  Wahl  wird  die  nachstkleine- 
re  mogliche  GroBe  gewahlt) 

ausgewahlte  Markerhohe  bzgl.  X-Richtung  (das  PixelgroBenverhaltnis 
wird  beriicksichtigt);  bei  PC-GEM  erhalt  man  lediglich  eine  0  als  Riick- 
gabewert 

ausgewahlte  Maikerhohe  bzgl.  Y-Richtung 
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SET  POLYMARKER  COLOR  INDEX  (VDI 20) 

MitdieserFunktion  wahlt  man  die  Farbeder  Marker.  ZweiFarbindizes  (Ound  l)sindaufjeden 
Fall  verfiigbar,  weiterehangen  von  dem  jeweiligen  Ausgabegerat  ab.  Ein  ungiiltiger  Farbindex 
wird  durch  den  Index  1  ersetzt. 

Deklaration  in  C: 

WORD  vsm_color  (WORD  handle,  WORD  color_index) 

{ 

intin  [0]  =  color_index; 
contrl[0]  =  20; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  (); 

return  intout [0] ; 

1 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

20  Opcode  fur  VSM_COLOR 

contrl+2 

control] 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1  #  Eintrage  in  intin 

contrl+8 

contrl  [4] 

1  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin  [0] 

color_index 

intout 

intout[0] 

Retum-Wert 

Parameter; 

color_index;  gewiinschte  Markerfarbe 

vsm_color():  ausgewahlte  Markerfarbe  (1  bei  ungiiltigem  Farbindex) 
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SET  CHARACTER  HEIGHT,  ABSOLUTE  MODE  (VDI  12) 


Mit  dieser  Funktion  kann  die  absolute  Zeichenhohe,  von  der  Basislinie  bis  zur  Zeichenzellen- 
obergrenze,  bestimmt  werden.  1st  die  gewiinschte  Zeichenhohe  nicht  verfiigbar,  so  wahlt  SET 
CHARACTER  HEIGHT  die  nachstkleinere  verfiigbare. 

Es  wird  die  grofite  Zeichen-  und  Zellenbreite  zuriickgegeben.  Sie  ist  somit  insbesondere  bei 
Proportionalfonts  gleich  der  Breite  des  breitesten  Zeichens. 

Bei  nicht  proportionalen  Schriften  sind  logischerweise  alle  Zeichen  gleich  breit. 


Deklaration  in  C: 

void  vst__height  (WORD  handle,  WORD  height,  WORD  *char_width, 
WORD  *char_height,  WORD  *cell_width, 

WORD  *cell_height) 

{ 

ptsinfO]  =  0; 
ptsin[l]  =  height; 
contrl [0]  =  12; 
contrl [1]  =  1; 
contrl [3]  =  0; 
contrl [6]  =  handle; 
vdi  ( )  ; 

*char_width  =  ptsoutfO]; 

*char_height  =  ptsoutfl]; 

*cell_width  =  ptsout[2]; 

*cell_height  =  ptsout [3] ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl  [0] 

12 

Opcode  fur  VST_HEIGHT 

contrl+2 

contrl[l] 

1 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

2 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 
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Adresse 

Feldelement 

Belegung 

ptsin 

ptsinfO] 

0 

ptsin+2 

ptsin[l] 

height 

ptsout 

ptsout[0] 

char_width 

ptsout+2 

ptsoutfl] 

char_height 

ptsout+4 

ptsout[2] 

celLwidth 

ptsout+6 

ptsout[3] 

cell.height 

Parameter: 


height: 

char.wjdth: 

char_height: 

cell_width: 

cell_height: 


Zeichenhohe  (bei  falscher  Wahl  wird  die  nachstkleinere  mogliche  Zeichensatz- 
grofie  eingesetzt) 

ausgewahlte  Zcichenbreite  in  NDC/RC-Einheiten  beziiglich  der  X-Achse 
ausgewahlte  Zeichenhohe  in  NDC/RC-Einheiten  beziiglich  der  Y-Achse 
ausgewahlte  Zeichenzellenbreite  in  NDC/RC-Koordinaten  beziiglich  der  X- 
Achse 

ausgewahlte  Zeichenzellenhohe  in  NDC/RC-Koordinaten  beziiglich  der  Y- 
Achse 


Bemerkungen 

Die  meisten  Bildschirmtreiber  (auch  der  im  ROM)  konnen  bei  “vst_height()”  vorhandene 
Fonts  beliebig  verkleinem  oder  auf  das  Doppelte  vergroBem. 
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SET  CHARACTER  HEIGHT,  POINTS  MODE  (VDI 107) 


Mit  dieser  Funktion  kann  die  ZeichenzellengroBe  -  Abstand  zweier  Basislinien  -  bestimmt 
werden.  Gemessen  wird  der  Abstand  in  (Drucker-)Point  (1/72  Zoll,  ungefahr  0,353  mm;  dies 
entspricht  nicht  dem  typografischen  Punkt  mit  einer  Hohe  von  ca.  0,38  mm!). 


1st  die  gewunschte  Zeichenhohe  nicht  verfiigbar,  so  wird  die  nachstkleinere  gewahlt.  Bei  pro- 
portionalen  Zeichensatzen  werden  filr  Breite  und  H6he  die  maximal  moglichen  Werte  zurtick- 
gegeben. 


Deklaration  in  C: 

WORD  vst_point  (WORD  handle,  WORD  point,  WORD  *char_width, 
WORD  *char_height,  WORD  *cell_width, 

WORD  *cell_height) 

{ 

intin [0]  =  point; 
contrl  [0J  =  107; 
contrl[l]  =  0; 
contrl[3]  =1; 
contrl[6]  =  handle; 
vdi  (); 

*char_width  =  ptsout(0]; 

*char_height  =  ptsout[l]; 

*celljwidth  =  ptsout[2]; 

*cell_height  =  ptsout[3]; 
return  intout [0] ; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

107 

Opcode  fur  VST_POINT 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

2 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8  , 

contrl  [4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 
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Adresse 

Feldelement 

Belegung 

intin 

intin[0] 

point 

intout 

intout[0] 

Retum-Wert 

ptsout 

ptsout[0] 

char_width 

ptsout+2 

ptsout[l] 

char_height 

ptsout+4 

ptsout  [2] 

cell_width 

ptsout+6 

ptsout[3] 

cell„height 

Parameter: 


point: 

vst_point(): 

char_width: 

char_height: 

cel]_width: 

cell_height: 


Zeichenzellenhohe  in  Point  (bei  falscher  Wahl  wird  die  nachstkleinere  mogli- 
che  ZeichensatzgroBe  eingesetzt) 

Ausgewahlte  Zeichenzellenhohe  in  Point 

Ausgewahlte  Zeichenbreite  in  NDC/RC-Einheiten  beziiglich  der  X-Achse 
Ausgewahlte  Zeichenhohe  in  NDC/RC-Einheiten  beziiglich  der  Y-Achse 
Ausgewahlte  Zeichenzellenbreite  in  NDC/RC-Einheiten  beziiglich  der  X- 
Achse 

Ausgewahlte  Zeichenzellenhohe  in  NDC/RC-Einheiten  beziiglich  der  Y- 
Achse 


Bemerkungen 

Der  ROM-Bildschirmtreiber  kann  vorhandene  Zeichensatze  jeweils  auf  die  doppelte  GroBe 
skalieren.  Daher  ist  es  nicht  ohne  weiteres  moglich,  zwischen  “skalierten”  und  tatsachlich  vor- 
handenenFonts  zu  unterscheiden.  DiefolgendeRoutinen  ermitteltalle  vorhandenen  PunktgroBen 
fiir  den  aktuell  eingestellten  Zeichensatz.  Sie  basiert  darauf,  daB  “vst_point()”  im  Zweifel  die 
nachstkleinere  vorhandene  GroBe  wahlt: 


/*  AnfangsgroiJe:  999  Punkt  */ 

WORD  asked_for  =  999,  got_size; 
got__size  =  asked_for; 

/*  Solange  die  zuletzt  gefundene  GroBe  tatsachlich  kleiner  oder 
gleich  der  verlangten  ist  */ 
while  (got_size  <=  asked_for) 

{ 

/*  Versuch:  ein  Punkt  kleiner  als  der  zuletzt  gefundene  */ 
got_size  =  vst_point  (handle,  asked_for,  sdummy,  sdummy, 

&dunmy,  &dummy) ; 

printf  ("available  size:  %d\n",  got_size) ; 


} 
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Wenn  man  feststellt,  daB  alle  PunktgroBen  vorhanden  sind,  liegt  offensichtlich  ein  frei- 
skalierbarer  Zeichensatz  vor  (wie  etwa  bei  einem  VDI-Postscript-Treiber).  In  einem  solchen 
Fall  sollte  man  dem  Anwender  nur  eine  Liste  von  StandardgroBen  anzeigen  und  die  exakte 
GroBenangabe  liber  ein  Edit-Feld  erlauben. 
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Mit  dieser  Funktion  kann  die  Ausrichtung  der  Basislinie  (fur  Textausgabe)  gewahlt  werden. 
Gemessen  wird  in  1/10  Grad.  Auf  einigen  Geraten  ist  die  Funktion  nicht  oder  nur  in  Teilen 
verfiigbar,  Der  Bildschirmtreiber  im  ROM  unterstiitzt  nur  die  Rotation  in  90-Grad-Schritten. 
SET  CHARACTER  BASELINE  VECTOR  nimmt  den  Winkel,  der  dem  gewiinschten  am 
nachsten  liegt. 


Dekiaration  in  C: 

WORD  vst_rotation  (WORD  handle,  WORD  angle) 
{ 

intin [0]  =  angle; 
contrl[0]  =  13; 
contrl [1]  =  0; 
contrl[3]  =  1; 
contrl [6]  =  handle; 
vdi  ( )  ; 

return  intout [0] ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

13 

Opcode  fur  VST_ROTATION 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intout 

intin[0] 

intout[0] 

angle 

Retum-Wert 

Parameter: 

angle:  gewiinschte  Basislinienausrichtung  (0..3600) 

vst_rotation():  ausgewahlte  Basislinienausrichtung 
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SET  TEXT  FACE  (VDI 21) 


Diese  Funktion  wahlt  -  sofern  verfiigbar  -  einen  Zeichensatz  fiir  die  nachfolgenden 
Grafiktextausgaben  aus.  Die  Unterstiitzung  der  Zeichensatze  hangt  vom  jeweiligen  Gerat  ab. 
Die  Namen  und  Indizes  werden  iiber  INQUIRE  FACE  NAME  AND  INDEX  bestimmt. 


Deklaration  in  C: 

WORD  vst_font  (WORD  handle,  WORD  font) 
( 

intin [0]  =  font; 
contrl[0]  =  21; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  ( ) ; 

return  intout [0 ] ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

21 

Opcode  fur  VST_FONT 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contiI[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intout 

in  tin  [0] 
in  tout  [0] 

font 

Retum-Wert 

Parameter: 

font:  Zeichensatzindex  (die  konkreten  Nummem  muS  man  mittels  “INQUIRE 

FACE  NAME  AND  INDEX”  abfragen!) 
vst_font():  ausgewahlter  Zeichensatz 
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SET  GRAPHIC  TEXT  COLOR  INDEX  (VDI22) 

Mit  dieser  Funktion  kann  die  Farbe  des  Textes  gewahlt  werden.  Verfiigbar  sind  mindestens 
die  Indizes  0  und  1 ,  weitere  sind  vom  jeweiligen  Ausgabegerat  abhangig.  Bei  Obergabe  eines 
ungiiltigen  Farbindexes  wahlt  SET  GRAPHIC  TEXT  COLOR  INDEX  den  Index  1. 

Deklaration  in  C: 

WORD  vst_color  (WORD  handle,  WORD  color_index) 

{ 

intin [0]  =  colorjndex; 
contrl[0]  =  22; 
contrlfl]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  ( )  ; 

return  intout [ 0 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

22 

Opcode  fur  VST.COLOR 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

I 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

colorjndex 

intout 

intout[0] 

Retum-Wert 

Parameter: 

colorjndex:  gewiinschte  Textfarbe 

vst_color():  ausgewahlte  Textfarbe  (1  bei  Ubergabe  eines  ungiiltigen  Indexes) 
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SET  GRAPHIC  TEXT  SPECIAL  EFFECTS  (VDI 106) 

Mit  dieser  Funktion  konnen  verschiedene  spezielle  Texteffekte  ausgewahlt  werden.  Es  besteht 
die  Moglichkeit,  diese  Effekte  untereinander  zu  vermischen. 

Als  Effekte  stehen  zur  Verfiigung: 

-  fett 
-hell 

-  kursiv 

-  unterstrichen 

-  umrandet,  ausgehohlt 

-  schattiert 

-  jede  Kombination  der  obengenannten  Effekte 

Nicht  verfiigbare  Texteffekte  werden  nicht  gesetzt.  Die  moglichen  Grundeffekte: 


nornal  fett  hell  tears! a  unterstrichen  stDSgjQQlSDbfi'3 


Abb.  3.7:  Die  moglichen  Texteffekte 


Deklaration  in  C: 

WORD  vst_effects  (WORD  handle,  WORD  effect) 
{ 

intin [0]  =  effect; 
contrl[0]  =  106; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6)  =  handle; 
vdi  ( ) ; 

return  intout [ 0 ] ; 

} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

106 

Opcode  fiir  VST_EFFECTS 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0] 

effect 

intout 

intoutfO] 

Retum-Wert 

Parameter: 


effect: 


gewtinschter  Texteffekt  in  Bitdarstellung 

TF_NORMAL 

(0x00): 

normaler  Text 

TFTHICKENED 

(0x01): 

Fettschrift 

TF_LIGHTENED 

(0x02): 

helle  Schrift 

TF_SLANTED 

(0x04): 

kursive  Schrift 

TF_UNDERLINED 

(0x08): 

unterstrichene  Schrift 

TF.OIJTUNED 

(0x10): 

ausgehohlte,  umrandete  Schrift 

TF_SHADOWED 

(0x20): 

schattierte  Schrift  (im  ROM-Treiber  nicht 
implementiert) 

vst_effects():  ausgewahlter  Texteffekt 
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SET  GRAPHIC  TEXT  ALIGNMENT  (VDI 39) 

Mit  dieser  Funktion  kann  die  horizontale  (beziiglich  der  Basislinie)  und  vertikale  Ausrichtung 
(senkrecht  zur  Basislinie)  eines  Textes  bestimmt  werden.  Horizontal  sind  drei  und  vertikal 
sechs  Moglichkeiten  verfiigbar. 

Defaulteinstellung  istder  linke  Rand  der  Basislinie  (und  nicht  die  untere  linke  Ecke  der  linken 
Zeichenzelle). 


Abb.  3.8:  Die  unterschiedlichen  Textausrichtungen 


Deklaration  in  C: 

void  vst_alignment  (WORD  handle,  WORD  hor__in,  WORD  vert_in, 
WORD  *hor__out,  WORD  *vert_out) 

{ 

intin [0]  =  hor_in; 
intin [1]  =  vert_in; 
contrl[0]  =  39; 
contrl[l]  =  0; 
contrl(3]  «  2; 
contrl[6]  =  handle; 
vdi  ( ) ; 

*hor_out  =  intout [0] ; 

*vert_out  =  intout [ 1 ] ; 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

39 

Opcode  fur  VST_ALIGNMENT 

contrl+2 

contrl[  1  ] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

2 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin  [0] 

horjn 

intin+2 

intin[l] 

vert_in 

intout 

intout[0] 

hor_out 

intout+2 

intoutf  1] 

vert_out 

Parameter: 

horjn:  horizontale  Ausrichtung 

TA_LEFT  (0):  linksjustiert  (default) 

TA_CENTER  (1):  zentriert 
TA_RIGHT  (2):  rechtsjustiert 

vert_in:  vertikale  Ausrichtung 

TA_BASELINE  (0):  Basislinie  (default) 

TA_HALF  (1):  Halblinie  (Oberkante  Kleinbuchstaben) 

TA_ASCENT  (2):  Zeichenoberkante 
TA_BOTTOM  (3):  Zeichenzellenunterkante 
TA_DESCENT  (4):  Zeichenunterkante 
TA_TOP  (5):  Zeichenzellenoberkante 

hor_out:  ausgewahlte  horizontale  Ausrichtung 

vert_out:  ausgewahlte  vertikale  Ausrichtung 
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SET  FILL  INTERIOR  INDEX  (VDI 23) 


Mit  dieser  Funktion  wird  der  Fiilltyp  ausgewahlt.  Man  hat  die  Wahl  zwischen  fiinf  Typen:  leer 
(Hintergrundfarbe),  voll  (monochrom),  Muster,  schraffiert,  frei  definiert.  Bei  Obergabe  eines 
ungiiltigen  Typs  wfflilt  SET  FILL  INTERIOR  INDEX  den  Typ  “leer”. 

Deklaration  in  C: 

WORD  vsf_interior  (WORD  handle,  WORD  style) 

{ 

intin [0]  =  style; 
contrl[0]  =  23; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  () ; 

return  intout [0]; 

) 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

23 

Opcode  fur  VSF .INTERIOR 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrI+6 

contrl[3] 

1 

#  Eintrage  in  intin 

Contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intout 

intin[0] 

intout[0] 

style 

Return- Wert 

Parameter: 

style:  Gewilnschter  Fiilltyp 

FIS_HOLLOW  (0):  leer 
FIS_SOLID  (1);  voll  (einfarbig) 

FIS_PATTERN  (2):  Muster 
FIS_HATCH  (3):  Schraffur 
FIS_USER  (4):  frei  defmierbar 

vsf_interior():ausgewahlter  Fiilltyp 
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SET  FILL  STYLE  INDEX  (VDI 24) 

Mit  dieser  Funktion  wird  der  Musterindex  zum  Fiilltyp  ausgewahlt.  Diese  Funktion  hat  nur 
dann  einen  Sinn,  wenn  als  Fiilltyp  nicht  leer,  einfarbig  oder  frei  defmierbar  gewahlt  wurde. 
Nicht  verfiigbare  Indizes  werden  von  SET  FILL  STYLE  INDEX  durch  den  Musterindex  1 
ersetzt.  Fiilltyp  1,  gefolgt  von  einem  beliebigen  Musterindex,  entspricht  immer  dem  Fiilltyp 
2  mit  Musterindex  8 .  Der  Index  1  bei  Mustem  (Typ  2)  ist  immer  das  Muster  mit  der  geringsten 
Intensitat  auf  dem  Ausgabegerat.  Es  ist  immer  monochrom.  Hier  die  Auswahl  der  Fiillmuster 
mit  Fiilltyp  und  Musterindex: 


Abb.  3.9:  Mogliche  Kombinationen  von  Fiilltyp  und  Musterindex 

Deklaration  in  C: 

WORD  vsf_style  (WORD  handle,  WORD  style_index) 
{ 

intin [0]  =  style_index; 
contrl[0]  =  24; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  0; 

return  intout [0]; 


} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

24 

Opcode  fiir  VSFJSTYLE 

contrl+2 

contrl)  1] 

0 

#  Eintrage  in  ptsin 

contri+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrI+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0] 

stylejndex 

intout 

intout[0] 

Retum-Wert 

Parameter: 

stylcjndex:  gewiinschter  Musterindex  (bei  Mustem  Oder  Schraffuren) 
vsf_style():  ausgewahlter  Fulltyp  (bei  Mustem  Oder  Schraffuren) 
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SET  FILL  COLOR  INDEX  (VDI 25) 

Mit  dieser  Funktion  wird  die  Fiillfarbe  gewahlt.  Die  Farbindizes  0  und  1  sind  immer  verfiigbar, 
weitere  hangen  von  dem  Ausgabegerat  ab.  Ein  ungiiltiger  Farbindex  wird  durch  1  ersetzt. 

Dekiaration  in  C: 

WORD  vsf_color  (WORD  handle,  WORD  color_index) 

{ 

intin [0]  =  color_index; 
contrl[0]  =  25; 
contrlfl]  =  0; 
contrl [3]  =  1; 
contrl[6]  =  handle; 
vdi  (); 

return  intout [0]; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

25  Opcode  fUrVSF_COLOR 

contri+2 

contrl[l] 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1  #  Eintrage  in  intin 

contrl+8 

contrl  [4] 

1  #  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle  Geratekennung 

intin 

intin[0j  , 

color_index 

intout 

intout[0] 

Retum-Wert 

Parameter: 

color_index:  gewiinschte  Farbe 
vsf_color():  ausgewahlte  Farbe 
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Diese  Funktion  schaltet  die  automatische  Umrahmung  der  Fiillflache  ein  Oder  aus.  Der  Rand 
wird  bei  eingeschalteter  Umrahmung  (default)  in  der  gegenwartigen  Fiillfarbe  (also  im 
allgemeinen  nicht  in  Schwarz!)  als  durchgehende  Linie  gezeichnet. 

Deklaration  in  C: 

WORD  vsfjperimeter  (WORD  handle,  WORD  per_vis) 

{ 

intin [0]  =  per_vis; 
contrl[0]  =  104; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl [6]  =  handle; 
vdi  (); 

return  intout  [0] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

104  Opcode  fur  VSF.  PERIMETER 

contrl+2 

contrlf  1 J 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl  [2]  1 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

1  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

in  tin  [0] 

per_vis 

intout 

intout[0] 

Retum-Wert 

Parameter: 

per_vis:  Flag  fur  Umrahmung  (0:  keine  Umrahmung) 

vsf_perimeter():  eingestellter  Modus 

Bemerkungen 

Wird  von  “vrjecflQ”  nicht  beachtet. 
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SET  USER-DEFINED  FILL  PATTERN  (VDI 112) 

Mit  dieser  Funktion  kann  das  freidefinierbare  Fiillmuster  (“vsf_interior()”,  style  =  4)  festge- 
legt  werden.  L6  jeweils  1 6-Bit-Worte  bestimmen  das  Fiillmuster.  Das  hochste  Bit  (15)  des  er- 
sten  Wortes  entsprichtder  oberen  linken  Ecke  des  Fullmusters,  das  niedrigste  Bit  (0)  des  lctz- 
ten  Wortes  der  unteren  rechten  Ecke.  Fiir  jede  Farbebene  wird  ein  eigenes  Fiillmuster  angelegt. 
Bei  einer  einzelnen  Ebene  entspricht  ein  gesetztes  Bit  der  durch  die  Fiillfarbe  bestimmten 
Farbe,  der  Vordergrundfarbe,  ein  nicht  gesetztes  Bit  entspricht  der  Hintergrundfarbe.  Bei 
Mustem,  die  aus  mehreren  Farbebenen  bestehen,  wird  die  voile  Anzahl  der  Ebenen  zum  Filllen 
benutzt.  Nicht  aufgefiihrte  Ebenen  werden  durch  Nullebenen  ersetzt.  “Vielfarbige”  Muster 
konnen  nur  im  Schreibmodus  REPLACE  eingesetzt  werden. 

Deklaration  in  C: 

void  vsf_udpat  (WORD  handle,  WORD  *pfillj?at,  WORD  planes) 

{ 

iioff  =  pfill_pat; 
contrl [0]  =  112; 
contrl [1]  ~  0; 
contrl(3]  =  planes  *  16; 
contrl[6]  =  handle; 
vdi  () ; 

iioff  =  intin; 

1 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

112 

Opcode  fur  VSFJJDPAT 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

16*n 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

pfill_pat[0] 

intin+32*n-2 

intin[16*n-l] 

pfill_pat[16*n-l] 
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Parameter: 

planes:  Anzahl  der  Farbebenen 

pfill_pat[0]  bis 

pfill_pat[  15] :  Erste  Ebene  des  Fiillmusters  (Defaultwert  ist  das  Atari-  bzw.  das  DRI-Logo) 

pfill_pat[16]  bis 

pfill_pat[3 1  ] :  Zweite  Ebene  des  Fiillmusters 


pfill_pat[16*n-16]  bis 

pfill_pat[  1 6*n- 1  ] :  (n-te)  Ebene  des  Fiillmusters 

Bemerkungen 

Aufgrund  eines  Tippfehlers  in  der  urspriinglichen  Originaldokumentation  auch  haufig 
“vsf_updat()”  genannt. 
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Rasteroperationen 


f  COPY  RASTER,  OPAQUE  (VD1 109) 


Diese  Funktion  kopiert  (pixelweise)  ein  rechteckiges  Raster  unter  Beachtung  der  moglichen 
logischen  Verkniipfungen  auf  ein  anderes  rechteckiges  Raster.  Sollten  die  GroBen  beider 
Raster  nicht  iibereinstimmen,  so  wird  die  GroBe  des  Quellrasters  benutzt.  Die  Adresse  des 
Zielrasters  dient  in  diesem  Fall  lediglich  als  Zeiger.  1st  die  Adresse  der  Quelle  und  des  Ziels 
gleich  (und  insbesondere  ungleich  0  im  MFDB),  und  uberlappen  die  beiden  Bereiche,  so  wird 
das  Quellrechteck  nicht  verandert,  solange  nicht  das  Zielrechteck  fertig  kopiert  ist. 

Raster  im  Standardformat  konnen  und  durfe n  nicht  kopiert  werden,  da  man  im  allgemeinen 
keine  Informationen  uber  das  geratespezifische  Format  hat.  Also  bei  Bedarf  vorher  “TRANS¬ 
FORM  FORM”  benutzen! 


Deklaration  in  C: 

void  vro_cpyfm  (WORD  handle,  WORD  wr_mode,  WORD  *pxyarray, 
MFDB  *psrcMFDB,  MFDB  *pdesMFDB) 


intin  [0]  =  wr_mode; 

i_ptr  (psrcMFDB) ;  /*  contrl [7/8] =psrcMFDB  */ 

i_ptr2  (pdesMFDB) ;  /*  contrl [9/10] =pdesMFDP  */ 

pioff  =  pxyarray; 

contrl [0]  =  109; 

contrl [1]  =  4; 

contrl [3]  =  1; 

contrl [6]  =  handle; 

vdi  ()  ; 

pioff  =  ptsin; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

109 

Opcode  fiir  VRO_CPYFM 

contrl+2 

contrl[l] 

4 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 
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Adresse 

Feldelemente 

Belegung 

contrl+8 

contrl+12 

contrI+14 

contrl+18 

contrl[4] 

contrl[6] 

contrl[7/8] 

contrl[9/10] 

0  #  Eintrage  in  intout 

handle  Geratekennung 
psrcMDFB 
pdesMFDB 

intin 

intin[0] 

wr_mode 

ptsin 

ptsin[0..7] 

pxyarray[0..7] 

Parameter: 

psrcMFDB: 

pdesMFDB: 

wr_mode: 

pxyarray[0]: 

pxyarrayfl]: 

pxyarray[2]: 

pxyarray[3]: 

pxyarray[4]: 

pxyarray[5]: 

pxyarray[6]: 

pxyarray[7]: 


Zeiger  auf  MFDB  des  Quellrasters 
Zeiger  auf  MFDB  des  Zielrasters 

Eine  der  1 6  moglichen  logischen  Verkniipfiingen  (nicht  zu  verwechseln  mit  den 
Schreibmodi!) 

X-Koordinate  des  Eckpunktes  des  Quellrasters  in  NDC/RC-Koordinaten 
Y-Koordinate  des  Eckpunktes  des  Quellrasters  in  NDC/RC-Koordinaten 
X-Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Quellrasters  in  NDC/ 
RC-Koordinaten 

Y -Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Quellrasters  in  NDC/ 
RC-Koordinaten 

X-Koordinate  des  Eckpunktes  des  Zielrasters  in  NDC/RC-Koordinaten 
Y-Koordinate  des  Eckpunktes  des  Zielrasters  in  NDC/RC-Koordinaten 
X-Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Zielrasters  in  NDC/ 
RC-Koordinaten 

Y-Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Zielrasters  in  NDC/ 
RC-Koordinaten 


Bemerkungen: 

Ein  MFDB  hat  folgende  Struktur: 

typedef  struct 
{ 

void  *fd__addr;  /*  Zeiger  auf  Speicherblock .  Bei  ttbergabe 

eines  Nullzeigers  werden  automatisch 
die  Parameter  fur  das  physikalische  Ge- 
rat  (z.B.  Bildschirmspeicher  im  gerate- 
spezifischen  Format)  gesetzt,  */ 

WORD  fd_w;  /*  Speicherblockbreite  in  Punkten  */ 
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WORD  fd_h; 

WORD  fd_wdwidth; 
WORD  fd_stand; 

WORD  fd_nplanes; 
WORD  fd_rl,fd_r2, 
}  MFDB; 


/*  Ho’ne  des  Speicherblocks  in  Punkten  */ 
/*  Breite  des  Speicherblocks  in  Words  */ 
/*  0:  gerateabhangiges  Format, 

1:  Standardformat  */ 

/*  Anzahl  der  Bildebenen  */ 
fd  r3;  /*  reserviert  */ 


Um  es  noch  einmal  ausdrucklich  hervorzuheben:  Um  den  Bildschirm  anzusprechen,  muB  ein 
Nullzeiger  bei  der  Speicherblockadresse  (und  nicht  einer  irgendwie  ermittelten  Adresse)  ein- 
getragen  werden.  Die  Parameter  fur  den  Bildschirm  werden  (intern)  automatisch  eingetragen, 
was  jedoch  nicht  bedeutet,  daB  man  nach  einem  Auffuf  einer  Rasterkopierfunktion  die  kor- 
rekten  Werte  in  der  MFDB-Struktur  zuriickerhalt.  Bei  dem  Nullzeiger  ist  darauf  zu  achten, 
daB  es  sich  wirklich  um  einen  Nullzeiger  und  nicht  etwa  um  NIL  (=— 1),  wie  bei  einigen  Modu- 
la-2-Bibliothekcn,  handelt. 

Die  logischen  Verknlipfungen  (Q  =  Pixelwert  des  Quellpixels,  Z  =  Pixelwert  des  Zielpixels, 
E  =  Pixelwert  des  Zielpixels  nach  Verknupfung): 


Bezeichnung 


ALL_WHITE  (0) 
S_AND_D  (1) 
S_AND_NOTD  (2) 
S_ONLY  (3) 
NOTS_AND_D  (4) 
D„ONLY  (5) 
S_XOR_D  (6) 
S_OR_D  (7) 
NOT_SORD  (8) 
NOT_SXORD  (9) 
D_INVERT  (10) 
NOTJD(ll) 
S_OR_NOTD  (12) 
NOTS_OR_D  (13) 
NOT_SANDD  (14) 
ALL_BLACK  (15) 


Wirkung 


E=0 

E=Q  and  Z 
E=Q  and  (not  Z) 
E-Q 

E=(not  Q)  and  Z 
E=Z 

E=Q  xor  Z 
E-Q  or  Z 
E=mot  (Q  or  Z) 
E=not  (Q  xor  Z) 
E=notZ 
E=Q  or  (not  Z) 
E=not  Q 
E=(not  Q)  or  Z) 
E=not  (Q  and  Z) 
E=1 
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COPY  RASTER,  TRANSPARENT  (VDI 121) 


Diese  Funk  ti  on  kopiert  (pixelweise)  ein  monochromes,  rechteckiges  Raster  unter  Beachtung 
der  Schreibmodi  auf  ein  anderes  (auch  farbiges)  rechteckiges  Raster.  Sollten  die  Grofien 
beider  Raster  nicht  iibereinstimmen,  so  werden  die  GroBe  des  Quellrasters  und  die  obere  linke 
Ecke  des  Zielrasters  als  Startpunkt  benutzt.  Als  Quellraster  darf  niemals  der  Bildschinn 
angegeben  werden. 

Die  Schreibmodi: 

Modus  1:  REPLACE 

Ersetzt  alle  Pixel  des  Zielrechtecks,  wobei  der  Vordergrundfarbindex  alien  Pixeln  zugeordnet 
wird,  in  deren  zugehorigcm  Quellraster  eine  1  steht,  und  der  Hintergrundfarbindex  alien  Pi¬ 
xeln  zugeordnet  wird,  in  deren  Quellraster  eine  0  steht. 

Modus  2;  TRANSPARENT 

Hier  werden  alle  Pixel  des  Zielrechtecks  auf  die  Vordergrundfarbe  gesetzt,  bei  denen  im 
zugehorigen  Quellraster  eine  1  steht.  Der  Farbindex  fur  die  Hintergrundfarbe  wird  nicht 
benutzt. 

Modus  3:  XOR 

Jede  Farbebene  wird  logisch  mit  dem  monochromen  Quellraster  X-oderiert,  d.  h.  jedes  Bit  des 
Pixelwerts  wird  ebenenweise  mit  dem  Wert  des  Quellrasters  XORed.  Damit  ist  insbesondere 
die  Farbe,  die  sich  aus  dieser  logischen  Operation  ergibt,  nicht  eindeutig  defmiert.  Lediglich 
daB  aus  Weill  (alle  Bits  auf  0  gesetzt)  Schwarz  (alle  Bits  auf  1  gesetzt)  wird  (und  umgekehrt), 
ist  gewiS.  Farbindizes  werden  nicht  beriicksichtigt. 

Modus  4:  REVERSE  TRANSPARENT 

Hier  werden  alle  Pixel  des  Zielrechtecks  auf  die  Hintergrundfarbe  gesetzt,  bei  denen  im 
zugehorigen  Quellraster  eine  0  steht.  Der  Farbindex  fur  die  Vordergrundfarbe  wird  nicht 
benutzt. 


Deklaration  in  C: 

void  vrt_cpyfm  (WORD  handle,  WORD  wr_mode,  WORD  *pxyarray, 

MFDB  *psrcMFDB,  MFDB  *pdesMFDB,  WORD  *color__index) 

{ 

intin [0]  =  wrjnode; 
intin [1]  =  *color_index++; 
intin [2]  =  *color  index; 
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i__ptr  (psrcMFDB);  /*  contrl [7/8] =psrcMFDB  */ 

i_ptr2  (pdesMFDB);  /*  contrl [9/10]=pdesMFDB  */ 

pioff  =  pxy array; 

contrl [0]  =  121; 

contrl [1]  =  4; 

contrl [3]  =  3; 

contrl [6]  =  handle; 

vdi  ( ) ; 

pioff  =  ptsin; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

121  Opcode  fur  VRTCPYFM 

contrl+2 

contrl[l] 

4  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

3  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

0  #  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle  Geratekennung 

contrl+14 

contrl[7/8] 

psrcMFDB 

contrl+18 

contrl[9/10] 

pdesMFDB 

intin 

intin[0] 

wrjnode 

intin+2 

intin[1..2] 

color_index[0..1] 

ptsin 

ptsin[0..7] 

pxyarray[0..7] 

Parameter: 

psrcMFDB: 

pdesMFDB: 

wr_mode: 

colorjndex[0]: 

colorjndex[l]: 

pxy  array  [0]: 

pxyarray[l]: 

pxyarray[2]: 


Zeiger  auf  MFDB  des  Quellrasters 
Zeiger  auf  MFDB  des  Zielrasters 
Schreibmodus  (siehe  oben) 

Farbindex  der  als  gesetzt  zu  betrachtenden  Punkte  (Vordergrund) 
Farbindex  der  als  nichtgesetzt  zu  betrachtenden  Punkte  (Hintergrund) 
X-Koordinate  des  Eckpunktes  des  Quellrasters  in  NDC/RC-Koordinaten 
Y -Koordinate  des  Eckpunktes  des  Quellrasters  in  NDC/RC-Koordinaten 
X-Koordinate  der  diagonal  gegentiberliegenden  Ecke  des  Quellrasters 
in  NDC/RC-Koordinaten 
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pxyarray[3]: 

pxyarray[4]: 

pxyarray[5]: 

pxyaiTay[6]: 

pxyarray[7]: 


Y -Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Quellrasters  in  NDC/ 
RC-Koordinaten 

X-Koordinate  des  Eckpunktes  des  Zielrasters  in  NDC/RC-Koordinaten 
Y-Koordinate  des  Eckpunktes  des  Zielrasters  in  NDC/RC-Koordinaten 
X-Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Zielrasters  in  NDC/ 
RC-Koordinaten 

Y-Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Zielrasters  in  NDC/ 
RC-Koordinaten 
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TRANSFORM  FORM  (VDI 110) 


Diese  Funktion  transformiert  ein  Raster  vom  Standardformat  in  das  geratespezifische  Format 
oder  umgekehrt.  Beim  Standardformathandeltes  sich  um  ein  rechnerunabhiingiges  Datenformat, 
das  mithin  beim  Austausch  von  Dateien  zwischen  verschiedenen  GEM-Systemen  benutzt 
werden  kann  (siehe  COPY  RASTER,  OPAQUE). 


Die  Anzahl  der  Farbebenen  im  der  Quell-MFDB-Struktur  bestimmt  die  Anzahl  der  zu 
transformierenden  Planes.  Das  Format-Flag  wird  fiir  die  Ziel-MFDB-Struktur  entsprechend 
verandert.  Fiir  die  korrekte  Angabe  der  restlicben  Werte  in  der  Ziel-MFDB-Struktur  ist  man 
selbst  verantwortlich.  Je  nach  gerateabhangigem  Format  kann  der  UmwandlungsprozeB  ein- 
fach  oder  sehr  aufwendig  sein.  Man  erleichtert  dem  VDI  die  Arbeit,  wenn  in  Quell-  und  Ziel- 
MFDB  unterschiedliche  Rasteradressen  angegeben  sind  -  ansonsten  kann  eine  Transforma¬ 
tion  schon  mal  mehrere  Minuten  dauem  (die  Umwandlung  “in  place”  ohne  Zuhilfenahme  von 
temporarem  Speicher  ist  eben  eine  schwierige  Arbeit!). 


Deklaration  in  C; 

void  vr_trnfra  (WORD  handle,  MPDB  *psrcMFDB,  MFDB  *pdesMFDB) 
{ 

i_ptr  (psrcMFDB) ; 
i_ptr2  (pdesMFDB) ; 
contrl[0]  =  110; 
contrl[l]  =  contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  ( ) ; 

1 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

no 

Opcode  fiir  VR_TRNFM 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

contrl+14 

contrl[7/8] 

psrcMFDB 

contrl+18  | 

contrl[9/10] 

pdesMFDB 

422 


ATARI  Profibuch 


Parameter: 

psrcMFDB:  Zeiger  auf  MFDB  des  Quellrasters 
pdesMFDB:  Zeiger  auf  MFDB  des  Zielrasters 


VDI-Betriebssystemroutinen 


423 


GET  PIXEL  (VDI 105) 


Diese  Funktion  ermittelt  den  Pixelwert  und  den  Farbindex  eines  Pixels, 


DerFarbindex  ist  die  Farbnummer,  wieman  sie  gegeniiber  dem  VDI  bei  den  Attributfunktionen 
angeben  kann  (zum  Beispiel  bei  “vst_color()”).  Der  Pixelwert  hingegen  spiegelt  den  tatsach- 
lichen  Inhalt  des  Bildspeichers  wider. 


Deklaration  in  C: 

void  v_get_pixel  (WORD  handle,  WORD  x,  WORD  y,  WORD  *pel, 
WORD  * index) 

{ 

ptsin [0]  =  x; 
ptsin[l]  =  y; 
contrl [0]  =  105; 
contrl [1]  =  1; 
contrl [3]  =  0; 
contrl [6]  =  handle; 
vdi  (); 

*pel  =  intout [0]; 

* index  =  intout [1J; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

105  Opcode  fur  V_GETJP1XEL 

contrl+2 

control] 

1  #  Eintrage  in  ptsin 

contrl+4 

contrl[2i| 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

2  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsin[l] 

y 

in  tout 

intout[0] 

pel 

intout+2 

intout[I] 

index 
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Parameter: 

x,y:  Koordinaten  des  Pixels 

pel:  Pixel  wert 

index:  Farbindex  des  Pixels 
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Eingabefunktionen 

I  SET  INPUT  MODE  (VDI  33) 

, 

Diese  Funktion  setzt  den  Input-Modus  auf  REQUEST  oder  SAMPLE.  Im  REQUEST-Modus 
wartet  das  Eingabegerat  auf  eine  Eingabe,  im  SAMPLE-Modus  wird  lediglich  der  Zustand 
oder  die  Position  der  Eingabeeinheit  zuriickgegeben. 

DieEingabefunktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 


Deklaration  in  C: 


WORD  vsinjnode  (WORD  handle,  WORD  dev_type,  WORD  mode) 
i 

intin [0]  =  dev_type; 
intin[l]  =  mode; 
contrl[0]  =  33; 
contrl[X]  =  0; 
contrl[3]  =  2; 
contrl[6]  “handle; 
vdi  (); 

return  intout [0];  /*  Vorsicht!  Nicht  alle  Bindings  liefern 

einen  Return -Wert  */ 


} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

33 

Opcode  fur  VSIN.MODE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

dev_type 

intin+2 

intin[l] 

mode 

intout 

intout[0] 

|  Retum-Wert 
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Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

dev_type:  logische  Eingabeeinheit 

DEV_LOCATOR  (1):  Positionseingabeeinheiten  (Maus,  Trackball,  Joy¬ 

stick) 

DEVJVALUATOR  (2):  Wertverandemde  Eingabeeinheiten  (Potentiome¬ 

ter,  Cursor,  im  ROM-T reiber  nicht  implementiert) 
DEV_CHOICE  (3):  auswahlende  Eingabeeinheiten  (Funktionstasten) 

DEV_STRTNTG  (4):  Zeichenketteneingabeeinheiten  (Tastatur) 

mode:  Eingabemodus  MODE_  REQUEST  ( 1 ),  MODE_S AMPLE  (2) 

vsin_mode():  ausgewahlter  Eingabemodus 

Bemerkungen 

Man  beachte,  da8  es  fur  “INPUT  LOCATOR”,  “INPUT  VALUATOR”,  “INPUT  CHOICE” 
und  “INPUT  STRING”  fur  die  beiden  verschiedenen  Eingabemodi  zwar  unterschiedliche 
Bindings  und  Funktionsnamen  gibt,  die  Opcodes  jedoch  jeweils  identisch  sind! 
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INPUT  LOCATOR,  REQUEST  MODE  (VDI 28) 

Mitdieser  Funktion  vvird  die  Position  des  Grafikcursors  gesetzt  bzw.  ermittelt.  Das  Ergebnis 
erhaltderBenutzer  allerdings  erst,  wenn  eine  Taste  gedruckt  wird.  Der  Grafikcursor  wird  auf 
jeden  Fall  an  der  angegebenen  Position  in  der  aktuellen  Form  auf  dem  Bildschirm  sichtbar. 
Zu  beachten  ist  unbedingt,  daB  jede  beliebige  Taste  (auch  Maustaste)  gedriickt  werden  darf. 

Ublich  ist  eine  Bewegung  des  Grafikcursors  in  grofien  Schritten,  wenn  die  Cursortasten 
gedruckt  werden,  bzw.  in  kleinen  Schritten,  wenn  die  Cursortasten  in  Verbindung  mit  <Shift> 
gedruckt  werden.  Auf  dem  Atari  benotigt  man  jedoch  zusatzlich  die  Alternate-Taste.  Diese 
Funktion  wird  nicht  von  alien  Geratetreibem  unterstutzt. 

Die  Eingabefunktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 

Deklaration  in  C: 

void  vrq_locator  (WORD  handle,  WORD  x,  WORD  y, 

WORD  *xout,  WORD  *yout,  WORD  *term) 

{ 

ptsin[0]  =  x; 
ptsinfl]  =  y; 
contrl[0]  =  28; 
contrl[l]  =  1; 
contrl[3]  =  0; 
contrl[6]  -handle; 
vdi  ( ) ; 

*xout  =  ptsout[0]; 

*yout  =  ptsout[l]; 

*term  =  intout [0]; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

28 

Opcode  fur  VRQ_LOCATOR 

contrl+2 

contrljl] 

1 

#  Eintriige  in  ptsin 

contrl+4 

contrl  [2] 

1 

#  Eintriige  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 
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Adresse 

Feldelement 

Belegung 

contrl+8 

contrl[4] 

1  #  Eintrage  in  intout 

contrl+12 

contrl(6] 

handle  Geratekennung 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsin [11 

y 

intout 

intout[0] 

term 

ptsout 

ptsout[0] 

xout 

ptsout+2 

ptsout[l] 

yout 

Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

x:  X-Koordinate  des  Grafikcursors  in  NDC/RC-Koordinaten 

y:  Y-Koordinate  des  Grafikcursors  in  NDC/RC-Koordinaten 

term :  Im  Low-Byte  wird  der  Code  der  (Positions-)  Abbruch-T aste  eingetragen.  Fiir  die 

iiblichen  Tastaturtasten  ist  dies  der  ASCII-Code,  Spezielle  Tasten  am  Eingabegerat 
(also  die  Maustasten)  erhalten  Werte  ab  32  aufwarts  und  konnen  so  nicht  ohne 
weiteres  von  Tasten  auf  der  Tastatur  unterschieden  werden. 
xout:  X-Koordinate  des  Grafikcursors  bei  Ruckgabe  in  NDC/RC-Koordinaten 

yout:  Y-Koordinate  des  Grafikcursors  bei  Ruckgabe  in  NDC/RC-Koordinaten 
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INPUT  LOCATOR,  SAMPLE  MODE  (VDI 28) 

MitdieserFunktionwirddiePositiondesGrafikcursorsgesetztbzw.ermittelt.DerGrafikcursor 
wird  nicht  sichtbar.  Um  ihn  sichtbar  zu  machen,  mufi  SHOW  CURSOR  aufgerufen  werden. 
Tastenbetatigungen  oder  Grafikcursorbewegungen  werden  nur  dann  gemeldet,  wenn  diese 
tatsachlich  erfolgt  sind. 

Diese  Funktion  wird  nicht  von  alien  Geratetreibem  unterstiitzt. 

Die  Eingabefunktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 

Deklaration  in  C: 

WORD  vsm_locator  (WORD  handle,  WORD  x,  WORD  y, 

WORD  *xout,  WORD  *yout,  WORD  *term) 

{ 

ptsin[0]  =  x; 
ptsin[l]  =  y; 
contrl[0]  =  28; 
contri [1]  =  1; 
contrl[3]  =  0; 
contri [6]  =  handle; 
vdi  ( ) ; 

*xout  =  ptsout[0]; 

*yout  =  ptsout [ 1 ] ; 

*term  =  intout [0]; 

return  (contrl  [4]  «1)  |contrl[2]; 

} 


GEM-Arrays: 


Adresse 

Feidelement 

Belegung 

contri 

contrl[0] 

28 

Opcode  fur  VSMJLOCATOR 

contrl+2 

contri  [1] 

1 

#  Eintrage  in  ptsin 

contrl+4 

contri  [2] 

0  oder  1 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contri  [4] 

0  oder  1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 
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Adresse 

Feldelement 

Belegung 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsin[l] 

y 

intout 

intout[0] 

term 

ptsout 

ptsoutfO] 

xout 

ptsout+2 

ptsoutfl] 

yout 

Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

status:  Bit  0:  Koordinaten  verandert? 

Bit  1:  Taste  gedriickt? 

x:  X-Koordinate  des  Grafikcursors  in  NDC/RC-Koordinaten 

y:  Y-Koordinate  des  Grafikcursors  in  NDC/RC-Koordinaten 

term:  Im  Low-Byte  wird  der  Code  der  (Positions-)  Abbruch-Taste  eingegeben. 

Spezielle  Tasten  am  Eingabegerat  (also  die  Maustasten)  erhalten  Werte  ab  32  auf- 
warts  und  konnen  so  nicht  ohne  weiteres  von  Tasten  auf  der  Tastatur  unterschie- 
den  werden. 

xout:  X-Koordinate  des  Grafikcursors  in  NDC/RC-Koordinaten  bei  Riickgabe 

yout:  Y -Koordinate  des  Grafikcursors  in  NDC/RC-Koordinaten  bei  Riickgabe 
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INPUT  VALUATOR,  REQUEST  MODE  (VDI  29) 


Mit  dieser  Funktion  wird  eine  Wertveranderung  ermittelt.  Es  werden  immer  Werte  zwischen 
1  und  100  (nach  Tastendruck)  zurilckgegeben,  Typische  Tasten  fiir  Wertveranderung  sind  die 
zwei  Cursorbewegungstasten  (<t>  und  <i>).  Fiir  die  Cursorbewegungstasten  erhalt  man  fol- 
gende  Wertveranderungen  (jeweils  zum  aktuellen  Wert): 


Cursorbewegung 

Wert 

<T> 

+  10 

<i> 

-10 

<t>  und  <Shift> 

+  1 

<i>  und  <Shift> 

-  1 

Diese  Funktion  wird  nicht  von  alien  Geratetreibem  (auch  nicht  dem  im  ROM)  unterstiitzt.  Die 
Eingabefunktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 


Deklaration  in  C: 

void  vrqjvaluator  (WORD  handle,  WORD  valuator_in, 

WORD  *valuator_out,  WORD  *terminator) 

{ 

intin  [0]  =  valuator__in; 
contrl[0]  =  29; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  () ; 

*valuator_out  =  intout [0]; 

*terminator  =  intout [1]; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

29 

Opcode  fiir  VRQJVALUATOR 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 
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Adresse 

Feldelemente 

Belegung 

contrl+8 

contrl[4] 

2  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

valuator_in 

intout 

intout[0] 

valuator_out 

intout+2 

intout[l] 

terminator 

Parameter: 


handle: 

valuator_in: 

valuator_out: 

terminator: 


Nummer  der  physikalischen  Workstation 
initialisierender  Wert 
Ausgabewert 
betatigte  Taste 
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INPUT  VALUATOR,  SAMPLE  MODE  (VDI 29) 


MitdieserFunktion  wird  eine  Wertveranderung  (ahnlichder  Funktionim  REQUEST-Modus) 
ermittelt.  Es  werden  Werte  zwischen  l  und  100  zuriickgegeben,  falls  ein  entsprechendes 
Ereignis  aufgetreten  ist.  Sonst  wird  kein  Wert  zuriickgegeben. 

Diese  Funktion  wird  nicht  von  alien  Geratetreibem  (auch  nicht  dem  im  ROM)  unterstiitzt.  Die 
Eingabefunktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 


Deklaration  in  C: 

void  vsm_valuator  (WORD  handle,  WORD  val_in,  WORD  *val_out, 
WORD  *term,  WORD  *status) ; 

{ 

intin [0]  =  val_in; 
contrl[0]  =  29; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  (); 

*val_out  =  intout [0]; 

*term  =  intout [1] ; 

^status  =  contrl[4]; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

29 

Opcode  fur  VSM_VALUATOR 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

status 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0] 

val_in 

intout 

intout[0] 

val_out 

intout+2 

intout[l] 

term 
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Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

status:  Auswertung 

0:  keine  Anderung 
1:  Wert  verandert 
2:  Taste  betatigt 
val_in:  initialisierender  Wert 

val_out:  Ausgabewert 

term:  ggf.  betatigte  Taste 
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INPUT  CHOICE,  REQUEST  MODE  (VDI 30) 


Mit  dieser  Funktion  wird  die  Betatigung  einer  AuswaMtaste  (abgewartet  und)  emiittelt.  Als 
Auswahltasten  dienen  zum  Beispiel  die  Funktionstasten. 

Die  Anzahl  der  Funktionstasten  ist  gerateabhangig.  Sollte  eine  andere  Taste  gedriickt  werden, 
so  wird  die  Codenummer  dieser  Taste  zuriickgegeben. 

Diese  Funktion  ist  zwar  im  ROM  implementiert,  scheint  aber  in  keiner  Weise  zu  funktionieren. 
Da  sie  nicht  unbedingt  notig  ist,  wird  sie  von  einigen  Geratetreibem  nicht  unterstutzt. 

Die  Eingabefiinktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 


Deklaration  in  C: 


void  vrc[_choice  (WORD  handle, 
{ 


} 


intin [0] 
contrl [0] 
contrl [1] 
contrl [3] 
contrl [6] 
vdi  (); 
*ch  out  = 


=  ch_in; 

=  30; 

=  0; 

=  l; 

=  handle; 

!  intout [0]; 


WORD  ch  in. 


WORD  *ch  out) 


GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

30 

Opcode  fur  VRQ_CHOICE 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  intin 

contrI+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intinfO] 

ch_in 

intout 

intout[0] 

ch_out 
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Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

ch_in:  initialisierende  Auswahltaste  (ausgewahlt  wird  aus  dem  Zahlenbereich  von  1  bis 

a,  wobei  die  Auswahltastenanzahl  a  gerateabhangig  ist,  Beispiel:  a  =  10,  zehn 
(Funktions-  oder)  Auswahltasten) 
ausgewahlte  Taste  (oder  Codenummer) 


ch_out: 
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INPUT  CHOICE,  SAMPLE  MODE  (VDI30) 


Mit  dieser  Funktion  wird  die  Nummer  der  zuletzt  betatigten  Auswahltaste  ermittelt.  Als  Aus- 
wahltasten  dienen  zum  Beispiel  die  Funktionstasten. 

Die  Anzahl  der  Funktionstasten  ist  gerateabhangig.  Sollte  eine  andere  Taste  gedriickt  worden 
sein,  so  wird  die  Codenummer  dieser  Taste  zuriickgegeben. 

Diese  Funktion  ist  zwar  im  ROM  implementiert,  scheint  jedoch  nicht  richtig  zu  funktionieren. 
Femer  ist  die  Funktion  nicht  unbedingt  notig  und  wird  daher  von  einigen  Geratetreibem  nicht 
unterstiitzt. 

Die  Eingabefunktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Noimalfall  von  den  AES  benutzt  wird. 

Deklaration  in  C: 

WORD  vsm_choice  (WORD  handle,  WORD  ^choice) 

{ 

contrl [0]  =  30; 
contrl[l]  =  contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  (); 

*choice  =  intout [0 ]; 
return  cont  r  1  [  4  ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

30 

Opcode  fur  VSM_CHOICE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

status 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intout 

intoutfO] 

choice 
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Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

status:  Auswahlstatus 

0:  keine  Taste  betatigt 
I:  Taste  betatigt 

choice:  betatigte  Auswahltaste  (oder  Code-Nummer)  Oder  0,  falls  keine  Taste  gedriickt 

wurde. 
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INPUT  STRING,  REQUEST  MODE  (VDI 31) 


Diese  Funktion  gibt  einen  String  (abgeschlossen  mit  RETURN  oder  bei  Erreichen  des  String- 
Endes)  von  der  Tastatur  zuriick.  Ein  Echo  auf  dem  Bildschirm  kann  erfolgen.  Im  Fall  der  Echo- 
ausgabe  werden  die  Textattribute  beriicksichtigt.  Die  Echoausgabe  ist  nicht  auf  alien  Geraten 
verfiigbar. 

Die  Eingabefunktionen  des  VDIfunktionieren  nur  auf  der  physikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 

Deklaration  in  C: 

void  vrq_string  (WORD  handle,  WORD  max_length,  WORD  echo_mode, 

WORD  *echo__xy,  char  *  string) ; 

! 

WORD  tmp; 

intin [0]  =  max_length; 
intin [1]  =  echo_mode; 
pioff  =  echo_xy; 
contrl[0]  =  31; 
contrl [1]  =  1; 
contrl[3]  =  2; 
contrl[6]  =  handle; 
vdi  (); 

for  (tmp  =  0;  tmp<contrl [4] ;  tmp++) 

*string++  =  intout [tmp] ; 

* string  =  0; 
pioff  =  ptsin; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

31 

Opcode  fur  VRQ.STRJNG 

contrl+2 

contrI[l] 

1 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

n 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 
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Adresse 

Feldelemente 

Belegung 

intin 

intin  [0] 

maxjength 

intin+2 

intin[l] 

echo_mode 

ptsin 

ptsin[0..1] 

echo_xy(0..1] 

intout 

intout[0..n-l] 

string[0..n-l] 

Parameter: 


handle: 

max_length: 


echo_mode: 

echo_xy[0]: 

echo_xy[l]: 

string: 


Nummer  der  physikalischen  Workstation 

maximale  Lange  des  Strings.  Im  Fall  einer  negativen  Zahl  wird  der  Absolut- 
Betrag  der  Zahl  als  Lange  genommen  (hier  nicht  mit  ASCD-Zeichen,  sondem 
mit  den  Codennmmem  der  VDI-Standard-Tastatur,  siehe  Anhang). 
Echo-Modus  (0:  aus,  1 :  Echo  ein  (also  gleichzeitige  Textausgabe  auf  dem 
Monitor)) 

X-Koordinate  fur  Startpunkt  Echoausgabe  in  NDC/RC-Koordinaten 
Y-Koordinate  fiir  Startpunkt  Echoausgabe  in  NDC/RC-Koordinaten 
Zeiger  auf  Eingabepuffer  (fiir  ein  C-Binding  Null-terminiert,  die  Lange  bein- 
haltet  die  0.) 
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INPUT  STRING,  SAMPLE  MODE  (VDI 31) 

Diese  Funktion  gibt  einen  String  von  der  Tastatur  zuriick.  Die  Eingabe  wird  abgebrochen 
durch 

-  RETURN 

-  Erreichen  der  maximalen  Eingabelange 

-  nicht  verfiigbare  Datenwerte. 

Soil  dieStringeingabe  grundsatzlich  mitRETURNabgeschlossen  werden,  so  istderREQUEST- 
Modus  zu  wahlen. 

Ein  Echo  auf  dem  Bildschirm  kann  erfolgen,  falls  fur  das  Gerat  verfiigbar.  Im  Fall  der  Echoaus- 
gabe  werden  die  Textattribute  beriicksichtigt. 

Die  Eingabefunktionen  des  VDI  funktionieren  nur  auf  der  phy  sikalischen  Workstation,  die  im 
Normalfall  von  den  AES  benutzt  wird. 


Deklaration  in  C: 


WORD  vsm_string  (WORD  handle,  WORD  max_length,  WORD  echo_mode, 
WORD  *echo_xy,  char  *string) 

{ 

WORD  tmp; 


intin [0]  =  max_length; 
intin [1J  =  echqjnode; 
pioff  =  echo_xy; 
contrl[0]  =  31; 
contrlfl]  -  1; 
contrl[3]  =2; 
contrl[6]  =  handle; 
vdi  () ; 

for (tmp  =  0;  tmpccontrl [ 4 ] ;  tmp++) 
*string++  =  intout [trap] ; 

* st ring  =  0; 
pioff  =  ptsin; 
return  contrl[4]; 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

3 1  Opcode  fur  VSM_STRING 

contrl+2 

contrl[l] 

1  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

status  #  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle  Geratekennung 

intin 

intin[0] 

max_length 

intin+2 

intin[l  ] 

echo_mode 

ptsin 

ptsin[0..1] 

echo_xy[0..1] 

intout 

intout[0..n-l] 

string[0..n-l] 

Parameter: 


handle: 

status: 

max_length: 


echo_mode: 

echo_xy[0]: 

echo_xy[l]: 

string: 


Nummer  der  physikalischen  Workstation 

Eingabe  durch  ungiiltige  Zeieheneingabe  abgebrochen  (0)  oder  Lange  des 
Strings  (>0) 

maximale  Lange  des  Strings.  Im  Falle  einer  negativen  Zahl  wird  der  Absolut- 
Betrag  der  Zahl  als  Lange  genommen  (hier  nicht  mit  ASCII-Zeichen,  sondem 
mit  den  Code-Nummem  der  VDI-Standard-Tastatur  (siehe  Anhang)). 
Echo-Modus  (0:  aus,  1 :  Echo  ein  (gleichzeitige  Ausgabe  auf  Bildschirm)) 
X-Koordinate  fiir  Startpunkt  Echoausgabe  in  NDC/R C-Ko ordinaten 
Y-Koordinate  fur  Startpunkt  Echoausgabe  in  NDC/RC-Koordinaten 
Zeiger  auf  eingelesene  Zeichenkette  (auf  ausreichende  Lange  achten),  bei 
einem  C-Binding  nullterminiert.  Die  0  zahlt  dann  mit  zur  Lange. 
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SET  MOUSE  FORM  (VDI  111) 


Mit  dieser  Funktion  kann  die  Form  des  Grafik-Cursors  (Mauszeigers)  frei  definiert  werden. 
Die  Hintergrund-  und  Vordergrundmaske  werden  getrennt  definiert. 

Jede  Maske  wird  als  Feld  mit  16  Wortem  zu  je  16  Bit  festgelegt.  Hierbei  ist  Bit  15  des  ersten 
Wortes  die  obere  linke  Ecke  der  Maske  und  Bit  0  des  16.  Wortes  die  rechte  untere  Ecke. 

Fur  beide  Masken  wird  ebenso  die  Farbe  getrennt  angegeben.  AIs  Hintergrundfarbe  wird  in 
der  Regel  0  (weifi),  als  Vordergrundfarbe  1  (schwarz)  gewahlt. 

Zusatzlich  wird  der  Hot-Spot,  die  exakte  Grafik-Cursor-Position,  definiert.  Bei  dem  Mauspfeil 
wiirde  dies  der  Zeigerspitze,  bei  dem  Kreuz  der  Mitte  entsprechen.  Die  Koordinaten  werden 
relativ  zur  oberen  linken  Ecke  der  Maske  angegeben. 

Die  Ausgabe  der  Maus  erfolgt  folgendermaBen: 

-  Die  Bilddaten  unter  dem  Mauszeiger  werden  gerettet  und  bei  einer  Mausbewegung 
wiederhergestellt. 

-  Gesetzte  Flachen  der  Hintergrundmaske  werden  in  der  Maskenfarbe  ausgegeben. 

-  Gesetzte  Flachen  der  Vordergrundfarbe  werden  in  der  Datenfarbe  ausgegeben. 

Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die 
im  Normalfall  von  den  AES  benutzt  wird.  Statt  dessen  sollte  man  “graf_mouse()”  einsetzen! 


Deklaration  in  C: 

void  vscjEorm  (WORD  handle,  WORD  *pcur_forzn) 
{ 

iioff  =  pcur_form; 
contrl[0]  =  111; 
contrl[l]  =  0; 
contrl[3]  =  37; 
contrl[6]  =  handle; 
vdi  ( ) ; 

iioff  =  intin; 


} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

111 

Opcode  fiir  VSC_FORM 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

eontrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

37 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0..36] 

pcur_form[0..36] 

Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

pcur_form[0]:  (relative)  X-Koordinate  des  Hot-Spot 

pcur_form[  1  ] :  (relative)  Y -Koordinate  des  Hot-Spot 

pcur_form[2]:  1  (fiir  zukiinftige  Anwendung) 
pcur_form[3]:  Farbindex  der  Hintergrundmaske  (iiblich:  0)  (Maske) 
pcur_form[4]:  Farbindex  der  Vordergrundmaske  (iiblich:  1)  (Daten) 
pcur_form[5]  bis 

pcur_form[20] :  Hintergrundmasken-Definition 
pcur_form[21j  bis 

pcur_form[36] :  Vordergrundmasken-Definition 
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Mochte  man  erne  eigene  Anwendung  mit  einem  Timerintemipt  aufrufen,  so  kann  er  mit  dieser 
Funktion  auf  diese  Anwendung  gelegt  werden.  Es  ist  die  Aufgabe  der  Anwendung,  die  alte 
Interrupt-Adresse  zu  speichem  und  am  Ende  das  Register  wiederherzustellen.  Die  Eingabe- 
Funktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation ,  die  im  Notmalfall 
von  den  AES  benutzt  wird. 


Deklaration  in  C: 


void  vex_timv 
{ 


(WORD  handle,  LONG  tim_addr,  LONG  *otim_addr, 
WORD  *tim  conv) 


i_ptr  (tim_addr) ;  /*  contrl [7/8 ]=tim_addr  */ 

contrl[0]  =  118; 

contrl [1]  =  contrl[3]  =  0; 

contrl[6]  =  handle; 

vdi  { ) ; 

m_lptr2  (otim_addr) ;  /*  *otim_addr=contrl [9/10]  */ 
*tim_conv  =  intout [0] ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

118 

Opcode  fur  VEX_TIMV 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contr![3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

contrl+14 

contrl[7/8] 

tim_addr 

contrl+18 

contrl  [9/10] 

otim_addr 

intout 

intout[0] 

tim_conv 

Parameter: 


handle: 

tim_addr: 

otim_addr: 

tim_conv: 


Nummer  der  physikalischen  Workstation 
Adresse  der  neuen  Timerinterruptroutine 
Adresse  der  alien  Timerinterruptroutine 
Interruptintervall  in  Millisekunden 
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SHOW  CURSOR  (VD1 122) 


Diese  Funktion  zeigt  den  Grafik-Cursor,  genauer:  annulliert  einen  Aufruf  der  Hide-Cursor- 
Funktion.  Erst  mit  Erscheinen  des  Grafik-Cursors  auf  dem  Bildschirm  kann  dieser  mit  der 
Maus  bewegt  werden. 

Zu  beachten  ist,  daB  gegebenenfalls  fiir  jedes  Hide-Cursor-Kommando  auch  ein  Show- 
Cursor-Kommando  gegeben  werden  muB.  Es  besteht  also  die  Moglichkeit,  die  Show-  und 
Hide-Cursor-Kommandos  ineinander  zu  verschachteln.  Auf  die  saubere  Verschachtelung 
muB  selbst  geachtet  werden.  Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der 
physikalischen  Workstation,  die  ixn  Normalfall  von  den  AES  benutzt  wird.  Statt  dessen  sollte 
man  “graf_mouse()”  benutzen. 

Deklaration  in  C: 

void  v_show_c  (WORD  handle,  WORD  reset) 

{ 

intin [0]  =  reset; 
contrl[0]  =  122; 
contrl[l]  =  0; 
contrl[3]  =1; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

122 

Opcode  fur  V_SHOW_C 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4) 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

reset 

Parameter: 


handle:  Nummer  der  physikalischen  Workstation 

reset:  Reset-Flag.  0:  Anzahl  der  Hide-Cursor-Aufrufe  wird  ignoriert  (Maus  erscheint 

sofort  wieder),  sonst:  normale  Funktion  (ein  Hide-Cursor-Aufruf  wird  annulliert). 
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HIDE  CURSOR  (VDI 123) 


Diese  Funktion  bewirkt  das  Ausschalten  des  Grafik-Cursors,  womit  der  Benutzer  der 
Anwendung  keinen  EinfluB  auf  diesen  Cursor  mehr  hat. 

Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die 
im  Normalfall  von  den  AES  benutzt  wird.  Statt  dessen  sollte  man  “graf_mouse()”  benutzen. 


Deklaration  in  C: 

void  v_hide_c  (WORD  handle) 

{ 

contrl[0]  =  123; 
contrl[l]  =  contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  () ; 

} 


GEM- Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

123 

Opcode  fur  V_HIDE_C 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4]  , 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

Parameter: 

handle:  Nummer  der  physikalischen  Workstation 
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SAMPLE  MOUSE  BUTTON  STATE  (VDI 124) 


Diese  Funktion  gibt  eine  Mausinformation,  Position  des  Grafik-Cursors  und  Status  der 
Maustasten,  zuriick. 

Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die 
im  Normalfall  von  den  AES  benutzt  wird. 

Statt  dessen  sollte  man  “grafjnkstateO”  Oder  die  Event-Funktionen  benutzen. 

Deklaration  in  C: 

void  vq_mouse  (WORD  handle,  WOEtD  *pstatus,  WOE®  *x,  WORD  *y) 

{ 

contrl[0]  =  124; 
contrl [ 1 ]  =  0 ; 
contrl(3]  =  0; 
cont  rl [ 6 ]  =  handle ; 
vdi  ( ) ; 

*pstatus  =  intout [03; 

*x  =  ptsout [0]  ; 

*Y  =  ptsout [13; 

} 

GEM-Arrays: 


Adresse 

Feld  element 

Belegung 

contrl 

contrl  [0] 

124  Opcode  fur  VQ.  MOUSE 

contrl+2 

contrl[l] 

0  #  Eintriige  in  ptsin 

contrl+4 

contrl[2] 

1  #  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

1  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intout 

intout[0] 

pstatus 

ptsout 

ptsout[0] 

X 

ptsout+2 

ptsoutfl] 

y 
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Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

pstatus:  Maustastenstatus  (Bit  0:  linke  Taste,  Bit  1 :  Taste  rechts  daneben,  weitere  Bits: 

weitere  Tasten) 

x:  X-Koordinate  des  Grafxk-Cursors  in  NDC/RC-Koordinaten 

y:  Y-Koordinate  des  Grafik-Cursors  in  NDC/RC-Koordinaten 
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EXCHANGE  BUTTON  CHANGE  VECTOR  (VDI 125) 


Diese  Funktion  erlaubt  den  Aufruf  einer  Anwender-Routine  durch  Maustastendruck.  Hierzu 
wird  lediglich  die  Adresse  der  Maustasten-Status-Routine  geandert.  Das  heiBt,  die  Adresse  der 
Routine,  die  vorher  auf  Maustastendruck  reagierte,  wird  in  eine  anwendereigene  Adresse 
umgewandelt. 

Es  ist  die  Aufgabe  der  Anwendung,  die  alte  Maustasten-Status- Adresse  zu  speichem  und  am 
Ende  das  Register  wiederherzustellen. 

Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die 
im  Normalfall  von  den  AES  benutzt  wird. 


Deklaration  in  C: 

void  vex_butv  (WORD  handle,  LONG  pusrcode,  LONG  *psavcode) 

{ 

ijptr  (pusrcode);  /*  contrl [7/8] =pusrcode  */ 

contrl[0]  =  125; 

contrl [1]  =  contrl [3]  =  0; 

contrl [6]  =  handle; 

vdi  ( ) ; 

m_lptr2  (psavcode) ;  /*  *psavcode=contrl [9/10]  */ 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

125 

Opcode  fur  VEX_BUTV 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

contrl+14 

contrl[7/8] 

pusrcode 

contrl+18 

contrl[9/10] 

psavcode 

Parameter: 


handle:  Nummer  der  physikalischen  Workstation 
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pusrcode:  Adresse  der  neuen  Maustasten-Status-Routine.  In  Register  DO  erhalt  die  eigene 

Routine  den  Status  der  Maustasten,  Das  VDI  bearbeitet  DO  naeh  Beendigung 
der  Routine  weiter  -  man  kann  aJso  beispielsweise  ein  Bit  abfragen,  bearbeiten 
und  loschen  und  das  andere  unversehrt  lassen. 
psavcode:  Adresse  der  alten  Maustasten-Status-Routine 
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Diese  Function  erlaubt  den  Aufruf  einer  Anwender-Routine  durch  Mausbewegung.  Hierzu 
wird  lediglich  die  Adresse  der  Mausbewegungs-Routine  geandert.  Das  heiBt,  die  Adresse  der 
Routine,  die  vorher  auf  Mausbewegungen  reagierte,  wird  in  eine  anwendereigene  Adresse 
umgewandelt.  Die  Verzweigung  in  eine  anwendereigene  Routine  erfolgt  nach  Anderung  der 
Grafik-Cursor-Position,  aber  vor  Aktualisierung  der  neuen  Position  auf  dem  Bildschirm.  Es 
ist  die  Aufgabe  der  Anwendung,  die  alte  Mausbewegungs-Adresse  zu  speichem  und  am  Ende 
das  Register  wiederherzustellen.  Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der 
physikalischen  Workstation,  die  im  Normalfall  von  den  AES  benutzt  wird. 

Deklaration  in  C: 

void  vex_motv  (WORD  handle,  LONG  pusrcode,  LONG  *psavcode) 

{ 

i_ptr  (pusrcode);  /*  contrl [7/8]=pusrcode  */ 

contrl[0]  =  126; 

contrl [1]  =  contrl [3]  =  0; 

contrl [6]  =  handle; 

vdi ( ) ; 

m_lptr2  (psavcode) ;  /*  *psavcode=contrl [9/10]  */ 

) 


GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

126 

Opcode  fUr  VEX_MOTV 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

contrl+14 

contrl[7/8] 

pusrcode 

contrl+18 

contrl[9/10] 

|  psavcode 

Parameter: 

handle:  Nummer  der  physikalischen  Workstation 

pusrcode:  Adresse  der  neuen  Mausbewegungs-Routine  (in  DO  und  D1  werden  die 

aktuellen  Koordinaten  der  Maus  geliefert) 
psavcode:  Adresse  der  alten  Mausbewegungs-Routine 
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EXCHANGE  CURSOR  CHANGE  VECTOR  (VDI 127) 


Diese  Funktion  erlaubt  den  Aufruf  einer  Anwender-Routine  durch  Grafik-Cursor-Verande- 
rung.  Hierzu  wird  lediglich  die  Adresse  der  Grafik-Cursor-Zeichenroutine  geandert. 

Das  beifit,  die  Adresse,  die  vorher  auf  eine  Grafik-Cursor-Neuzeichenroutine  zeigte,  wird  in 
eine  anwendereigene  Adresse  umgewandelt, 

Die  Verzweigung  in  eine  anwendereigene  Routine  erfolgt  nach  Neuzeichnen  des  Grafik- 
Cursors.Esist  die  Aufgabe  der  Anwendung,  die  Adresse  der  alten  Grafik-Cursor-Zeichenroutine 
zu  speichem  und  am  Ende  das  Register  wiederherzustellen. 

Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der  physikalischen  Workstation,  die 
im  Normalfall  von  den  AES  benutzt  wird. 


Deklaration  in  C: 

void  vex_curv  (WORD  handle,  LONG  pusrcode,  LONG  *psavcode) 

{ 

i_ptr  (pusrcode);  /*  contrl [7/8]=pusrcode  */ 

contrl [0]  =  127; 

contrl [1]  =  contrl [3]  =  0; 

contrl  [6]  =  handle; 

vdi  ( ) ; 

m_lptr2  (psavcode) ;  /*  *psavcode=contrl [9/10]  */ 

} 


GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

127 

Opcode  fur  VEX_CURV 

contrl+2 

contrl[I] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

contrl+14 

contrl[7/8] 

pusrcode 

contrl+18 

contrl[9/10] 

psavcode 
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Parameter: 

handle: 

pusrcode: 

psavcode: 


Nummer  der  physikalischen  Workstation 

Adresse  der  neuen  Neuzeichen-Routine  (in  DO  und  D1  werden  die  aktuellen 
Koordinaten  der  Maus  geliefert).  Wenn  die  eigene  Routine  den  Grafik-Cursor 
nicht  neuzeichnet,  sollte  man  am  Ende  in  die  bisherige  Routine  weiterverzweigen ! 
Adresse  der  alten  Neuzeichen-Routine 
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'  SAMPLE  KEYBOARD  STATE  INFORMATION  (VDI128) 


Diese  Funktion  gibt  eine  Tastaturinformation,  Status  der  Control-,  der  Alternate-,  der  rechten 
und  linken  Shifttaste,  zuriick.  Die  Eingabe-Funktionen  des  VDI  funktionieren  nur  auf  der 
physikalischen  Workstation,  die  im  Normalfall  von  den  AES  benutzt  wird.  Statt  dessen  sollte 
man  “graf_mkstate()”  Oder  die  Event-Funktionen  benutzen. 


Deklaration  in  C: 

void  vq_key_s  (WORD  handle,  WORD  *pstatus) 
1 

contrl [0]  =  128; 
contrl[l]  =  contrl[3]  =  0; 
contrlffi]  =  handle; 
vdi  ( ) ; 

*pstatus  =  intout  [0]; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

128 

Opcode  fur  VQ_KEY_S 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intout 

intout[0] 

pstatus 

Parameter: 


handle: 

pstatus: 


Nummer  der  physikalischen  Workstation 
Tastaturstatus:  Bitbelegung: 


K_RSHIFT  (0x0001): 
KJLSHIFT  (0x0002): 
K_CTRL  (0x0004): 
K_ALT  (OxOOOS): 


rechte  Shift-Taste 
linke  Shift-Taste 
Control-Taste 
Alternate-Taste 
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Auskunftsfunktionen 


Diese  Funktion  gibtentweder  Auskunft  iiberdie  mit“OPEN  WORKSTATION”  (“v_opnwk()”) 
eingestellten  Parameter  oder  eine  erweiterte  Auskunft.  Die  Beschreibung  der  Parameter 
beziiglich  “OPEN  WORKSTATION”  ist  unter  dem  entsprechenden  Funktionsaufruf  zu 
finden. 


Deklaration  in  C: 

void  vq^extnd  (WORD  handle,  WORD  owflag,  WORD  *work_out) 
{ 

iioff  =  intin; 
pioff  =  ptsin; 
iooff  =  work_out; 
pooff  =  & (work_out [45] ) ; 
intin [0]=  owflag; 
contrl[0]  =  102; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  ()  ; 

iioff  =  intout; 
pioff  =  ptsout; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

102 

Opcode  fiir  VQ_EXTND 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

6 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

45 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0] 

owflag 

intout 

intout[0..44] 

work_out[0..44] 

ptsout[0..11] 

|  work_out[45..56] 
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Parameter: 

owflag: 

work_out[0]: 


work_out[l]: 

work_out[2]: 

work_out[3]: 

work_out[4]; 

work_out[5]: 

work_out[6]: 

work_out[7]: 

work_out[8]: 

work_out[9]: 

work_out[10]: 

work_out[U]: 

work_out[12]: 

work_out[13]: 

work_out[14]: 


work_out[15): 

work_out[16]: 

work_out[17]: 

work_.out[18]: 
work_out[19]: 
work_out[20]  bis 
work_out[44]: 
work_out[45]: 


Informationstyp  (0:  V__OPNWK-Parameter,  Standardparameter,  1 :  er- 
weiterte  Parameter) 

Bildschirmtyp 
0:  kein  Bildschirm 

1 :  getrennter  Alpha-  und  Grafikkontroller  und  getrennte  Bildschir- 

me 

2:  getrennter  Alpha-  und  Grafikkontroller  mit  gemeinsamem  Bild- 

schirm 

3 :  gemeinsamer  Alpha-  und  Grafikkontroller  mit  getrenntem  Bild- 

speicher 

4:  gemeinsamer  Alpha-  und  Grafikkontroller  mit  gemeinsamem 

Bildspeicher 

Anzahl  der  verfiigbaren  Hintergrundfarben 

Bit-Vektor  der  verfiigbaren  Texteffekte  (wie  bei  “vst_effects()”) 

Flag  fiir  VergroBerungsraster  (0:  VergroBem  nicht  moglich,  1 :  Vergro- 
Bem  moglich) 

Anzahl  der  Farbebenen 

“Lookup-table”-Unterstiitzung  (0:  nicht  moglich,  1:  moglich) 

Anzahl  der  16xl6-Pixel-Raster-Operationen  pro  Sekunde 
CONTOUR-FILL  Verfugbarkeit  (0:  nicht  verfiigbar,  1:  verfiigbar) 
Textrotation  (0:  nicht  moglich,  1 :  90  Grad-Drehungen,  2:  beliebig) 
Anzahl  der  Schreibmodi 

hochster  Grad  der  Eingabemodi  (0:  keine,  1 :  request,  2:  sample) 
Textausrichtungsverfiigbarkeit  (0:  nicht  verfiigbar,  1 :  verfiigbar) 
Farbstiftwechsel  am  Ausgabegerat  (0:  nicht  moglich,  1:  moglich) 
Farbbandwechselmoglichkeit  (0:  nicht  moglich,  1 :  farbige  Zeilen,  2: 
farbige  Zeilen  und  Rechtecke) 

maximale  Anzahl  von  Koordinatenpaaren  fiir  Polyline,  Polymarker  und 
Filled  Area  (-1:  unbegrenzt).  TOS  3.01  liefert  an  dieser  Stelle  einen 
falschen  Wert  (512  statt  256).  Abhilfe:  TOS  3.05  einsetzen. 
maximale  GroBe  des  INTIN-Arrays  (-1:  unbegrenzt) 

Anzahl  der  Maustasten 

Linientypen  fiir  breite  Linien  (liber  1  Pixel  Breite)  (0:  nicht  moglich,  1 : 
moglich) 

Schreibmodi  fiir  breite  Linien  (0:  nicht  verfiigbar,  1:  verfiigbar) 
Clipping  aus  (0)  oder  an  (1).  Nur  auf  PC-GEM  ab  Version  2.0! 

reserviert,  enthait  0  als  Ausgabewert. 

obere  linke  X-Koordinate  des  Clipping-Rechtecks  in  NDC/RC-Koor- 
dinaten 
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work_out[46]: 

work_out[47]: 

work_out[48]: 

work_out[49]  bis 
work_out[56]: 


obere  linke  Y-Koordinate  des  Clipping-Rechtecks  in  NDC/RC-Koordi- 
naten 

untere  linke  X-Koordinate  des  Clipping-Rechtecks  in  NDC/RC-Koor- 
dinaten 

untere  linke  Y-Koordinate  des  Clipping-Rechtecks  in  NDC/RC-Koor- 
dinaten 

reserviert,  enthalt  0  als  Ausgabewert. 


Bemerkungen 

Zusatzliche  Funktion  fur  Matrixdrucker:  Es  kann  die  maximale  Auflosung  angegeben  wer- 
den: 


ptsin[0]: 

ptsin[l]: 

contrl[l] 


maximale  X-Auflosung 
maximale  Y-Auflosung 
auf  1  setzen 
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Diese  Funktion  gibt  iiber  die  eingestellten  Farbintensitaten  der  Farbpalette  Auskunft.  Es 
besteht  die  Moglichkeit,  die  eingestellte  oder  die  tatsachliche  Intensitatsverteilung  zu 
erfragen. 


Deklaration  in  C: 

WORD  vg_color  (WORD  handle,  WORD  color_index,  WORD  set_flag, 
WORD  *rgb) 

{ 

intin [0]  =  color_index; 
intin [1]  =  set_flag; 
contrl[0]  =-.26; 
contrlfl]  =  0; 
contrl[3]  =  2; 
contrl[6]  =  handle; 
vdi  (); 

rgb[0]  =  intout [1]; 
rgb [ 1 ]  =  intout  [2 ] ; 
rgb [2]  =  intout [3] ; 
return  intout [0] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

26  Opcode  fur  VQ_COLOR 

contrl+2 

contrl[l] 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

4  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

colorjndex 

intin+2 

intin[l] 

set_flag 

intout 

intout[0] 

Retum-Wert 

intout+2 

intout[l.,3] 

rgb[0..2] 
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Parameter: 


color_index: 

set_flag: 


rgb[0]: 

rgb[l]: 

rgb[2]: 

vq_color(): 


Farbregister,  (iber  das  Auskunft  erwunscht  ist 
Flag  fur  gesetzte  oder  tatsSchliche  Farbintensitat 
0:  gesetzte  Intensitat 

I:  tatsachliche  Intensitat 

Rotintensitat  (in  Promille,  01000) 

Griinintensitat  (in  Promille,  0-1000) 

Blauintensitat  (in  Promille,  0-1000) 

1 ,  (gewiinschter/gesetzter)  Farbindex  auBerhalb  der  Grenzen 


Bemerkungen 

Gesetzte  und  tatsachliche  Intensitat  konnen  unterschiedlich  sein.  Die  Intensitaten  werden  in 
Werten  von  0  bis  1000  angegeben.  VerfUgt  etwa  ein  Monitor  nur  iiber  zwei  Intensitaten,  so 
teilt  sich  der  Bereich  in  die  Teilbereiche  0  bis  500  und  50 1  bis  1 000.  Die  tatsachliche  Intensitat 
kann  aber  nur  0  oder  1 000  sein.  Egal  welche  Zahl  man  aus  dem  Bereich  0  bis  500  wahlt,  immer 
wird  die  Intensitat  0  gesetzt.  Also  kann  beispielsweise  die  gesetzte  Intensitat  den  Wert  47  und 
die  tatsachliche  den  Wert  0  haben. 
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Diese  Funktion  gibt  fiber  die  aktuellen  gesetzten  Linienattribute  Auskunft. 


Deklaration  in  C: 

void  vql_attributes  (WORD  handle,  WORD  *attrib) 

i 

iooff  =  attrib; 
contrl[0]  =  35; 
contrl[l]  =  contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  ( ) ; 

iooff  -  intout; 
attrib ( 3 ]  =  ptsout [ 0 ] ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

35 

Opcode  ffir  VQL_ ATTRIBUTES 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  ptsout 

contrI+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

3 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intout 

intout[0..2] 

attrib[0..2J 

ptsout 

ptsout[0] 

attrib[5] 

ptsout+2 

ptsout[l] 

0 

Parameter: 


attrib[0]: 
attrib[l]: 
attrib[2] : 
attrib[3]: 


Linientyp 

Linienfarbindex 

Schreibmodus 

Linienbreite  (bzgl.  X-Achse  in  NDC/RC-Koordinaten) 
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Bemerkungen 

Die  hier  gemachten  Angaben  gelten  nur  fur  die  im  ROM  implementierte  Funktion.  Auch  die 
gebrauchlichen  Bindings  gehendavon  aus,  obwohl  die  Beschreibung  der  Funktion  vql_attributes 
in  den  Anleitungen  manchmal  etwas  anderes  behauptet.  Nach  Digital  Research  ist  die  Funk¬ 
tion  jedoch  ein  biBchen  anders  implementiert  (in  Ubereinstimmung  beispielsweise  mit  den 
GDOS-Druckertreibem). 

Demnach  erhalt  man  in  intout[0]  den  Linientyp,  in  intout[  1  ]  den  Linienfarbindex,  in  intout[2] 
den  Schreibmodus,  in  intout[3]  den  Linien-Anfangsstil,  in  intout[4]  den  Linien-Endstil  und 
in  ptsout[0]  die  Liniendicke  zuriick.  Man  beachte  daher  nach  Riickkehr  vom  Funktionsaufruf 
contrl[4J! 
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I  INQUIRE  CURRENT  POLYMARKER  ATTRIBUTES  (VDI 36) 

Diese  Funktion  gibt  iiber  die  aktuellen  gesetzten  Markerattribute  Auskunft. 


Deklaration  in  C: 

void  vqm_  attributes  (WORD  handle,  WORD  *attrib) 
{ 

iooff  =  attrib; 

contrl [0]  =  36; 

contrl [1]  =  contrl[3]  =  0; 

contrl [6]  =  handle; 

vdi  (); 

iooff  =  intout; 
attrib [3]  =  ptsout [1]; 


GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

36 

Opcode  fUr  VQM_ATTRIBUTES 

contrl+2 

contrl  f  1] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

3 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intout 

intout[0..2]  ; 

attrib[0..2J 

ptsout 

ptsout[0] 

0 

ptsout+2 

ptsout[l] 

attrib[3] 

Parameter: 


attrib[0] 

attribfl] 

attrib[2] 

attrib[3] 


Markertyp 

Markerfarbindex 

Schreibmodus 

Markerhohe  (bzgl.  der  Y-Achse  in  NDC/RC-Koordinaten) 
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Bemerkungen 

Die  hier  gemachten  Arigaben  gelten  nur  fur  die  im  ROM  implementierte  Funktion.  Auch  die 
gebrauchlichen  Bindings  gehen  davon  aus.  Nach  Digital  Research  ist  die  Funktion  jedoch  ein 
bifkhen  anders  implementiert  (in  Ubereinstimmung  beispielsweise  mitden  GDOS-Drucker- 
treibem). 

Demnach  erhalt  man  in  intout[0]  den  Markertyp,  in  intout[l]  den  Markerfarbindex,  in 
intout  [2]  den  Schreibmodus ,  in  ptsout[0]  die  Markerbreite  (bzgl.  der  X- Achse)  und  in  ptsout[  1  ] 
die  Markerhohe  zuriick.  Man  beachte  daher  bei  Ruckkehr  vom  Funktionsaufruf  auf  ptsout[0], 
ob  dort  ein  Wert  ungleich  0  zuriickgegeben  wurde! 

Es  existieren  Bindings,  bei  denen  attrib[3]  den  Wert  0  hat  und  in  attrib[4]  die  Markerhohe 
zuriickgeliefert  wird! 
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INQUIRE  CURRENT  FILL  AREA  ATTRIBUTES  (VDI 37) 


Diese  Funktion  gibt  iiber  die  aktuell  gesetzten  Fiillattribute  Auskunft. 


Deklaration  in  C: 

void  vqf_attributes  (WORD  handle,  WORD  *attrib) 
{ 

iooff  =  attrib; 

contrl[0]  =  37; 

contrl [1]  =  contrl[3]  =  0; 

cont.rl[6]  =  handle; 

vdi  ( ) ; 

iooff  =  intout; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

37 

Opcode  fur  VQF_ATTRIBUTES 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

5 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intout 

intout[0..4] 

attrib[0..4] 

Parameter: 


attrib[0] 

attrib[l] 

attrib[2] 

attrib[3] 

attrib[4] 


Fiillmuster  (“Fill  interior  index”) 

Fiillfarbmdex 

Musterindex  (“Fill  style  index”) 

Schreibmodus 

Umrahmungsstatus  (=0:  unsichtbar,  <>0:  sichtbar) 
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INQUIRE  CURRENT  GRAPHIC  TEXT  ATTRIBUTES  (VDI 38) 


Diese  Funktion  gibt  liber  die  aktuellen  gesetzten  Textattribute  Auskunft. 


Deklaration  in  C: 

void  vqt_attributes  (WORD  handle,  WORD  *attrib) 

{ 

iooff  =  attrib; 
pooff  =  & (attrib [6] ) ; 
contrl[0]  =  38; 
contrl[l]  =  contrl[3]  =  0; 
contrl[6]  =  handle; 
vdi  (); 

iooff  —  intout; 
pooff  =  ptsout; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

38 

Opcode  fiir  VQT_ATTRIBUTES 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

2 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

6 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intout 

intout[0.,5] 

attrib[0..5] 

ptsout 

ptsout[0..3] 

attrib[6..9] 

Parameter: 

attrib[0]:  Zeichensatz 

attribfl]:  Textfarbindex 

attrib[2]:  Textrotationsrichtung  (in  1/10  Grad) 

attrib[3]:  horizontale  Ausrichtung  (0:  linksjustiert,  1:  zentriert,  2:  rechtsjustiert) 

attrib[4]:  vertikale  Ausrichtung  (0:  Baseline,  1:  Half  line,  2:  Ascent  line,  3:  Bottom  line, 

4:  Descent  line,  5:  Top  line) 
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attrib[5]:  Schreibmodus 

attrib[6]:  Zeicbenbreite  (bzgl.  X-Achse  in  NDC/RC-Koordinaten) 

attrib[7]:  Zeichenhfthe  (bzgl.  Y-Achse  in  NDC/RC-Koordinaten) 

attrib[8]:  Zeichenzellenbreite  (bzgl.  X-Achse  in  NDC/RC-Koordinaten) 

attrib[9):  Zeichenzellenhohe  (bzgl.  Y-Achse  in  NDC/RC-Koordinaten) 
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Diese  Funktion  berechnet  die  AusmaBe  eines  minimalen  Rechteckes,  das  den  iibergebenen 
String  enthalt.  Die  Koordinaten  der  vier  Eckpunkte  werden  relativ  zu  einem  rechtwinkligen 
Koordinatensystem  ausgegeben. 

Der  niedrigste  Eckpunkt  des  Textrechteckes  liegt  auf  der  X-Achse,  der  am  weitesten  links 
liegende  Eckpunkt  auf  der  Y-Achse.  Die  Eckpunkte  sind  entgegen  dem  Uhrzeigersinn 
durchnumeriert.  Der  erstePunkt  liegt- wennderTextnormal  waagerechtsteht-inderunteren 
linken  Ecke  des  Textrechteckes .  Ftir  die  Berechnung  der  AusmaBe  des  Textrechteckes  werden 
alle  gesetzten  Attribute  beriicksichtigt. 


Deklaration  in  C: 

void  vqt_extent  (WORD  handle,  const  char  *string,  WORD  ^extent) 
{ 

WORD  *tmp; 
tmp  =  intin; 

while  (*tmp++  =  *string++) ; 
pooff  =  extent; 
contrltO]  =  116; 
contrl[l]  =  0; 

contrl [3]  =  (int) (tmp-intin) -1) ; 
contrl[6]  =  handle; 
vdi  ()  ; 

pooff  =  ptsout; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

116 

Opcode  fur  VQT_EXTENT 

contrI+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

4 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

n 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0..n-l] 

string[0..n-l] 

ptsout 

ptsout[0..7] 

extent[0..7J 
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Parameter: 

string:  Zeiger  auf  die  Zeichenkette  (bei  C-Bindings  nuilterminiert) 

extent[0]:  relative  X-Koordinate  des  1.  Punktes  des  Textrechtecks  (bzgl.  derX-Achse  in 

NDC/RC-Koordinaten) 

extent[l  j:  relative  Y-Koordinate  des  1.  Punktes  des  Textrechtecks  (bzgl.  der  Y-Achse  in 

NDC/RC-Koordinaten) 

extent[2] :  relative  X-Koordinate  des  2.  Punktes  des  Textrechtecks  (bzgl.  der  X-Achse  in 

NDC/RC-Koordinaten) 

extent[3]:  relative  Y-Koordinate  des  2.  Punktes  des  Textrechtecks  (bzgl.  der  Y-Achse  in 

NDC/RC-Koordinaten) 

extent[4]:  relative  X-Koordinate  des  3.  Punktes  des  Textrechtecks  (bzgl.  der  X-Achse  in 

NDC/RC-Koordinaten) 

extent[5]:  relative  Y-Koordinate  des  3.  Punktes  des  Textrechtecks  (bzgl.  der  Y-Achse  in 

NDC/RC-Koordinaten) 

extent[6] :  relative  X-Koordinate  des  4.  Punktes  des  Textrechtecks  (bzgl.  der  X-Achse  in 

NDC/RC-Koordinaten) 

extent[7]:  relative  Y-Koordinate  des  4,  Punktes  des  Textrechtecks  (bzgl.  der  Y-Achse  in 

NDC/RC-Koordinaten) 


Abb.  3.10:  Koordinatenpunkte  bei  vqt_attributes 
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Diese  Funktion  berechnet  die  horizontalen  Ausmafie  eines  Zeichens  des  aktuellen  Zeichensatzes 
und  der  Zeichenzelle.  Die  speziellen  Texteffekte  und  Drehungen  werden  nicht  beriicksichtigt. 


Abb.  3.11:  Die  Zeichenzelle 


Deklaration  in  C: 

WORD  vqt__width  (WORD  handle,  WORD  character,  WORD  *cell_width, 
WORD  *left_delta,  *right_delta) 

{ 

intin [0]  =  character; 
contrl[0]  =  117; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle ; 
vdi  ( ) ; 
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*cell_width  =  ptsout [0]; 
*left_delta  =  ptsout [2]; 
*right jdelta  =  ptsout  [4 ] ; 
return  intout [0] ; 

} 


GEM-Arrays: 


Adresse 

Feld  element 

Belegung 

contrl 

contrl  [0] 

1 1 7  Opcode  fiir  VQT_WIDTH 

contrl+2 

control] 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

3  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

l  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

1  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

character 

intout 

intout[0] 

Retum-Wert 

ptsout 

ptsout[0] 

cell_width 

ptsout+2 

ptsout[l] 

0 

ptsout+4 

ptsout[2] 

left_delta 

ptsout+6 

ptsout[3] 

0 

ptsout+8 

ptsout[4] 

right_delta 

ptsout+10 

ptsout[5] 

0 

Parameter: 

character:  Zeichennummer 

vqt_width():  ASCII-Wert  des  nachgefragten  Zeichens  (-1  bei  fehlerhafter  Wertiibergabe) 
cell_width:  Zeichenzellenbreite  (bzgl.  der  X-Achse  in  NDC/RC-Koordinaten) 
left_delta:  Abstand  linker  Zeichenzellenrand  zum  1  inken  Zeichenrand  (bzgl .  der  X-Achse 

in  NDC/RC-Koordinaten) 

right_delta:  Abstand  rechter  Zeichenzellenrand  zum  rechten  Zeichenrand  (bzgl.  der  Y- 
Achse  in  NDC/RC-Koordinaten) 

Bemerkungen 

Die  Werte  in  “left_delta”  und  “right_delta”  entsprechen  exakt  den  entsprechenden  Positionen 
im  “Horizontal  Offset  Table”.  Fehlt  diese  Tabelle  im  Zeichensatzkopf  (und  das  ist  bei  den  mei- 
sten  Zeichensatzen  der  Fall),  erhalt  man  als  Ergebnis  eine  Null. 
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INQUIRE  FACE  NAME  AND  INDEX  (VDI 130) 


Diese  Funktion  gibt  iiber  einen  Zeichensatznamen  und  dessen  Indexnummer  Auskunft.  Sie 
ermoglicht  es  damit  erst,  bei  anderen  Funktionen  den  Zeichensatz  iiber  seine  Indexnummer 
anzusprechen. 

Deklaration  in  C: 

WORD  vqt_name  (WORD  handle,  WORD  element_num,  char  *name) 

{ 

WORD  tmp; 

intin [0]  =  element_num; 
contrl [0]  =  130; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  ( ) ; 

for  (tmp  -  0;  tmp<32;  tmp++) 

name  [tmp]  'm  intout [tmp+1] ; 
return  intout [0]; 

} 


GEM- Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

130  Opcode  fiirVQT_NAME 

contrl+2 

contrl[l] 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0  #  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1  #  Eintrage  in  intin 

contri+8 

contrl  [4] 

33  #  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle  Geratekennung 

intin 

intin[0] 

elemenMium 

intout 

intout[0] 

Retum-Wert 

intout+2 

intout[1..32] 

name[0..31] 
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Parameter: 

element_num: 

vqt_name(): 

name: 


Nummer  des  Zeichensatzes  (1  bis  Maximalanzahl  der  verfiigbaren  Zei- 
chensatze. 

Sie  ergibt  sich  aus  der  Summe  des  Riickgabewertes  beim  Offnen  der  Work¬ 
station  (work_out[10])  und  dem  Riickgabewert  von  “vst_load_fonts()”)) 
Index  des  Zeichensatzes 

Name  des  Zeichensatzes  als  maximal  32  Zeichen  lange  Zeichenkette  (z.  B. 
“Swiss  721”). 
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INQUIRE  CELL  ARRAY  (VDI 27) 


Diese  Funktion  gibt  Auskunft  iiber  die  Definition  des  Cell- Arrays.  Zu  beachten  ist,  daB  diese 
Funktion  nicht  auf  alien  Geraten  verfiigbar  ist. 


Deklaration  in  C: 

void  vq_cellarray  (WORD  handle,  WORD  *pxyarray,  WORD  row_length, 
WORD  num_rows,  WORD  *el_used,  WORD  *rows_used, 
WORD  *status,  WORD  *colarray) 

{ 

pioff  =  pxyarray; 
iioff  =  colarray; 
contrl[0]  =  27; 
contrl[l]  =2; 
contrl[3]  =  0; 
contrl[6]  =  handle; 
contrl[7]  =  row_length; 
contrl[8]  =  num_rows; 
vdi  ( )  ; 

*el_used  =  contrl[9]; 

*rows_used  =  contrl[10]; 

* status  =  contrl[ll]; 
pioff  =  ptsin; 
iioff  =  intout; 

} 


GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

27 

Opcode  fur  VQ_CELLARRAY 

contrI+2 

contrl[  1  ] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrlf4] 

n 

#  Eintrage  in  intout 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

contrl+14 

contrl  [7] 

row_length 

contrl+16 

contrl[8] 

num_rows 

contrl+18 

contrl  [9] 

eLused 
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Adresse 

Feldelement 

Belegung 

contrl+20 

contrl[10] 

rows._used 

contrl+22 

contrlflf] 

status 

ptsin 

ptsin[0..3] 

pxyarray[0..3] 

intout 

intout[0..n-l] 

colarray(0..n-l] 

Parameter: 

rowjcngth: 

num_rows: 

el_used: 

rows_used: 

status: 

pxyarray[0]: 

pxyarray[l]: 

pxyarray[2]: 

pxyarray[3]: 

col  array!]: 


Zeilenlange  im  Farbindex-Array 
Anzalil  der  Zeilen  im  Farbindex-Array 
Spaltenanzahl 

Anzahl  der  benutzten  Spalten  im  Farbindex-Array 

0:  keine  Fehler,  1 :  fiir  einige  Pixel  konnte  der  Farbwert  nicht  bestimmt  werden. 
X-Koordinate  der  oberen  linken  Ecke  des  Begrenzungsrechteckes 
Y-Koordinate  der  oberen  linken  Ecke  des  Begrenzungsrechteckes 
X-Koordinate  der  unteren  rechten  Ecke  des  Begrenzungsrechteckes 
Y-Koordinate  der  unteren  rechten  Ecke  des  Begrenzungsrechteckes 
Farbindex-Array,  enthalt  die  Farbinformation  zeilenweise,  -1  falls  Farbindex 
fiir  den  vorgegebenen  Bereich  nicht  bestimmt  werden  konnte. 
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INQUIRE  INPUT  MODE  (VDI 115) 


Diese  Funktion  gibt  Auskunft  liber  den  aktueUen  Eingabemodus  fur  das  spezifizierte,  logische 
Eingabegerat. 


Deklaration  in  C: 

void  vqin_mode  (WORD  handle,  WORD  dev_type,  WORD  *input_mode) 

{ 

int in ( 0 ]  =  devjtype ; 
contrl[0]  =  115; 
contrl[l]  =  0; 
contrl[3]  =  1; 
contrl[6]  =  handle; 
vdi  ()  ; 

*input_mode  =  intout [0] ; 

) 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

115 

Opcode  fur  VQIN_MODE 

contrl+2 

control] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

eontrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle 

Geratekennung 

in  tin 

intinfO] 

dev_type 

intout 

intout[0] 

input_mode 

Parameter: 

handle:  Kennung  der  physikalischen  Workstation 

dev_type:  logische  Eingabeeinheit 

1:  Positions-Eingabeeinheiten 
2:  wertverandemde  Eingabeeinheiten 
3:  auswahlende  Eingabeeinheiten 
4:  Zeichenketten-Eingabeeinheiten 
input_mode:  Eingabe-Modus  (1:  REQUEST,  2:  SAMPLE) 
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Diese  Funktion  gibt  iiber  den  aktuellen  Zeichensatz  Auskunft.  Es  wird  die  gegenwtirtige  Gr5Be 
ausgegeben.  Die  aktuellen  Texteffekte  werden  ebenso  beriicksichtigt.  Sollten  die  Zeiehen  in 
Kursivschrift  dargestellt  sein,  so  wird  die  Neigung  als  rechter  und  linker  Offsetwert  bedacht. 
Rechter  Offsetwert  ist  der  horizontale  Abstand  der  Zeichenposition  (linkes  Basislinienende) 
zum  LotfuBpunkt  des  Lotes  auf  die  Basislinie  durch  die  obere  rechte  Ecke.  Linker  Offsetwert 
ist  der  Abstand  der  Zeichenposition  zum  LotfuBpunkt  des  Lotes  auf  die  Basislinie  durch  die 
untere  linke  Ecke, 


Abb.  3.12:  Offsetinformationen  iiber  den  akiuell  eingestelllen  Zeichensatz 


Deklaration  in  C: 

void  vqt_fontinfo  (WORD  handle,  WORD  *minM)E,  WORD  *maxADE, 

WORD  *distances,  WORD  *maxwidth,  WORD  *effects) 

{ 

contrl[0J  =  131; 
contrltl]  =  contrl[3]  =  0; 
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contrl[6]  =  handle; 
vdi  ( ) ; 

*minADE  =  intout [ 0 ] ; 
*maxADE  =  intout[l]; 
*maxwidth  =  ptsout [0]; 
distances  [0]  =ptsout[l], 
distances [1] 
distances [2] 
distances [3] 
distances [4] 
effects [0] 
effects [1] 


=  ptsout [3] , 
=  ptsout [5] , 
=  ptsout [7]  i 
=  ptsout [9]  i 
ptsout  [2] ; 
ptsout [ 4 ] ; 
effects[2]  =ptsout[6]; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

131  Opcode  fur  VQT_FONTINFO 

contrl+2 

contrl  [I] 

0  #  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

5  #  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0  #  Eintrage  in  intin 

contrl+8 

contrl[4] 

2  #  Eintrage  in  intout 

contrl+I2 

contrl  [6] 

handle  Geratekennung 

intout 

intout[0] 

minADE 

intout+2 

intout[l] 

maxADE 

ptsout 

ptsout[0] 

maxwidth 

ptsout+2 

ptsout[l] 

distances[0] 

ptsout+4 

ptsout[2] 

effects[0] 

ptsout+6 

ptsout[3] 

distances[l] 

ptsout+8 

ptsout[4] 

effects!  1] 

ptsout+10 

ptsout[5] 

distances[2] 

ptsout+12 

ptsout[6] 

effects  [2] 

ptsout+14 

ptsout[7] 

distances[3] 

ptsout+16 

ptsout[8] 

0 

ptsout+18 

ptsout[9] 

distances[4] 

VDI-Betriebssystemroutincn 
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Parameter: 

minADE: 

minADE: 

maxwidth: 

distances[0]: 

distances)!]: 

distances[2] 

distances[3]: 

distances[4]: 

effects[0]: 

effects[l]: 

effects[2]: 


niedrigster  ASCII- Wert,  erstes  Zeichen  des  Zeichensatzes 
hochster  ASCII- Wert,  letztes  Zeichen  des  Zeichensatzes 
maximaJe  Zeichenzellenbreite  ohne  Texteffekte 
Abstand  Untergrenze  Zeichenzelle  zu  Basislinie  (bzgl.  Y-Achse) 

Abstand  Untergrenze  Zeichen  (Unterliingen)  zur  Basislinie  (bzgl.  Y-Achse) 
Abstand  Halblinie  (Obergrenze  Kleinbuchstaben  (wie  a,  c,  e,  g,))  zur  Basislinie 
(bzgl.  Y-Achse) 

Abstand  Obergrenze  Zeichen  zur  Basislinie  (bzgl.  Y-Achse) 

Abstand  Obergrenze  Zeichenzelle  zur  Basislinie  (bzgl.  Y-Achse) 

Betrag,  um  den  die  Zeichenbreite  bei  den  aktuell  eingestellten  Texteffekten 
zunimmt  (bzgl.  X-Achse) 
linker  Offsetwert  (bzgl.  X-Achse) 
rechter  Offsetwert  (bzgl.  X-Achse) 
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-  nur  auf  PC-GEM  ab  Version  2.0! 


Fragt  fiir  jedes  Zeichen  eines  Strings  die  X-  und  Y -Offsets  von  einem  gegebenen  Ausrichtungs- 
punkt  ab. 

Deklaration  in  C: 

void  vqt_justified  (WORD  handle,  WORD  x,  WORD  y, 

const  char  *string,  WORD  length, 

WORD  word__space,  WORD  char__space, 

WORD  *offsets) 

{ 

WORD  i; 

contrl[0]  =  132; 
contrl[l]  =  2; 
intin [0]  =  word_space; 
intin [1]  =  char_space; 
i  =  0; 

while  (tmp[i]  =  string [ i++] )  ; 

contrl[3]  =  i; 

contrl[6]  =  handle ; 

ptsin[0]  =  x; 

ptsin [1]  =  y; 

ptsin[2]  =  length; 

ptsin [3]  ~  0; 

pooff  =  offsets; 

vdi  ( ) ; 

pooff  =  ptsout; 

} 


GEM-Arrays: 


Adresse 
- 1 

Feldelement 

Belegung 

contrl 

contrl[0] 

132 

Opcode  fiir  VQT_JUSTIFIED 

contrl+2 

contrl[l] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

n 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2+n 

#  Eintrage  in  intin 

VDI-Betriebssystemroutinen 
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Adresse 

Feldelement 

Belegung 

contrl+8 

contrl[4] 

0  #  Eintrage  in  intout 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

word_space 

intin+2 

intinfl] 

char_space 

intin+4 

intin[2..n+l] 

string[0..n+l] 

ptsin 

ptsin[0] 

X 

ptsin+2 

ptsin[l] 

y 

ptsin+4 

ptsin(2] 

length 

ptsin+6 

ptsin[3] 

0 

ptsout 

ptsoutf...] 

offsetsf...] 

Parameter: 


word_space: 


char_space: 


string: 

x: 

y: 

length: 

offsets!]: 


Flag  fur  Wortzwischenraume 

0:  keine  Dehnung  der  Wortzwischenraume 

nicht  0:  Dehnung  der  Wortzwischenraume 

Flag  fur  Zeichenzwischenraume 

0:  keine  Dehnung  der  Zeichenzwischenraume 

nicht  0:  Dehnung  der  Zeichenzwischenraume 

Zeiger  auf  Zeichenkette 

X-Koordinate  des  Textausrichtungspunktes 

Y-Koordinate  des  Textausrichtungspunktes 

Textlange  (in  Pixeln)  bzgl.  der  X-Richtung 

jeweils  fiir  jedes  Zeichen  in  der  Zeichenkette  der  X-  und  Y-Offsets  (das  Array 
ist  also  genau  doppelt  so  lang  wie  die  Zeichenkette) 


Escapes 


ESCAPE  (VDI 5) 


Die  Escape-Funktionen  erlauben  dem  Anwendungsprogramm,  spezielle  Fahigkeiten  von 
Ausgabegcraten  auszunutzen.  Das  betreffende  Ausgabegerat  ist  jeweils  neben  bzw.  unter  dem 
Funktionsnamen  angegeben.  Der  Parameter  “handle”  ist  bei  alien  Funktionendas  Geratehandle. 
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(VDI 5,  Escape  1)  (Bildschirm) 


Diese  Funktion  gibt  iiber  die  Anzahl  der  mit  dem  Alpha-Cursor  ansprechbaren  Zeilen  und 
Spalten  Auskunft. 


Deklaration  in  C: 

void  vq_chcells  (WORD  handle,  WORD  *rows,  WORD  *columns) 
{ 

contrl[0]  =5; 

contrl [1]  =  contrl[3]  =  0; 

contrl[5]  =  1; 

contrl[6]  =  handle; 

vdi  ( ) ; 

*rows  =  intout [0]; 

* columns  =  intout [1]; 

} 


GEM-Arrays: 

Adresse  Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

control] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

2 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

1 

V  Q_CHCELLS 

contrl+12 

contrl[6] 

handle  Geratekennung 

intout 

intout[0] 

rows 

intout+2 

intout[l] 

columns 

Parameter: 

rows:  Anzahl  der  adressierbaren  Zeilen,  -1  falls  keine  Adressierung  mdglich 

columns:  Anzahl  der  adressierbaren  Spalten,  -1  falls  keine  Adressierung  moglich 


VDI-Betriebssystemroutinen 
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EXIT  ALPHA  MODE  (VDI 5,  Escape  2)  (Bildschirm,  Metafile) 


Diese  Funktion  schaltet'den  Alpha-Modus  aus,  sofem  Alpha-  und  Grafikmodus  unterschied- 
lich  sind.  Gleichzeitig  wird  der  Grafikbildschirm  geloscht  (bei  einem  Metafile  wird  ein  ent- 
sprechender  Eintrag  vorgenommen). 


Deklaration  in  C: 


void  v_exit_cur 
( 

contrl [0]  = 
contrl [ 1 ]  = 
contrl [5]  = 
contrl [6]  = 
vdi  ( ) ; 

} 


(WORD  handle) 

5; 

contrl [3]  =  0; 
2; 

handle; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrl  [1] 

0 

#  Eintrage  in  ptsin 

eontrl+4 

contrl[2] 

0 

#  Eintrdge  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

2 

V_EXIT_CUR 

contrl+12 

contrl[6] 

|  handle  Geratekennung 

Bemerkungen 

Der  Alpha-Modus  ist  der  normale  Textmodus  ohne  Grafik,  wie  er  etwa  vom  Desktop  fiir  die 
Anzeige  von  Dateien  benutzt  wird. 
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ENTER  ALPHA  MODE  (VDI 5,  Escape  3)  (Bildschirm,  Metafile)  j 


Diese  Funktion  bewirkt  das  Verlassen  des  Grafik-Modus,  falls  dieser  nicht  identisch  mit  dem 
Alpha-Modus  ist.  Ebenso  wird  der  Alpha-Cursor  in  die  obere  linke  Zeichenzelle  gesetzt  und 
der  Alpha-Bildschirm  geloscht  (bei  einem  Metafile  wird  ein  entsprechender  Eintrag  vorge- 
nommen). 


Declaration  in  C: 

void  v_enter__cur  (WORD  handle) 

t 

contrl [0]  -5; 
contrl[l]  =  contrl[3]  =  0; 
contrl[5]  =  3; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrlf  1  ] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

3. 

v_enter_cur 

contrl+12 

|  contrl[6] 

handle 

Geratekennung 

VDI-Betriebssystemroutinen 
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ALPHA  CURSOR  UP  (VDI 5,  Escape  4)  (Bildschirm) 


Diese  Funktion  bewegt  den  Alpha-Cursor  eine  Zeile  hoher,  ohne  die  horizontale  Position  zu 
verandem.  Sollte  sich  der  Cursor  in  der  oberen  Zeile  befinden,  so  passiert  nichts. 


Deklaration  in  C: 

void  v__curup  (WORD  handle) 

{ 

contrl[0]  =  5; 
contrl[l]  =  contrl[3]  =  0; 
contrl [5]  =  4; 
contrl [6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2  , 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

4 

V_CURUP 

contrl+12 

contrl[6] 

handle 

Geratekennung 
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Diese  Funktion  bevvegt  den  Alpha-Cursor  eine  Zeile  tiefer,  ohne  die  horizontale  Position  zu 
verandem.  Sollte  sich  der  Cursor  in  der  untersten  Zeile  befinden,  so  passiert  nichts. 


Deklaration  in  C: 

void  v_curdown  (WORD  handle) 

{ 

contrl[0]  =  contrl[5]  =  5; 
contrltl]  =  contrl[3]  =  0; 
contrl[6]  -  handle; 
vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fUr  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contd+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

5 

V_CURDOWN 

contrl+12 

contrl[6] 

handle 

Geratekennung 

VDI-Betriebssystemroutinen 
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ALPHA  CURSOR  RIGHT  (VDI 5,  Escape  6)  (Bildschirm) 


Diese  Funktion  bewegt  den  Alpha-Cursor  eine  Spalte  nach  rechts,  ohne  die  vertikale  Position 
zu  verandem.  Sollte  sich  der  Cursor  bereits  am  rechten  Bildschirmrand  befinden,  so  passiert 
nichts. 


Dekiaration  in  C: 

void  v__curright  (WORD  handle) 

{ 

contrl [ 0 ]  =  5 ; 

contrl [1]  =  contrl [3]  =  0; 

contrl [5]  =  6; 

contrl [6]  =  handle; 

vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

6 

V_CURRIGHT 

contrl+12 

contrl[6] 

handle  Geratekennung 
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ALPHA  CURSOR  LEFT  (VDI  5,  Escape  7)  (Bildsehirm) 

__ 

Diese  Funktion  bewegt  den  Alpha-Cursor  eine  Spalte  nach  links,  ohne  die  vertikale  Position 
zu  verandem.  Sollte  sich  der  Cursor  bereits  am  linken  Rand  befmden,  so  passiert  nichts. 


Deklaration  in  C: 


void  v_curleft 

{ 

contrl [0] 
contrl [1] 
contrl [5] 
contrl [6] 
vdi  ( ) ; 

} 


(WORD  handle) 

=  5; 

=  contrl [3]  =  0; 
=  7; 

=  handle; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fUr  ESCAPE 

contrl+2 

contrl  [1] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5} 

7 

V.CURLEFT 

contrl+12 

contrl[6] 

!  handle  Geratekennung 

VDI-Betriebssystemroutinen 
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HOME  ALPHA  CURSOR  (VDI 5,  Escape  8)  (Bildschirm) 


Diese  Funktion  bewegt  den  Alpha-Cursor  in  seine  “Heim”-Stellung,  normalerweise  oben 
links  auf  dem  Bildschirm. 


Deklaration  in  C: 

void  v_curhome 
{ 

contrl [0] 
contrl [1] 
contrl [5] 
contrl [6] 
vdi  { ) ; 

} 


(WORD  handle) 

=  5? 

=  contrl (3]  =  0; 
=  8; 

=  handle; 


GEM-Arrays: 


Adresse 

Feldelement 

|  Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrI+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

8 

V_CURHOME 

contrl+12 

contrl[6] 

handle 

Geratekennung 
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ERASE  TO  END  OF  ALPHA  SCREEN 
(VDI 5,  Escape  9)  (Bildschirm) 

Diese  Funktion  loscht  den  Bildschirm  ab  der  aktuellen  Alpha-Cursor-Position,  die  hierbei 
nicht  verandert  wird. 

Deklaration  in  C: 

void  v_eeos  (WORD  handle) 

{ 

contrl[0]  =  5; 

contrl [1]  =  contrl[3]  =  0; 

contrl[5]  =  9; 

contrl[6]  =  handle; 

vdi  ( ) ; 

> 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

9 

V_EEOS 

contrI+12 

contrl[6] 

handle 

Geratekennung 

VDI-Betriebssystemroutinen 
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ERASE  TO  END  OF  ALPHA  TEXT  LINE 
(VDI 5,  Escape  10)  (Bildschirm) 


Diese  Funktion  loscht  ab  der  aktuellen  Alpha-Cursor-Position  die  aktuelle  Textzeile,  wobei 
die  Position  des  Alpha-Cursors  nicht  verandert  wird. 

Deklaration  in  C: 

void  v_eeol  (WORD  handle) 

{ 

contrl [0]  =  5; 

contrl [1]  =  contrl[3]  =  0; 

contrl[5]  =  10; 

contrl[6]  =  handle; 

vdi  { )  ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  EintrSge  in  intout 

contrl+10 

contrl[5] 

10 

VJEEOL 

contrl+12 

contrl[6] 

handle  Geratekennung 
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DIRECT  ALPHA  CURSOR  ADDRESS 
(VDI 5,  Escape  II)  (BHdschirm) 

Diese  Funktion  bewegt  den  Alpha-Cursor  zu  einer  bestimmten  Spalte  und  Zeile.  Sollten 
Adressen  oberhalb  der  Maximalgrenze  angegeben  werden,  so  nimmt  die  Funktion  den  am 
nachsten  liegenden  Wert. 

Deklaration  in  C: 

void  v_curaddress  (WORD  handle,  WORD  row,  WORD  column) 

{ 

intin [0]  =  row; 
intin [1]  =  column; 
contrl[0]  =  5; 
contrl[l]  =  0; 
contrl[3]  =  2; 
contrl[5]  =  11; 
contrl[6]  =  handle; 
vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  ftir  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

11 

V_CURADDRESS 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

row 

intin+2 

intin[l] 

column 

Parameter: 

row:  Zeile  fur  Cursor-Position  (1  bis  Maximalanzahl  der  Zeilen) 

column:  Spalte  fur  Cursor-Position  (1  bis  Maximalanzahl  der  Spalten) 


VDI-Betriebssystemroutinen 
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OUTPUT  CURSOR  ADDRESSABLE  ALPHA  TEXT 
(VDI 5,  Escape  12)  (Bildschirm) 


Diese  Funktion  veranlaBt  die  Ausgabe  einer  Zeichenkette  ab  der  aktuellen  Alpha-Cursor- 
Position.  Man  beachte,  da6  man  hiermit  schneller  (!)  Text  ausgeben  kann  als  iiber  das  GEM- 
DOS!  Der  Cursor  wird  dabei  fur  jedes  Zeichen  eine  Stelle  weitergerilckt  (der  Alpha-Modus 
muB  logischerweise  angeschaltet  sein). 


Deklaration  in  C: 


void 

{ 


_curtext  (WORD  handle,  const  char  * string) 

WORD  *tmp; 
tmp  =  intin; 

while  (*tmp++  =  *string++) ; 


contrl  [0] 
contrl [1] 
contrl [3] 
contrl [5] 
contrl [6] 
vdi  ()  ; 


5; 

0; 

( (int)  (tmp-intin) - 
12; 

handle; 


l)l 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

n 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

12 

V_CURTEXT 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0..n-l] 

string[0..n-l] 

Parameter: 

string:  Zeiger  auf  die  auszugebende  Zeichenkette 
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REVERSE  VIDEO  ON  (VDI 5,  Escape  13)  (Bildschirm) 


Mit  dieser  Funktion  wird  die  inverse  Alpha-Textdarstellung  eingestellt. 


Deklaration  in  C: 


(WORD  handle) 


void  v_rvon 
{ 

contrl [0] 
contrl [1] 
contrl [5] 
contrl [6] 
vdi  (); 


5; 

contrl [3]  =  0; 
13; 

handle; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

eontrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

eontrl+10 

contrl  [5] 

13 

V_RVON 

contrl+12 

contrl[6] 

handle  Geratekennung 

VDI-Betriebssystemroutinen 
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REVERSE  VIDEO  OFF  (VDI 5,  Escape  14)  (BUdschirm) 


Mit  dieser  Funktion  wird  die  inverse  AIpha-Textdarstellung  abgeschaltet. 


(WORD  handle) 
5; 


Deklaration  in  C: 

void  v_rvoff 
{ 

contrl [0] 
contrl [1] 
contrl [5] 
contrl [6] 
vdi  ()  ; 

} 


contrl [3]  =  0; 
14; 

handle; 


GEM-Arrays; 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl44 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

14 

VJtVOFF 

contrl+12 

contrl[6] 

handle 

Geratekennung 
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INQUIRE  CURRENT  ALPHA  CURSOR  ADDRESS 
(VDI 5,  Escape  15)  (Bildschirm) 

Diese  Funktion  gibt  liber  die  aktuelle  Alpha-Cursor-Position  Auskunft. 
Deklaration  in  C: 

void  vq__cur  address  (WORD  handle,  WORD  *row,  WORD  ^column) 

{ 

contrl[0]  =  5; 
contrltl]  =  contrl  [3]  =  0; 
contrl[5]  =  15; 
contrl [6]  =  handle; 
vdi  () ; 

*row  =  intout [0]; 

*column  =  intout [1]; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  fO] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

2 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

15 

VQ_CURADDRESS 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intout 

in  tout  fO] 

row 

intout+2 

intoutfl] 

column 

Parameter: 


row: 

column: 


aktuelle  Zeilenposition  des  Alpha-Cursors 
aktuelle  Spaltenposition  des  Alpha-Cursors 
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INQUIRE  TABLET  STATUS  (VDI 5,  Escape  16)  (BUdschirm) 

Diese  Funktion  gibt  iiber  die  Verfiigbarkeit  eines  Grafik-Tabletts,  einer  Maus,  eines  Joysticks 
Oder  eines  ahnlichen  Gerates  Auskunft. 

Deklaration  in  C: 

WORD  vq_tabstatus  (WORD  handle) 

{ 

contrl[0]  =5; 
contrl[l]  =  contrl[3]  =  0; 
contrl[5]  =  16; 
contrl[6]  =  handle; 
vdi  ( ) ; 

return  intout [ 0 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrI[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

16 

VQ„TABSTATUS 

contrl+12 

contrl[6] 

handle 

Geratckennung 

intout 

intout[0] 

Retum-Wert 

Parameter; 

vq_tabstatus():  Geratestatus  (0:  nicht  verfiigbar,  1:  verfiigbar) 
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HARD  COPY  (VDI 5,  Escape  17)  (Bildschirm) 


Diese  Funktion  bewirkt  die  Ausgabe  einer  Hardcopy  auf  einen  Drucker  oder  ein  entsprechen- 
des  Gerat.  Man  beachte,  daB  dies  eine  Funktion  des  Bildschirmtreibers  ist  (der  dazu  auf  das 
XBIOS  zugreift). 

Deklaration  in  C: 

void  vjhardcopy  (WORD  handle) 

{ 

contrl  [0]  =  5; 
contrl[l]  =  contrl[3]  =  0; 
contrl[5]  —  17; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

17 

VHARDCOPY 

contrl+12 

contrl[6] 

handle 

Geratekennung 
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PLACE  GRAPHIC  CURSOR  AT  LOCATION 
(VDI 5,  Escape  18)  (Bildschirm) 

Diese  Funktion  setzt  den  Grafik-Cursor  an  eine  bestimmte  Stelle.  Sie  ist  nur  auf  Geraten 
verfijgbar,  die  Positionseingaben  (Locator)  -  etwa  mit  Maus,  Joystick  oder  Trackball  - 
zulassen. 


Deklaration  in  C: 

void  v_dspcur  (WORD  handle,  WORD  x,  WORD  y) 
{ 

ptsin[0]  =  x; 
ptsin[l)  =  y; 
contrl[0]  =  5; 
contrl[l]  =  1; 
contrl[3]  =  0; 
contrl [5]  =  18; 
contrl[6]  =  handle; 
vdi  (); 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrlfl] 

1 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

18 

V_DSPCUR 

contrl -1-12 

contrl  [6] 

handle 

Geratekennung 

ptsin 

ptsin [0] 

X 

ptsin+2 

ptsin[l] 

y 

Parameter; 

x:  X-Koordinate  der  neuen  Grafik-Cursor-Stellung 

y:  Y-Koordinate  der  neuen  Grafik-Cursor-Stellung 
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REMOVE  LAST  GRAPHIC  CURSOR 
(VDI 5,  Escape  19)  (Bildschirtn) 

Diese  Funktion  entfemt  den  zuletzt  dargestellten  Grafik-Cursor. 

Deklaration  in  C: 

void  v_rmcur  (WORD  handle) 

{ 

contrl  [0]  =  5; 
contrl[l]  =  contrl [3]  =  0; 
contrl [5]  =  19; 
contrl [6]  =  handle; 
vdi  () ; 

} 


GEM-Arrays: 


Adresse 

Feldeiement 

Belegung 

contrl 

contrlfO] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintr&ge  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

19 

VJRMCUR 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

VDI-Betriebssystemroutinen 
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FORM  ADVANCE  (VDI 5,  Escape  20)  (Drucker,  Metafile)  1 

“FORM  ADVANCE”  bewirkt  einen  Seitenvorschub  (iihnJich  “CLEAR  WORKSTATION”). 
Der  Datenpuffer  wird  nicht  geloscht.  Falls  das  “Ausgabegerat”  ein  Metafile  ist,  wird  ein 
entsprechender  Eintrag  geschrieben. 

Deklaration  in  C: 

void  v_form_adv  (WORD  handle) 

{ 

contrl[0]  =  5; 
contrl[l]  =  contrl[3]  =0; 
contrl[5]  =  20; 
contrl[6]  =  handle; 
vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

20 

V_FORM_ADV 

contrl+12 

contrl  [6] 

handle 

Geratekennung 
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OUTPUT  WINDOW  (VDI 5,  Escape  21)  (Drucker) 


“OUTPUT  WINDOW”  ist  eine  Verallgemeinerung  von  “UPDATE  WORKSTATION”,  die 
es  erlaubt,  eine  einzige  Abbildung  auf  mehrere  Blatter  verteilt  zu  drucken.  Einziger 
Unterschied  zu  “UPDATE  WORKSTATION”:  Es  kann  ein  Ausschnitt  aus  dem  Drucker- 
Koordinatensystem  ausgewahlt  werden. 

Deklaration  in  C: 

void  v_output_window  (handle,  WORD  *xyarray) 

1 

pioff  =  xyarray; 
contrl [0]  =  5; 
contrl[l]  =  2; 
contrl [3]  =  0; 
contrl[5]  =  21; 
contrl[6]  =  handle; 
vdi  ( ) ; 

pioff  =  ptsin; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrl[l] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

21 

V_OUTPUT_WINDOW 

contrl+12 

contrI[6] 

handle  Geratekennung 

ptsin 

ptsin[0..3] 

xyarray[0..3] 

Parameter; 


xyarray  [0]; 
xyarrayfl] 
xyarray[2] 
xyarray[3] 


X-Koordinate  einer  Ecke  des  Ausgaberechteckes 
Y-Koordinate  einer  Ecke  des  Ausgaberechteckes 

X-Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Ausgaberechteckes 
Y-Koordinate  der  diagonal  gegeniiberliegenden  Ecke  des  Ausgaberechteckes 
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CLEAR  DISPLAY  LIST  (VDI 5,  Escape  22)  (Drucker,  Metafile) 


Mit  “CLEAR  DISPLAY  LIST”  kann  dcr  Druckerpuffer  (ahnlich  “CLEAR  WORKSTATION”) 
geloscht  werden.  Ein  Seitenvorschub  wird  nicht  durchgefiihrt. 


Deklaration  in  C: 

void  v_clear_disp_lxst  (WORD  handle) 
{ 

contrltO]  =  5; 

contrl [1]  =  contrl[3]  =  0; 

contrl[5]  =  22; 

contrl[6]  =  handle; 

vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

22 

V_CLEAR_DISPJLIST 

contrl+12 

contrl[6] 

handle  Geratekennung 
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OUTPUT  BIT  IMAGE  FILE  (VDI 5,  Escape  23)  (Drucker,  Metafile) 


Mit  “OUTPUT  BIT  IMAGE  FILE”  kann  die  in  einer  IMG-Datei  gespeicherte  Bild-Informa- 
tion  gelesen  und  auf  dem  Ausgabegerat  ausgegeben  werden. 


Deklaration  in  C: 

void  v_bit_image  (WORD  handle,  const  char  ^filename,  WORD  aspect, 
WORD  x_scale,  WORD  y_scale,  WORD  h_align, 

WORD  v_align,  WORD  *xyarray) 

{ 

WORD  tmp; 

pioff  =  xyarray; 
intin [0]  =  aspect; 
intin [1]  =  x_scale; 
intin [2]  =  y_scale; 
intin [3]  =  h_align; 
intin [4]  -  v_align; 
tmp  =  4; 

while  (intin [tmp++]  -  *filename++) ; 

contrl[0]  =  5; 

contrl [ 1 ]  =2; 

contrl[3]  =  -tmp; 

contrl [5]  =  23; 

contrl [6]  =  handle; 

vdi  ( ) ; 

pioff  =  ptsin; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fUr  ESCAPE 

contrl+2 

contrl  [1] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

n+5 

#  Eintrage  in  intin 

contrI+8 

contrl[4] 

0 

#  Eintrage  in  intout 
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Adresse  Feldelement  Belegung 

contrl+10  contrl[5]  23  V_BH_IMAGE 

contrl+12  contrl[6]  handle  Geratekennung 

intin  intin[0]  aspect 

intin+2  intinfl]  x_scale 

intin+4  intin[2]  y_scale 

intin+6  intin[3]  h_align 

intin+8  intin  [4]  v_align 

intin+10  intin[5..n+4]  filename[0..n~l] 

ptsin  ptsin[0..3]  xyarray[0..3] 

Parameter: 

aspect:  Aspect  Ratio  (AbbildungsmaBstab) 

0;  Aspect  Ratio  wird  ignoriert 

1 :  Pixel  werden  beriicksichtigt  (z.B .  werden  Kreise  wieder  auf  Kreise  ab- 

gebildet) 

x_scale:  Skalierung  der  X-Achse  (0:  gebrochen  (exakter),  1:  ganzzahlig) 

y„scale:  Skalierung  der  Y-Achse  (0:  gebrochen  (exakter),  1:  ganzzahlig) 

h_align:  horizontale  Ausrichtung  (0:  links,  1:  zentriert,  2:  rechts) 

v_align:  vertikale  Ausrichtung  (0:  oben,  1 :  zentriert,  2:  unten) 

xyarray[0]:  ggf.  X-Koordinate  der  oberen  linken  Ecke  des  Ausgaberechteckes 

xyarray[l]:  ggf.  Y-Koordinate  der  oberen  linken  Ecke  des  Ausgaberechteckes 

xyarray[2]:  ggf.  X-Koordinate  der  unteren  rechten  Ecke  des  Ausgaberechteckes 

xyarray[3]:  ggf.  Y-Koordinate  der  unteren  rechten  Ecke  des  Ausgaberechteckes 
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INQUIRE  PRINTER  SCAN  (VDI 5,  Escape  24)  (Drucker) 

Erlaubt  die  Abfrage  verschiedener  druckerspezifischer  Parameter. 


Deklaration  in  C: 

void  vq_scan  (WORD  handle,  WORD  *g_slice,  WORD  *g_page, 

WORD  *a_slice,  WORD  *a_page,  WORD  *div_fac) 

{ 

contrl[0]  =  5; 

contrl [1]  =  contrl [3]  =  0; 

contrl[5]  =  24; 

contrl[6]  =  handle; 

vdi  ( )  ; 

*g_slice  =  intout [0]; 

*g_page  =  intout [1] ; 

*a_slice  =  intout [2]; 

*a_page  =  intout [3]; 

*div_fac  =  intout [4]; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5  Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0  #  Eintriige  in  ptsin 

contrl+4 

contrl  [2] 

0  #  Eintragc  in  ptsout 

contrl+6 

contrl[3] 

0  #  Eintrage  in  intin 

contrl+8 

contrl  [4] 

5  #  Eintrage  in  intout 

contrl+10 

contrl[5] 

24  VQ_SCAN 

contrl+12 

contrl[6] 

handle  Geratekennung 

intout 

intout[0] 

g_slice 

intout+2 

intout[l] 

g-Page 

intout+4 

intout[2] 

a_slice 

intout+6 

intout[3] 

a_page 

intout+8 

intout[4] 

div_fac 

VDI-Betriebssystemroutinen 
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Parameter: 

g_slice:  Der  Druckertreiber  unterteilt  die  Druckseite  in  mehrere  “Scheiben”  (engl.: 

slices) ,  die  nacheinander  formatiert  und  gedruckt  werden,  um  den  Speicheiplatz- 
bedarf  zu  senken.  “g_slice”  ist  die  Anzahl  dieser  Scheiben. 
g_page:  Pixelhohe  einer  Scheibe 

slice:  Hohe  einer  Textzeile  in  Pixeln 

a.. page:  Textzeilen  pro  Seite 

div_fac:  Durch  diesen  Faktor  miissen  die  anderen  Werte  ggf.  noch  geteilt  werden. 
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OUTPUT  ALPHA  TEXT  (VDI 5,  Escape  25)  (Drucker,  Metafile) 


Erlaubt  die  Ausgabe  einfachen  Textes  (nicht  im  Grafikmodus)  an  der  aktuellen  Position  des 
Druckkopfes.  Grundlegende  Steuerfunktionen  sind  fur  alie  Druckertypen  genormt. 

Deklaration  in  C: 

void  v_alpha_text  (WORD  handle,  const  char  * string) 

{ 

WORD  *tmp; 
tmp  =  int  inf- 

while  (*trrp++  =  *string++)  ; 
contrl[0]  =  5; 
contrl[l]  =  0; 

contrl (3]  =  ( (int) (tmp-intin) -1) ; 
contrl[5]  =  25; 
contrl [6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

5 

Opcode  fur  ESCAPE 

contrl+2 

control] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

n 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

5 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

25 

V_ALPHA_TEXT 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0..n-l] 

string[0.,n-l] 

Parameter: 

string:  auszugebender  Text.  Dabei  sind  folgende  Steuerzeichen  genormt: 
DC2  0:  Fett  an 

DC2  1 :  Fett  aus 

DC2  2:  Italic  an  (Schragschrift) 
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DC2  3:  Italic  aus 

DC2  4:  Unterstrichen  an 

DC2  5:  Unterstrichen  aus 

DC2  6:  Superscript  an 

DC2  7:  Superscript  aus 

DC2  8:  Subscript  an 

DC2  9:  Subscript  aus 

DC2  A:  Briefqualitat-Modus  an  (LQ,  NLQ) 

DC2  B:  Briefqualitat-Modus  aus 

DC2  C:  Breitschrift  an 

DC2  D:  Breitschrift  aus 

DC2  E:  Helle  Schrift  an 

DC2  F:  Helle  Schrift  aus 

DC2  G  bis 

DC2  V:  reserviert,  werden  vom  Treiber  ignoriert 

DC2  W:  Pica-Schrift  (10  cpi) 

DC2X:  Elite-Schrift  (12  cpi) 

DC2  Y :  komprimierter  Druck 

DC2  Z:  Proportionalschrift 

Femer  wird  der  Formfeed  (Seitenvorschub)  mit  dem  ASCII-Wert  12  unterstutzt.  Der  String 

ist  bei  C-Binding  nullterminiert. 

Bemerkungen 

Bei  “DC2”  handelt  es  sich  um  den  ASCII-Wert  18. 

Das  OUT-Dateiformat  (das  von  “OUTPUT”  fur  PC-GEM  gelesen  wird)  benutzt  zusatzlich  zu 

den  genannten  Control-Sequenzen  das  Kommando 

(ESC) (ESC) GEM, x, y, w,h, D : \PATHNAME\FILENAME . EXT 


um  Grafiken  in  den  Ausdruck  einzubinden.  Bei  ESC  handelt  es  sich  um  den  ASCII-Wert  27. 
x,  y,  w  und  h  sind  in  Zeicheneinheiten  relativ  zur  aktuellen  Cursorposition  anzugeben. 
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SELECT  PALETTE  (VDI 5,  Escape  60)  (IBM-CGA) 


Diese  Funktion  ermdglicht  die  Auswahl  der  Farbpalette  auf  einer  IBM-CGA-Grafikkarte  in 
mittlerer  Auflosung. 


Deklaration  in  C: 

WORD  vs_jsalette  (WORD  handle,  WORD  palette) 
{ 

contrl[0]  =5; 
contrl[l]  =  0; 
contrl [3]  =  1; 
contrl[5]  -  60; 
contrl[6]  =  handle; 
intin [0]  =  palette; 
vdi  ( ) ; 

return  intout [0] ; 


GEM-Arrays: 


Adresse 

Feldeiement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

1 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

60 

VS_P  ALETTE 

eontrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

in  tin  [0] 

palette 

intout 

intout[0] 

Retum-Wert 

Parameter; 

palette:  Farbpalettenwahl  (0:  Rot,  Griin,  Braun  (default);  1:  Cyan,  Magenta,  WeiB) 

vs_palette():  ausgewahlte  Palette 

Bemerkungett 

Vermutlich  die  iiberfliissigste  Funktionsbeschreibung  des  Profibuchs. 


VDI-Betriebssystemroutinen 


511 


GENERATE  SPECIFIED  TONE 

(VDI 5,  Escape  61)  (Bildschirm)  -  nur  in  PC-GEM  ab  Version  2.0 


Erzeugt  einen  Ton  rait  der  angegebenen  Lange  und  Tonhohe. 


Deklaration  in  C: 

void  v_sound  (WORD  handle,  WORD  frequency,  WORD  duration) 
{ 

contrl[0]  =  5; 
contrl[l]  =  0; 
contrl[3]  =  2; 
contrl[5]  =  61; 
contrl[6]  -  handle; 
intin [0]  ~  frequency; 
intin [1]  =  duration; 
vdi  ( ) ; 

} 


GEM-Arrays: 


Adresse 

Feldeiement 

Belegung 

contrt 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contri+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10  | 

contrl[5] 

61 

V_SOUND 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin  [0] 

frequency 

intin+2 

intin[l] 

duration 

Parameter: 

frequency:  Tonhohe  in  Hertz 

duration:  Dauer  in  Timer-Ticks 

Bemerkungen 

Im  ROM-Bildschirmtreiber  nicht  implementiert. 
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SET/CLEAR  TONE  MUTING  FLAG  (VDI  5,  Escape  62) 
(Bildschirm)  -  hur  in  PC-GEM  ab  Version  2.0 


Setzt  oder  loscht  das  Tonflag  oder  liefert  dessen  Status  zuriick. 

Deklaration  in  C: 

WORD  vsjnute  (WORD  handle,  WORD  action) 

{ 

contrl[0]  =  5; 
contrl [1]  =  0; 
contrlf3]  =1; 
contrl[5]  =  62; 
contrl[6]  =  handle; 
intin [0]  =  action; 
vdi  (); 

return  intout [0] ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[I] 

0 

#  Eintrage  in  ptsin 

contrI+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

62 

VS_MUTE 

contrl+12 

contrl[6] 

handle  Geratekennung 

intin 

intin[0] 

|  action 

intout 

intout[0] 

Retum-Wert 

Parameter: 

action:  MUTE_RBTURN  (-1):  Status  abfragen 

MUTE_ENABLE  (0):  Tonerzeugung  ein 

MUTE_DISABLE  (I):  Tonerzeugung  aus 

vs_mute():  Tonerzeugung  an  (0)  oder  aus  (ungleich  0) 

Bemerkungen 

Im  ROM-Bildschirmtreiber  nicht  implementiert. 
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SET  TABLET  AXIS  RESOLUTION  IN  LINES/INCH 
(VDI 5,  Escape  81)  (Grafik-Tablett) 


Setzt  horizontale  und  vertikale  Auflosung  des  Grafiktabletts. 


Deklaration  in  C: 

void  vt_resolution  (WORD  handle,  WORD  xres,  WORD  yres, 
WORD  *xset,  WORD  *yset) 

{ 

contrl [0]  =  5; 
contrl [1]  =  0; 
contrl[3]  =  2; 
contrl[5]  =  81; 
contrl[6]  =  handle; 
intin [0]  =  xres; 
intin  [1]  =  yres; 
vdi  ( ) ; 

*xset  =  intout [0]; 

*yset  =  intout  [  1 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

2 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

81 

VT_RESOLUTION 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intinfO] 

xres 

intin+2 

intinfl] 

yres 

intout 

intoutfO] 

xset 

intout+2 

intoutfl] 

yset 

Parameter: 

xres,  yres:  Auflosung  in  Zeilen  pro  Zoll  (lpi) 
xset,  yset:  gesetzte  Auflosung 
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SET  TABLET  AXIS  RESOLUTION  IN  LINES 
(VDI 5,  Escape  82)  (Grafik-Tablett) 


Setzt  horizontale  und  vertikale  Auflosung  des  Grafiktabletts. 

Deklaration  in  C: 

void  vt_axis  (WORD  handle,  WORD  xres,  WORD  yres,  WORD  *xset, 
WORD  *yset) 

{ 

contrl[0]  =  5; 
contrl [1]  -  0; 
contrl[3]  =  2; 
contrl[5]  =  82; 
cont  r 1 [ 6 ]  =  handle ; 
intin [0]  =  xres; 
intin [1]  =  yres; 
vdi  ( ) ; 

*xset  =  intout [0]; 

*yset  =  intout [ 1 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl[0] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrlf2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

2 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

82 

VT_AXIS 

COntrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intinfO] 

xres 

intin+2 

intinf  1  ] 

yres 

intout 

intoutfO] 

xset 

intout+2 

intoutfl] 

yset 

Parameter: 

xres,  yres:  Auflosung  in  Zeilen 
xset,  yset:  gesetzte  Auflosung 
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SET  TABLET  X  AND  Y  ORIGIN 
(VDI 5,  Escape  83)  (Grafik-Tablett) 


Setzt  den  Ursprung  des  Koordinatensystems. 


Deklaration  in  C: 

void  vt_origin  (WORD  handle,  WORD  xorigin,  WORD  yorigin) 


contrl[0]  =  5; 
contrl [1]  =  0; 
contrl[3]  =  2; 
contrl[5]  =  83; 
contrl[6]  =  handle; 
intin [0]  =  xorigin; 
intin [ 1 ]  =  yorigin ; 
vdi  ( ) ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

2 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

83 

VT_ORIGIN 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin  [0] 

xorigin 

intin+2 

intin[l] 

yorigin 

Parameter: 

xorigin:  X-Koordinate  der  linken  oberen  Ecke 

yorigin:  Y-Koordinate  der  linken  oberen  Ecke 
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(VDI 5,  Escape  84)  (Grafik-Tablett) 


Liefert  die  AusmaBe  des  Grafiktabletts  in  I/10-ZoII. 


Deklaration  in  C: 

void  vq_t dimens ions  (WORD  handle,  WORD  * xdimension, 

WORD  *ydimension) 

{ 

contrl [0]  =  5; 

contrl [1]  =  contrl[3]  =  0; 

contrl[5]  =  84; 

contrl[6]  =  handle; 

vdi  (); 

*xdimension  =  intin [0 ]; 

*ydimension  =  intin [1] ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [01 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

2 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

84 

VQJTDIMENSIONS 

contrl+12 

contrl[6] 

handle  Geratekennung 

intout 

intoutfO] 

xdimension 

intout+2 

intoutfl] 

ydimension 

Parameter: 

xdimension:  Breite  in  1/10  Zoll 
ydimension:  Hohe  in  1/10  Zoll 
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SET  TABLET  ALIGNMENT  (VDI 5,  Escape  85)  (Grafik-Tablett) 


Dient  der  Ausrichtung  des  Koordinatensy  stems  innerhalb  ernes  Ausschnitts  des  Grafiktabletts. 


Deklaration  in  C: 

void  vt_alignment  (WORD  handle,  WORD  dx,  WORD  dy) 
{ 

contrl[0]  =  5; 
contrl[l]  =  0; 
contrl[3]  =  2; 
contrl [5]  =  85; 
contrl [6]  =  handle; 
intin [0]  =  dx; 
intin [1]  =  dy; 
vdi  (); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPI 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrdge  in  intout 

contrl+10 

contrl  [5] 

85 

VT_ALIGNMENT 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0] 

dx 

intin+2 

intin[l] 

dy 

Parameter: 

dx,  dy:  Offset  in  X-  und  Y-Koordinate  vom  Ursprung, 
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SET  CAMERA  FILM  TYPE  AND  EXPOSURE  TIME 
(VDI 5,  Escape  91)  (Polaroid  Palette) 


Legt  Filmtyp  und  Belichtungszeit  fest. 

Deklaration  in  C: 

void  vsp^film  (WORD  handle,  WORD  index,  WORD  lightness) 

{ 

contrl[0]  =  5; 
contrl [1]  =  0; 
contrl[3]  =  2; 
contrl[5]  =  91; 
contrl[6]  =  handle; 
int in [ 0 ]  =  index ; 
intin [1]  =  lightness; 
vdi  ( ) ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

91 

VSP_F1LM 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin+2 

intin  [0] 
intin[l] 

index 

lightness 

Parameter: 

index:  Nummer  des  Filmtyps  (siehe  “vqp_filmname()”) 

lightness:  Belichtungszeit  von  -3  bis  3  (-3:  halbe,  0:  normal,  3:  doppelte);  mit  jeder 

ganzen  Zahl  mehr  wird  die  Blendenzahl  um  ein  Drittel  erhoht. 
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INQUIRE  CAMERA  FILM  NAME 
(VDI 5,  Escape  92)  (Polaroid  Palette) 


Liefert  zu  einer  Filmnummer  den  entsprectienden  Namen  (maximal  24  Zeichen).  Bei  einer 
falschen  Filmnummer  erhalt  man  einen  Nullstring  als  Ergebnis. 


Deklaration  in  C: 

WORD  vqp_filmname  (WORD  handle,  WORD  index,  char  *name) 
{ 

WORD  tmp; 
contrl [0]  =  5; 
contrl[l]  =  0; 
contrl[3J  =  1; 
contrl[5]  =  92; 
contrl[6]  =  handle; 
intin [0J  =  index; 
vdi  ( ) ; 

for  (tmp=0;  tmp<contrl  [4 ] ;  tmp++) 
name [tmp]  =  intout [tmp] ; 
return  contrl [ 4 ] ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  ftir  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl(4] 

status 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

92 

VQP_FILMNAME 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

index 

intout 

intout[0.,24] 

name[0..24] 

Parameter: 

index:  Nummer  des  Filmtyps 

name:  Name  des  Films  (nullterminiert) 

vqp_filmname():  0:  falsche  Nummer  iibergeben 
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DISABLE  OR  ENABLE  FILM  EXPOSURE  FOR  FRAME 
I  PREVIEW  (VDI 5,  Escape  93)  (Polaroid  Palette) 


Bei  Kameratypen  mit  Preview-Moglicbkeit  kann  man  mit  dieser  Funktion  die  Belichtung 
abschalten. 


Deklaration  in  C: 


void  vsc_expose  (WORD  handle, 
{ 


intin [0]  = 

=  state; 

contrl [0] 

=  5; 

contrl [1] 

=  0; 

contrl [3] 

-  1; 

contrl [5] 

=  93; 

contrl [6] 

=  handle; 

vdi  (); 

WORD  state) 


) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrlfl] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

93 

VSC_EXPOSE 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

state 

Parameter: 

state:  0:  Belichtung  abschalten 

sonst:  Belichtung  einschalten 
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UPDATE  METAFILE  EXTENTS  (VDI  5,  Escape  98)  (Metafiles) 


Mit  dieser  Funktion  werden  die  GroBen-Informationen  im  Metafile-Kopf  emeuert. 

Die  GroBen-Information  kann  man  benutzen,  um  schnell  die  minimalen  oder  maximalen 
AusmaBe  aller  im  Metafile  abgespeicherten  Primitiven  zu  ermitteln. 

Deklaration  in  C; 

void  v_meta_extents  (WORD  handle,  WORD  min_x,  WORD  min_y, 

WORD  max_x,  WORD  max_y) 
t 

ptsin [0]  =  rain_x; 
ptsin [1]  =  min_y; 
ptsin[2]  =  max_x; 
ptsin[3]  =  max_y; 
contrl[0]  =  5; 
contrl [1]  =  2; 
contrl[3]  =  0; 
contrl[5]  =  98; 
contrl[6]  =  handle; 
vdi  ( )  ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrlfl] 

2 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl  [5] 

98 

V ...MET A  .EXTENTS 

contrl+12 

contrl[6] 

handle 

Geratekennung 

ptsin 

ptsin  [0] 

min_x 

ptsin+2 

ptsin[l] 

min_y 

ptsin+4 

ptsin  [2] 

max_x 

ptsin+6 

ptsin[3] 

max_y 
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Parameter: 

min . x:  minimaler  X-Wert  des  minimalen  umgebenden  Rechteckes 

min_y:  minimaler  Y-Wert  des  minimalen  umgebenden  Rechteckes 

max_x:  maximaler  X-Wert  des  minimalen  umgebenden  Rechteckes 
max_y:  maximaler  Y-Wert  des  minimalen  umgebenden  Rechteckes 
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WRITE  METAFILE  ITEM  (VDI 5,  Escape  99)  (Metafiles) 


Die  mit  dieser  Funktion  in  ein  Metafile  geschriebenen  Parameter  werden  mit  einem  Opcode 
als  benutzerdefinierte  Gegenstande  abgespeichert.  Intin[0]  enthalt  einen  benutzerdefinierten 
Sub-Opcode, 

Die  Nummem  0  bis  100  sind  reserviert,  als  Sub-Opcode  kommen  also  Nummem  ab  101  in 
Frage. 

Diese  Funktion  wird  beispielsweise  von  “GEM  Draw”  (Digital  Research)  benutzt,  um  zu 
Gruppen  zusammengefafite  Objekte  zu  markieren. 

Deklaration  in  C: 

void  v_write_meta  (WORD  handle,  WORD  num_intin,  WORD  *a_intin, 

WORD  *num_ptsin,  WORD  *a_ptsin) 

{ 

iioff  =  a_intin; 
pioff  =  a_ptsin; 
contrl[0]  -5; 
contrl[l]  =  num_ptsin; 
contrl[3]  =  num_intin; 
contrl[5]  =  99; 
contrl[6]  =  handle; 
vdi  ( ) ; 

iioff  =  intin; 
pioff  =  ptsin; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0J 

5 

Opcode  fur  ESCAPE 

contrl+2 

control] 

num_ptsin 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

num_intin 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

99 

VJWRITE_META 

contrl+12 

contrl  [6] 

handle 

Ger&tekennung 
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Parameter: 


nurnjntin: 
num_ptsin: 
int_in[0]: 
intinf  1]  bis 
intintnum_intin-l  ] : 
ptsinfO]  bis 
ptsin[num_ptsin- 1  ] : 


Anzahl  der  Werte  im  Intin-Array 
Anzahl  der  Werte  im  Ptsin- Array 
benutzerdefinierter  Sub-Opcode 

benutzerdefmierte  Information 

benutzerdefinierte  Information 


Bemerkungen 

Von  “GEM  Draw”  benutzte  Opcodes: 


START  GROUP  (10) 

END  GROUP  (11) 

SET  NO  LINE  STYLE  (49) 

SET  ATTRIBUTE  SHADOW  ON  (50) 


Beginn  einer  Gruppe 

Ende  einer  Gruppe 

Jeglichen  Linienstil  ausschalten 

Alle  bis  “SHADOW  OFF”  folgenden  Befehle 

werden  benutzt,  urn  fiir  das  erste  Objekt  danaeh 

einen  Schatten  zu  zeichnen. 


SET  ATTRIBUTE  SHADOW  OFF  (51 )  Siehe  oben 
START  DRAW  AREA  PRIMITIVE  (80)  Beginn  einer  Fullflache 
END  DRAW  AREA  PRIMITIVE  (81)  Siehe  oben 
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PHYSICAL  PAGE  SIZE  (VDI 5,  Escape  99,  Opcode  0)  (Metafiles) 


Setzt  die  SeitengroBe  in  1/10  mm. 

Deklaration  in  C: 

void  vmjpagesize  (WORD  handle,  WORD  pgwidth,  WORD  pgheight) 
{ 

contrl [0]  =  5; 
contrl[l]  =  intin [0J  =  0; 
contrl[3]  =  3; 
contrl[5]  =  99; 
contrl[6J  =  handle; 
intin [1]  =  pgwidth; 
intin [2]  =  pgheight; 
vdi  ( ) ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[  1] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

3 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

99 

V_WRITE_META 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin  [0] 

0 

VM_PAGESIZE 

intin+2 

intin[l] 

pgwidth 

intin+4 

intin[2] 

pgheight 

Parameter: 

pgwidth:  Breite  in  1/10  mm 

pgheight:  Lange  in  1/10  mm 
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COORDINATE  WINDOW  (VD1 5,  Escape  99,  Opcode  1)  (Metafiles) 


Setzt  das  benutzte  Koordinatensystem  fiir  die  Seite. 

Deklaration  in  C: 


void  vm_coords 
{ 

contrl [0] 
contrl [1] 
contrl [5] 
contrl  [6] 
intin [0]  ! 
intin [1]  = 
intin [2]  = 
intin [3]  : 
intin [4]  = 
vdi  ( ) ; 


(WORD  handle 
WORD  ury) 

=  contrl [3]  5 
=  0; 

=  99; 

=  handle; 

■  1; 

=  llx; 

=  iiy; 

-  urx; 

5  ury; 


WORD  llx,  WORD 

5; 


lly,  WORD  urx, 


} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrI+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

5 

#  Eintrdge  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

contrlt  10 

contrl[5] 

99 

VWRITEJVIETA 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0] 

1 

VM_COORDS 

intin+2 

intin[l] 

llx 

intin+4 

intin[2] 

lly 

intin+6 

intin[3] 

urx 

intin+8 

intin[4] 

ury 
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Parameter: 

llx:  X-Koordinaten  links  unten 

lly:  Y-Koordinaten  links  unten 

urx:  X-Koordinaten  rechts  oben 

ury:  Y-Koordinaten  rechts  oben 
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CHANGE  GEM  VDI  FILE  NAME  (VD1 5,  Escape  100)  (Metafiles) 


Diese  Funktion  benennt  ein  Metafile  von  “GEMFELE.GEM”  in  einen  anderen  Namen  unter 
Beibehaltung  der  Extension  “GEM”  um.  Ein  Pfadname  (mit  Laufwerksbezeichnung)  zur 
Auffindung  des  Files  kann  mit  angegeben  werden.  Sollte  “CHANGE  GEM  VDI  FILE 
NAME”  nicht  sofort  nach  Aufruf  der  Funktion  “OPEN  WORKSTATION”  (VDI  1)  benutzt 
werden,  so  bleibt  der  Aufruf  wirkungslos.  Eineventuell  geoffnetes  Metafile  wirdgeschlossen. 

Deklaration  in  C: 

void  vm_filename  (WORD  handle,  const  char  * filename) 

{ 

WORD  *tmp; 
tmp  =  intin; 

while  (*tmp++  =  *filename++) ; 
contrl[0]  =  5; 
contrl [1]  =  0; 

contrl[3]  =  ( (int)  (tmp- intin) -1) ; 
contrl[5]  =  100; 
contrl[6]  =  handle; 
vdi  () ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl  [0] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

eontrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

n 

#  Eintrage  in  intin 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  intout 

eontrl+10 

contrl[5] 

100 

VMJFILENAME 

contrl+12 

contrl[6] 

handle 

Geratekennung 

intin 

intin[0..n-l] 

filename[0..n-l] 

Parameter: 


n:  Lange  des  Intin- Arrays  (1  bis  74) 

filename:  Dateispezifikation  des  Metafiles  (muB  mit  dem  ASCII- Wert  0  enden). 
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SET  LINE  OFFSET  (VDI 5,  Escape  101)  (ROM-BHdschirmtreibfer) 


Setzt  den  Offset  in  Rasterzeilen  zum  Beginn  des  logischen  Bildschirms  (normalerweise  0). 
Diese  Funktion  ist  in  keiner  offiziellen  Dokumentation  beschrieben  -  Benutzung  auf  eigene 
Gefahr! 


Deklaration  in  C: 


void  v_offset  (WORD  handle,  WORD  offset) 
{ 


intin[0]  =  offset; 
contrl[0]  =  5; 
contrl [1]  =  0; 
contrl[3]  =  1; 
contrl[5]  =  101; 
contrl[6]  =  handle; 
vdi  <); 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl[2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

101 

V_OFFSET 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0] 

offset 

Parameter: 

offset:  Anzahl  der  Rasterzeilen  unterhalb  der  oberen  Bildschirmkante,  von  der  ab  der 
logische  Bildschirm  beginnen  soli. 
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INIT  SYSTEM  FONT  (VDI 5,  Escape  102)  (ROM-BUdschirmtreiber) 


Diese  Routine  installiert  den  angegebenen  Zeichensatz  als  Systemzeichensatz.  Eigene 
Versuche  ergaben,  daB  die  Zeichenbreite  konstant  acht  Pixel  betragen  und  der  Zeichensatz  im 
Motorola-Format  vorliegen  muB  (siehe  Font-Header)!  Diese  Funktion  ist  nirgendwo  offiziell 
dokumentiert  -  daher  Verwendung  auf  eigene  Gefahr! 


Deklaration  in  C: 

void  v_fontinit  (WORD  handle,  WORD  fh_high,  WORD  fh_low) 

{ 

intin  [0]  =  fhjiigh; 
intin [1]  =  fh_low; 
contrl [0]  =  5; 
contrl [1]  =  0; 
contrl[3]  =  2; 
contrl[5]  =  102; 
contrl[6]  =  handle; 
vdi  ( ) ; 

} 


GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

5 

Opcode  fur  ESCAPE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

102 

V_FONTINIT 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin[0/l] 

font_hdr 

Parameter; 

font_hdr:  Zeiger  auf  den  Zeichensatzkopf. 
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ESCAPE  2000  (VDI 5,  Escape  2000)  (Atari  SLM-Laser-Drucker) 

Diese  Spezialfunktion  fiir  die  Atari-SLM-Laserdrucker  druckt  beliebig  viele  Kopien  der 
laufenden  Seite. 

Deklaration  in  C: 

void  v_escape2000  (WORD  handle,  WORD  times) 

{ 

intin [0]  =  times; 
contrl [0]  =5; 
contrl[l]  =  0; 
contrl [3]  =  1; 
eontrl[5]  =  2000; 
contrl[6]  =  handle ; 
vdi  ( > ; 

} 


GEM-Arrays: 

Adresse  |  Feldelement  j 

Belegung 

contrl 

contrl[0] 

5 

Opcode  fiir  ESCAPE 

contrl+2 

control] 

0 

#  Eintrage  in  ptsin 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  ptsout 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  intin 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  intout 

contrl+10 

contrl[5] 

2000 

V_ESCAPE2000 

contrl+12 

contrl  [6] 

handle 

Geratekennung 

intin 

intin  [0] 

times 

Parameter: 

times:  Anzahl  der  zusatzlich  zu  druckenden  Kopien 
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Kapitel  4:  AES-Betriebssystemroutinen 

Einleitung 

Die  AES  (“Application Environment  Services”)  sind  die  obere  Schicht  des  GEM,  Sie  befassen 
sich  mit  all  jenen  GEM-Bestandteilen,  die  iiber  elementare  Grafikausgaben  (und  -eingaben) 
hinausgehen.  Es  werden  ausschlieBlich  VDI-  und  GEMDOS-Aufrufe  benutzt,  und  so  sind  die 
AES  sowohl  von  Grafikhardware  (VDI),  vom  Eingabegerat  (VDI)  als  auch  vom  Dateisystem 
(GEMDOS)  unabhangig.  Die  Entwicklung  der  AES  reicht  in  das  Jahr  1 984  zuriick,  als  es  von 
Digital  Research  zunachst  fiir  MS-DOS-Rechner  entwickelt  wurde  und  spater  auf  die  Apple 
Lisa  (unter  CP/M  68K)  portiert  wurde.  Diese  Version  wurde  dann  anschlicfiend  auf  den  Atari 
ST  (unter  GEMDOS)  portiert. 


Die  verschiedenen  GEM-Versionen 

GEM*  V  ersionsnummern 

Als  GEM-Versionsnummer  wird  normalerweise  diebei  “appLinit()”  vom  AES  (im  “Global”- 
Feld)  zuruckgelieferte  Kennung  benutzt.  Das  VDI  hingegen  hat  eigentlich  keine  eigene 
Versionsnummer,  zumal  das  Verhalten  der  einzelnen  VDI-Funktionen  hauptsachlich  von  den 
benutzten  Geratetreibem  (die  ja  weitestgehend  austauschbar  sind)  bestimmt  wird. 


GEM  1.x 

Diese  erste  AES-Version  ( 1  .x)  hatte  nicht  von  ungefahr  sehr  auffallige  Ahnlichkeiten  mit  dem 
Betriebssystem  des  Apple  Macintosh.  Das  auBerte  sich  nicht  nur  im  Design  der  Fensterele- 
mente,  sondem  auch  in  vielen  Eigenschaften  des  Desktops  und  anderer  Anwendungspro- 
gramme.  Damals  wurde  GEM  meist  im  Zusammenhang  mit  Testversionen  von  “GEM- 
Draw”,  “GEM-Paint”  und  “GEM-Write”  gezeigt,  die  in  vielen  Details  den  bekannten  Mac- 
Vorbildem  “MacDraw”,  “MacPaint”  und  “MacWrite”  entsprachen. 

Dies  ist  auch  die  GEM-Version,  die  schlieBlich  von  Atari  iibemommen  und  im  ST  ausgeliefert 
wurde.  Nicht  ganz  fertige  Testversionen  der  “Vorbildprogramme”  werden  noch  bis  heute 
benutzt.  Auf  dieser  Fassung  beruhen  auch  alle  neueren  Atari-GEM-Versionen.  Atari  hat 
damals  namlich  alle  Rechte  an  der  bestehenden  Version  erworben  und  die  Entwicklung  selbst 
fortgefiihrt.  Damit  lassen  sich  auch  die  immer  weiter  “klaffenden”  Unterschiede  zwischen 
Atari-GEM  und  PC-GEM  erklaren. 
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GEM  2.x 

Wie  man  sich  denken  kann  (“nachher  ist  man  immer  schlauer”)  kam  es  zu  einer  juristischen 
Auseinandersetzung  zwischen  Apple  und  Digital  Research,  beider  es  allerdings  in  ersterLinie 
um  das  Outfit  der  Anwendungsprogramme  und  des  Desktops  ging. 

Die  Einigung,  die  Ataris  GEM-Version  nicht  betraf,  sah  folgendermaBen  aus: 

Einige  Fensterelemente  wurden  so  verandert,  daB  sie  nicht  mehr  ganz  so  wie  Mac- 
Fenster  aussahen  (in  erster  Linie  der  Titelbalken). 

-  Das  Accessory-Menu  wanderte  in  die  gegeniiberliegende  Bildschirmecke. 

-  Die  sogenannten  “Grow-”  und  “Shrink-Boxes”  wurden  eliminiert. 

-  Das  Desktop  wurde  vollig  neu  programmiert  und  auf  zwei  feste  Fenster  festgelegt. 
Entgegen  landlaufiger  Meinung  war  das  allerdings  nur  eine  Anderung  im  Desktop,  nicht 
in  den  AES  (die  weiterhin  bis  zu  acht  iiberlappende  Fenster  erlauben). 

Doch  es  gab  nicht  nur  Einschrankungen,  sondern  auch  Verbesserungen.  Als  wichtiges  Beispiel 
sei  nur  erwahnt,  daB  Accessories  eigene  Meniileisten  anmelden  diirfen. 

Diese  Version  erhielt  die  Versionsnummer  2.0  und  wird  seit  1987  ausgeliefert.  Nur  wenig 
spater  wurde  sie  von  dem  niederlandischen  Softwarehaus  “ABC”  zusammen  mit  “GEM- 
Draw”,  “GEM-Paint”,  “GEM-Graph”  und  natiirlich  “GEM-Desktop”  auf  den  Atari  portiert. 
Leider  erlangte  diese  Version  nie  groBe  Bedeutung  und  ist  heute  nicht  mehr  erhaltlich. 

Alle  fiir  GEM  2.x  spezifischen  Informationen  sind  im  folgenden  mit  einem  Zusatz  wie  “nur 
in  PC-GEM  ab  Version  2.0”  versehen. 


PC-GEM  3.x 

In  dieser  Version  sind  nur  noch  geringfiigige  Verbesserungen  vorgenommen  worden  (das 
Meniiverhalten  laBt  sich  von  “Drop-Down”  auf  “Pull-Down”  umschalten). 

Mittierweile  wird  PC-GEM  nicht  mehr  von  Digital  Research  selbst  weiterentwickelt,  und  so 
sind  angesichts  der  Dominanz  von  Microsoft  Windows  im  PC-Bereich  wohl  keine  groBeren 
Neuerungen  mehr  zu  erwarten.  Teile  von  GEM  und  Desktop  sind  allerdings  in  die  grafische 
Benutzeroberflache  “ViewMax”  eingeflossen,  die  von  Digital  Research  als  Zubehor  zu  “DR- 
DOS  5.0”  fiir  PCs  ausgeliefert  wird. 
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Atari-GEM  1.4 

Wichtige  Anderungen  hat  Atari  erst  im  GEM  1.4  im  TOS  1.04  vorgenommen.  Bekannteste 
Auswirkung  ist  die  stark  verbesserte  Dateiauswahlbox. 


Atari-GEM  3.x 

Die  Erweiterungenim  Atari-GEM  3  .x  (verstellbareFarben  und  Muster  fiir  die  Fensterelemente) 
hatten  diese  hohe  Versionsnummer  eigentlich  nicht  gerechtfertigt.  Offenbar  wollten  die 
Programmiererabsolut  klarmachen,  daB  Atari  nic/zfgewilltist,  weiter  zuPC-GEMkompatibel 
zu  bleiben  oder  gar  die  dort  vorgenommenen  Anderungen  nachzuvollziehen.  Eine  der  Veran- 
derungen  im  Atari-GEM  ist  bereits  jetzt  zum  PC-GEM  inkompatibel  (neue  Funktionsnummer 
bei  “wind_set()”). 


Kiinftige  Weiterentwicklungen 

Es  ist  immer  schwierig,  in  die  Zukunft  zu  schauen.  Doch  bereits  existierende  Weiterentwick- 
lungen  wie  X/GEM  (ein  erweitertes  GEM  fiir  DR’s  Multitasking-System  “Flex-OS”)  oder 
Multi-GEM  (ein  “Hack”  fiir  Atari-GEM  von  der  Maxon  GmbH)  zeigen  schon  jetzt,  daB  das 
Marschziel  dem  sehr  nahe  kommen  wird,  was  Mac-Benutzer  als  den  “Multi-Finder”  kennen: 
AES,  die  mehr  als  ein  Hauptprogramm  gleichzeitig  ausfiihren  konnen.  Auch  Ataris  eigene 
Plane  gehen  sicherlich  in  eben  diese  Richtung. 

Werneue  GEM-Programme  entwickelt,  sollte  diese  moglichen  Weiterentwicklungen  immer 
im  Kopf  haben! 


Die  AES  und  Multitasking 


Begriffserklarungen 

Die  aktuelle  Version  der  AES  erlaubt  die  gleichzeitige  Abarbeitung  von  bis  zu  acht  AES- 
Prozessen.  Das  klingt  vielleicht  zunachst  etwas  verbliiffend,  daher  erst  einmal  ein  paar 
Begriffserklarungen: 

Auf  einem  Rechner  mit  nur  einer  CPU  konnen  natiirlich  niemals  mehrere  Programme  wirklich 
gleichzeitig  ausgefiihrt  werden.  Die  Rechenzeit  muG  also  moglichst  geschickt  auf  die  ver- 
schiedenen  Aufgaben  verteilt  werden. 
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Bei  “pre-emptivem”  Multitasking  wird  jedem  ProzeB  ein  bestimmtes  Quantum  Zeit  zugestan- 
den.  Nach  Ablauf  dieser  Frist  wird  dann  automatisch  auf  den  niichsten  ProzeB  weitergeschal  tet. 
Dabei  sind  natiirlich  noch  etliche  Verfeinerungen  wie  unterschiedliehe  Prioritaten  oder  das 
“Blocken”  von  Funktionen  (so  konnte  beispielsweise  ein  ProzeB  so  lange  blockiert  bleiben, 
bis  ein  Tastendruck  gemeldet  wird)  moglich.  Dieses  Multitasking-Konzept  wird  zum  Beispiel 
in  alien  Unix-Versionen  und  verwandten  Betriebssystemen  benutzt. 

Beim  “kooperativen”  Multitasking  wird  ein  etwas  anderer  Weg  gegangen:  Jeder  ProzeB  erhalt 
quasi  die  voile  Kontrolle  iiber  das  Rechnersystem,  die  er  dann  irgendwann  freiwillig  wieder 
abgibt.  Damit  ist  auch  schon  der  Hauptnachteil  klar:  Ein  fehlerhaftes  Programm  kann  das 
gesamte  System  zum  Erliegen  bringen.  Andererseits  wird  moglichst  wenig  Zeit  mit  uberfliis- 
sigen  ProzeBwechseln  verbracht. 

Ein  weiteres  wichtiges  Stichwort  heiBt  “Ereignisorientierung”.  In  ereignisorientierten  Syste- 
men  teilen  die  einzelnen  Prozesse  dem  Betriebssystem  mit,  auf  welche  Art  von  Ereignissen 
(wie  dem  Verstreichen  einer  Zeitspanne  oder  eine  Tastatureingabe)  sie  warten.  Mit  Hilfe  die¬ 
ser  Information  kann  das  Betriebssystem  die  Prozessorzeit  sehr  effektiv  verteilen. 

Digital  Research  hat  fur  die  AES  ein  kooperatives,  ereignisorientiertes  Multitasking  ausge- 
wahlt.  Umschaltungen  zwischen  AES-Prozessen  finden  immer  nur  dann  start,  wenn  ein 
ProzeB  freiwillig  die  Kontrolle  abgibt,  sprich  einen  AES-Aufruf  tatigt.  Ansonsten  verbringen 
die  allermeisten  GEM-Programme  ihre  Zeit  mit  dem  Warten  auf  ein  Ereignis  -  ob  ein  Tasten¬ 
druck,  eine  Fenstermanipulation  oder  etwas  anderes. 

In  den  aktuellen  Versionen  des  Atari-GEM  konnen  insgesamt  acht  verschiedene  AES- 
Prozesse  gleichzeitig  ablaufen.  Einer  davon  ist  immer  das  “Haupiprogramm”,  und  sechs 
weitere  "Slots”  (also  Platzhalter  fur  Prozesse)  sind  fur  bis  zu  sechs  Accessories  reserviert.  Der 
achte  im  Bunde  ist  der  “Screen-Manager”,  der  fur  die  Fensterelemente  und  die  Drop-Do wn- 
Meniis  zustandig  ist. 


Der  Dispatcher 

Die  Verteilung  der  Prozessorzeit  wird  vom  Dispatcher  ubemommen.  Um  Uberblick  und 
Gerechtigkeit  zu  wahren,  legt  er  zwei  Listen  an,  in  denen  alle  Prozesse,  die  bereit  zum  Ablauf 
sind  (READY-LIST),  und  alle,  die  auf  ein  Ereignis  warten  (NOT-READY -LIST),  verzeichnet 
sind. 

Wie  geht  der  Dispatcher  nun  vor?  Zunachst  genehmigt  er  dem  ProzeB,  der  in  der  READY- 
Liste  ganz  vome  steht,  einen  “Durchgang”:  Das  heiBt,  er  wartet  darauf,  daB  dieser  ProzeB 
irgendwann  mal  wieder  einen  AES-Aufruf  tatigt.  Daher  sollte  man  es  sich  zur  Angewohnheit 
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machen,  in  Programmschleifen,  die  vollig  ohne  AES-Aufrufe  auskommen,  den  einen  Oder 
anderen  “evnt_timer()”-Aufruf  einzustreuen. 

1st  nun  wieder  der  Dispatcher  am  langeren  Hebei,  priift  er  zunachst,  ob  eines  der  Ereignisse, 
auf  das  die  Prozesse  in  der  NOT-READY-Liste  so  sehnsiichtig  warten,  eingetreten  ist.  In 
diesem  Fall  wird  der  betreffende  ProzeB  von  der  NOT-READY-Liste  an  das  Ende  der 
READY-Liste  gesetzt. 

Weiterhin  ist  zu  betrachten,  ob  nun  moglicherweise  der  zuletzt  aktive  ProzeB  auf  ein  Ereignis 
wartet.  In  einem  solchen  Fall  wird  er  an  das  Ende  der  NOT-READY-Liste  verbannt, 
andemfalls  wird  er  das  SchluBlicht  der  READY-Liste. 

In  den  aktuellen  Atari-AES  sind  sowohl  Anzahl  als  auch  Belegung  der  ProzeB-Slots  von 
Beginn  anfest.  Accessories  und  Screen-Manager  werden  nie  beendet,  und  das  Hauptprogramm 
wird  nach  Beendigung  sofort  durch  ein  anderes  (normalerweise  das  Desktop)  ersetzt.  In 
kiinftigen  AES-Versionen  wird  es  vermutlich  moglich  sein,  mehrere  Hauptprogramme 
gleichzeitig  zu  starten- Accessories  werden  dadurch  weitestgehend  ihre  Existenzberechtigung 
verlieren. 


Der  Screen  Manager 

Der  Screen  Manager  ist  immer  aktiv  und  uberwacht  die  Position  des  Mauszeigers,  wenn  dieser 
den  Arbeitsbereich  der  Fenster  anderer  Applikationen  verlaBt.  Die  hier  in  Frage  kommenden 
Flachen  sind  die  Rahmen  der  Fenster,  die  “Drop-Dowri’-Meniis  und  die  Meniileiste. 

Beim  Beruhren  des  Meniibereichs  sorgt  der  Screen  Manager  selbsttatig  dafiir,  daB  der  vom 
Menii  belegte  Bildschirmausschnitt  gesichert  und  anschlieBend  wiederhergestellt  wird  (dazu 
wird  der  sogenannte  “Quarter  Screen  Buffer”  benutzt,  auf  den  wir  spater  zuriickkommen). 

Auch  Manipulationen  an  den  Fensterkontrollen  fiihren  nicht  zu  dauerhaften  Veranderungen 
des  Bildspeichers  (es  werden  nur  jeweils  die  Umrisse  bewegt).  Resultat  der  Interaktionen  mit 
dem  Screen  Manager  sind  die  sogenannten  “Mitteilungsereignisse”,  die  die  zustandige  Appli- 
kation  iiber  die  Aktionen  des  Benutzers  informieren. 


Einschrankungen 

Obwohl  die  AES  viele  gute  Ansatze  enthalten,  machen  sich  doch  Herkunft  (PC  unter  MS- 
DOS)  und  Alter  (1984)  stark  bemerkbar.  Daher  auch  viele  Einschrankungen,  die  die  Praxis- 
tauglichkeit  des  Multitaskings  in  den  aktuellen  AES-Versionen  stark  einschranken. 
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Zunachst  einmal  muB  man  sich  der  traurigen  Wahrheit  stellen,  daB  das  GEMDOS  rein  gar 
nichts  vom  Multitasking  der  AES  weiB,  Hauptprogramm  und  alle  Accessories  miissen  sich  fiir 
alle  GEMDOS-Aufrufe  (Speicher,  Dateikennungen,  DTA  usw.)  den  gleichen  GEMDOS- 
ProzeB  teilen,  Dadurch  werden  viele  Projekte  erheblich  beschwert,  zumal  auch  das  VDI 
(Workstation  offnen,  Zeichensatze  laden)  und  viele  Standard-Bibliotheksfunktionen  (in  C 
haufig  die  Benutzung  der  Standard-I/O-Routinen)  Speicher  vom  GEMDOS  anfordern. 

Fiir  weitere  Kopfschmerzen  sorgt  ein  Problem,  das  erst  in  der  AES-Version  3.0  beseitigt 
wurde:  GEMDOS-Aufrufe  konnen  ja  bekanntlich  zur  Alarmbox  des  “Critical  Error  Handler” 
fiihren.  Wahrend  die  Alarmbox  auf  dem  Bildschirm  steht,  kann  es  zu  AES-ProzeBwechseln 
kommen.  Wenn  der  ans  Ruder  gekommenene  ProzeB  nun  wiederum  eine  GEMDOS-Funktion 
aufruft,  kommt  es  zu  einem  Absturz  (merke:  GEMDOS  ist  nicht  re-entrant  -  das  heiBt, 
GEMDOS -Funktionen  konnen  nicht  aus  GEMDOS -Funktionen  heraus  aufgerufen  werden). 

Diese  Situation  kann  beispielsweise  dann  eintreten,  wenn  in  einem  Accessory  ein  GEMDOS- 
Aufruf  auf  “evnt_timer()”  folgt  (Abhilfe:  GEMDOS-Aufrufe  mittels  der  Funktion 
“wind_update()”  klammem,  damit  ist  der  AES-ProzeB  so  lange  blockiert,  bis  die  Alarmbox 
wieder  verschwunden  ist). 

Der  Dispatcher  selbst  ist  auch  nur  eingeschrankt  fiir  die  Zukunft  geriistet.  So  sorgt  er  zwar  fiir 
die  Umschaltung  der  Prozessor-Register,  nicht  aber  fiir  die  der  FPU.  Daher  kann  zur  Zeit  nur 
ein  AES-ProzeB  gleichzeitig  FPU-Register  benutzen  (auBer  man  sorgt  selbst  vor  dem  Aufruf 
von  AES-Funktionen  dafiir,  daB  die  Register  gesichert  werden). 

Wie  schon  erwahnt,  wird  die  Kommunikation  zwischen  den  verschiedenen  AES-Prozessen 
iiber  “Mitteilungen”  geregelt.  Die  AES  bedienen  sich  einer  Warteschlange  (“Message- 
Queue”),  um  noch  nicht  verschickte  Mitteilungen  zu  speichem.  Diese  Queue  hat  in  den 
existierenden  AES-Versionen  eine  fixe  Lange,  so  daB  nicht  beliebig  viele  Mitteilungen 
gleichzeitig  “unterwegs”  sein  konnen.  Daher  ist  spezielle  Vorsicht  geboten,  wenn  ein  ProzeB 
Mitteilungen  an  sich  selbst  schickt  (ein  beliebter  Trick  zum  Auslosen  von  “Redraws”)  -  ein 
Uberlaufen  der  Message-Queue  (die  in  den  bestehenden  AES-Versionen  offenbar  eine  Lange 
von  16  Eintragen  hat)  fiihrt  zum  Blockieren  des  sendenden  Prozesses. 


Die  Initialisierung  der  AES 

Aufruf  nach  der  BlOS-Initialisierung 

In  den  aktuellenTOS-Versionen  sind  AES  und  Desktop  zu  einem  gemeinsamen  ausfuhrbaren 
Programm  zusammengefaBt.  Dies  -  und  nicht  irgendwelche  bosen  Absichten  -  ist  auch  der 
Grund  dafiir,  daB  das  Desktop  keineechten  AES- Aufrufe,  sondem  nur  einfache  Unterprogramm- 
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aufrufe  macht.  Das  BIOS  erzeugt  nach  Abarbeitung  des  AUTO-Ordners  einen  neuen 
GEMDOS-Prozefi  und  fiigt  als  Startadresse  des  Text-Segments  (also  als  Einsprungadresse) 
den  Inhalt  der  Systemvariablen  “exec_os”  ein,  Dort  wird  dann  die  Ausfuhrung  fortgesetzt. 


AES  -Environment 

Zu  Beginn  wird  das  GEMDOS-Environment  in  einen  eigenen  Puffer  fixer,  beschrankter 
Lange  kopiert  und  dort  spater  von  der  Shell-Bibliothek  (“shel_envm()”  und  “shel_find()”) 
benutzt. 


Laden  der  Accessories 

An  dieser  Stelle  wird  ab  Atari-GEM  3.0  ein  neuer  GEMDOS-Prozefi  erzeugt,  der  spater  bei 
einem  Auflosungswechsel  wieder  terminiert  wird.  Nur  so  ist  es  moglich,  beim  Wechsel  der 
Auflosung  wirklicb  alien  von  Accessories  belegten  Speicher  wieder  freizugeben.  Unter 
alteren  GEM-Versionen  blieben  von  Accessories  allozierte  Speicherblocke  belegt,  was  nicht 
nur  zur  Reduzierung,  sondem  auch  zur  starken  Zersplitterung  des  freien  Speichers  fuhrte. 

Bei  der  Lokalisierung  der  Accessories  legen  die  AES  ein  sehr  verwunderliches  Verhalten  an 
den  Tag.  Wissen  sollte  man,  dafi  die  AES  die  Accessories  immer  von  Laufwerk  C:  laden,  falls 
dieses  existiert  und  dort  mindestens  eine  Datei  mit  der  Namenserweiterung  “ACC”  gefunden 
wird.  Ahnliches  gilt  fur  das  Laden  der  “DESKTOP.INF”-  bzw.  “NEWDESK.INF’-Datei. 
Eine  wirklich  portable  Methode,  mit  der  man  die  AES  dazu  bewegen  konnte,  die  Accessories 
vom  zum  Zeitpunkt  der  Initialisierung  aktuellen  oder  dem  in  “_bootdev”  angegebenen 
Laufwerk  zu  laden,  ist  nicht  bekannt. 

Es  folgt  der  eigentliche  Ladevorgang.  Jede  gefundene  Accessory-Datei  (in  den  aktuellen  AES- 
Versionen:  maximal  sechs)  wird  mit  “Pexec()”  (Modus  3)  geladen  und  reloziert.  Damit  wer- 
den  die  Einstellungen  im  Programmkopf  (siehe  GEMDOS-Kapitel)  in  Hinsicht  auf  das  Laden 
des  Prozesses  sehr  wohl  beachtet.  Anschliefiend  wird  die  vom  “Pexec()”- Aufruf  erzeugte  TPA 
mittels  “Mshrink()”  auf  die  “normale”  Grofie  (die  Summe  derLangen  der  drei  Programmseg- 
mente  zuztiglich  256  Bytes  fiir  die  Basepage)  geschrumpft. 


Initialisierung  der  VDI- Workstation 

Anschliefiend  offnen  die  AES  eine  physikalische  VDI-Workstation  fur  den  Bildschirm.  Die 
gewiinschte  Bildschirmauflosung  wird  dabei  als  Geratenummer  an  “v_opnwk()”  iibergeben 
(sehr  wichtig  beim  Auflosungswechsel).  Spater  gestartete  Programme  diirfen  nur  noch 
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virtuelle  Bildschirm-Workstations  offnen  und  miissen  dazu  mittels  “graf_handle()”  die  Ken- 
nung  der  von  den  AES  benutzten  physikalischen  Workstation  erfragen. 

Hinweis\  Alle  zur  Zeit  bekannten  AES-Versionen  stiirzen  ab,  wenn  der  “v_opnwk()”-Aufruf 
zu  einem  Fehler  fiihrt. 

Damit  sind  insbesondere  die  VDI-Eingabefunktionen  (die  nur  auf  einer  physikalischen  Work¬ 
station  benutzt  werden  diirfen)  fur  die  AES  reserviert.  Die  AES  benutzen  das  Raster- 
koordinatensystem  des  VDI.  Der  Ursprung  liegt  damit  in  der  linken  oberen  Ecke  des  Bild- 
schirms.  Die  vom  VDI  gelieferten  Angaben  werden  von  den  AES  sauber  verarbeitet.  Nur 
deshalb  ist  es  auch  moglich,  eigene  VDI-Geratetreiber  fur  zasiitzliche  Grafikkarten  zu 
installieren  und  dann  AES  und  Desktop  darauf  laufen  zu  lassen. 


Der  “Quarter  Screen  Buffer” 

Dieser  Speicherbereich  wird  vom  Screen  Manager  benotigt,  um  beim  Herunterklappen  von 
Drop-Down-Meniis  den  Inhalt  des  Menuhintergrunds  zu  retten.  Auch  bei  der  Anzeige  von 
Alarmboxen  kommt  der  “QSB”  (so  die  gebrauchliche  Abkilrzung)  zum  Einsatz.  Normaler- 
weise  sollte  seine  GroBe  von  der  Anzahl  der  Farbebenenund  der  GroBe  des  Systemzeichensatzes, 
nicht  aber  von  der  GesamtgroBe  des  Bildschirms  abhangen.  Eine  gute  Formel  ware  zum 
Beispiei: 

500  (Zeichen)  *  Platzbedarf  eines  Zeichens  *  Farbebenen 

Damit  kame  man  in  der  Auflosung  “ST-Hoch”  genau  auf  den  Wert  8000  (also  ein  Viertel  des 
Bildspeichers).  Leider  sind  die  AES  in  der  Praxis  nicht  so  clever.  Hier  eine  Ubersicht  liber  die 
verschiedenen  zur  Zeit  benutzten  Algorithmen  zur  Bestimmung  der  PuffergroBe: 


GEM-Version 

Methode  zum  Setzen  des  QSB 

1.0,  1.2 

statisch,  8000  Bytes 

1.4 

dynamisch,  ein  Viertel  des  Bildspeichers 

3.0 

dynamisch,  die  Halfte  des  Bildspeichers 

Die  GEM-V ersionen  1 .0  und  1 .2  (also  bis  einschlieBlich  TOS  1 .02)  sind  mithin  nicht  fur  Farb- 
karten  vorbereitet  -  einer  unter  mehreren  Griinden,  warum  man  selbst  bei  Benutzung  eines 
speziellen  VDI-Treibers  unter  diesen  GEM- Versionen  Farbgrafikkarten  nicht  einsetzen  kann. 

Das  bei  GEM  1 .4  benutzte  Verfahren  war  eigentlich  sehr  sinnvoll,  konnte  aber  wegen  der  “TT- 
Niedrig”-Auflosung  nicht  beibehalten  werden.  Rechenexempel:  Die  BildspeichergroBe 
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betragt  153600  Bytes.  Ein  Viertel  davon  sind  38400  Bytes,  die  bei  acht  Farbebenen  und  16 
Bytes  pro  Zeichen  Platz  fiirnur  300  Zeichen  bieten.  Daher  ist  man  in  GEM  3.0  dazu  iibergegan- 
gen,  gleich  die  Halfte  einer  Bildspeicherlange  zu  reservieren.  Das  funktioniert  zwar,  ist  jedoch 
eine  immense  Speicherplatzverschwendung  (bei  einer  Farbgrafikkarte  mit  1024  *  768  Punk- 
ten  in  256  Farben:  iiber  390  KByte  Puffer!).  Hier  sollte  Atari  also  kunftig  eine  flexiblere  For- 
mel  (wie  die  oben  vorgeschlagene)  einsetzen. 


Startupcode  fiir  Accessories 

Accessories  werden  zwar  wie  echte  GEMDOS-Prozesse  geladen,  damithort  die  Ahnlichkeit 
aber  schon  auf.  Die  vom  “Pexec()”- Aufruf  angelegte  Basepage  ist  nicht  vollstandig  ausgefiillt, 
und  anders  als  bei  einem  normalen  GEMDOS-Programm  wird  beim  Aufruf  der  Basepage- 
Zeiger  nicht  auf  dem  Stack,  sondem  in  AdreBregister  A0  iibergeben.  Dariiber  hinaus  muB 
unbedingt  ein  eigener  Stack  angelegt  werden,  da  der  Stackpointer  beim  Aufruf  normalerweise 
auf  Null  initialisiert  ist  (genaugenommen  wird  er  mit  einem  zufalligen  Wert  initialisiert,  der 
eben  praktisch  immer  Null  ist).  Zusammenfassung: 

-  Wenn  bei  Programmstart  A0  den  Wert  Null  hat,  dann  handelt  es  sich  um  einen  normalen 
Programmstart  (wie  im  GEMDOS-Kapitel  beschrieben). 

-  Anderenfalls  handelt  es  sich  um  ein  Accessory,  und  A0  enthalt  einen  Zeiger  auf  die 
unvollstandig  ausgefullte  Basepage.  Die  TPA  ist  bereits  passend  geschrumpft  (auf  die 
Summe  von  BasepagegroBe  und  der  Langen  der  drei  Programmsegmente).  Ein  Stack 
muB  erst  noch  angelegt  werden. 

Mit  diesen  Informationen  ist  es  kein  Problem,  den  Startup-Code  fiir  ein  Programm  so  zu 
gestalten,  daB  er  selbstandig  erkennt,  wie  das  Programm  gestartet  worden  ist,  und  entspre- 
chend  die  Initialisierung  fortsetzt.  Bei  den  meisten  neueren  C-Compilem  wird  im  Startupcode 
automatisch  die  exteme  Variable  “_app”  initialisiert,  die  genau  dann  gleich  Null  ist,  wenn  das 
Programm  als  Accessory  gestartet  worden  ist.  Damit  kann  man  Programme  so  entwickeln,  daB 
sie  sowohl  als  Accessory  als  auch  als  normales  Programm  eingesetzt  werden  konnen. 


Die  Applikations-Bibliothek 

Dieser  Teil  der  AES  beschaftigt  sich  mit  allem,  was  mit  der  Installation  und  Abmeldung  von 
Applikationen  und  der  Kommunikation  zwischen  Applikationen  zu  tun  hat. 

Dies  ist  wegen  der  -  wenn  auch  eingeschrankten  -  Multitasking-Fahigkeiten  von  GEM 
dringend  notig.  Jede  GEM-Applikation  sollte  sich  mit  “appl_init()”  ordnungsgemaB  anmel- 
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den.  Dabei  erhalt  sie  eine  eindeutige  Kennung,  meist  als  “ap_id”  bezeichnet,  die  sie  von  alien 
anderen,  gleichzeitig  im  Speicher  befmdlichen  GEM-Prozessen  unterscheidet.  Daneben  wird 
das  GLOBAL-Feld  (siehe  auch  unter  Parameteriibergabe)  initialisiert,  das  wie  folgt  aussieht: 


WORD  gIobal[15]; 

global[0]  (ap_version): 

global|  1 1  (ap_count): 

global[2]  (ap_id): 
global[3,4]  (ap_pprivate): 

global[5,6]  (ap_ptree): 

global[7,8]  (ap_pmem): 

global[9]  (ap_lmem): 

global[10]  (ap_nplanes): 

globalt  11,12]: 
global  [13]  (ap_bvdisk): 

global[14]  (ap_bvhard): 


Hier  steht  die  AES-Versionsnummer.  Zur  Zeit  mogliche  Werte 
fiir  Atari-GEM  sind  0x0100  (GEM  1.0),  0x0120  (GEM  1.2), 
0x0140  (GEM  1.4)  und  0x0300  (GEM  3.0). 

Maximalzahl  von  gleichzeitig  unterstiitzten  Applikationen  (wild 
von  den  AES  eingetragen)  und  ist  zur  Zeit  “1 
Kennung  der  Applikation  (wird  von  den  AES  eingetragen). 
Irgendwelche  Informationen,  die  nur  fur  die  Applikation  von 
Bedeutung  sind  und  auch  von  ihr  gesetzt  und  gelesen  werden. 
Unter  PC-GEM:  “ob_spec”  von  Fenster  0  (kann  benutzt  werden, 
um  Standardhintergrundfarbe  und  -muster  abzufragen). 

Zeiger  auf  eine  Liste  von  Zeigem  auf  die  Objektbaume  der 
Applikation.  Sollte  zunachst  auf  0  initialisiert  werden  und  wird 
dann  von  “rsrc_load()”  gesetzt. 

Anfangsadresse  des  fiir  die  Resource-Datei  reservierten  Spei- 
chers  (nicht  von  Atari,  wohl  aber  von  Digital  Research  doku- 
mentiert). 

Lange  des  reservierten  Speichers  (nicht  von  Atari,  wohl  aber  von 
Digital  Research  dokumentiert). 

Anzahl  der  Farbebenen  (nicht  von  Atari,  wohl  aber  von  Digital 
Research  dokumentiert). 

Reserviert. 

Im  PC-GEM  ab  Version  2.0:  Bitvektor  mit  den  auf  dem  Desktop 
angemeldeten  Laufwerken  (Bit  15:  “A”  etc).  Im  Atari-GEM: 
reserviert. 

Im  PC-GEM  ab  Version  2.0:  Bitvektor,  der  angibt,  welche  der  in 
“ap_bvdisk”  angegebenen  Laufwerke  als  Festplatte  betrachtet 
werden  sollen.  Im  Atari-GEM:  reserviert. 


Die  Ereignis-Bibliothek 

Einleitung 

Bevor  wir  auf  die  verschiedenen  Typen  von  Ereignissen  eingehen,  soil  hier  noch  einmal  auf 
die  entscheidende  Bedeutung  dieser  Funktionen  fiir  das  Multitasking  unter  GEM  eingegangen 
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werden.  Der  Grundgedanke  ist,  daS  Programme,  die  auf  irgendeinEreignis  warten,  dies  nicht 
dadurch  realisieren,  daB  sie  in  einer  groBen  Schleife  alle  moglichen  Ereignisse  durchchecken, 
sondem  indem  sie  den  AES  mitteilen,  worauf  sie  warten  und  sich  dann  vorlaufig  zur  Ruhe 
begeben.  In  dieser  Wartezeit  konnen  die  AES  die  gesamte  Prozessorzeit  anderen  Prozessen 
zuweisen.  Die  Applikation  wird  wieder  aktiviert,  wenn  das  erwartete  Ereignis  dann  eingetre- 
ten  ist. 


Arten  von  Ereignissen  (events) 


Tastatur-Ereignis:  Es  wird  ein  Tastendruck  des  Benutzers  erwartet. 

Mausknopf-Ereignis:  Es  wird  auf  einen  auszuwahlenden  Zustand  der  Maustasten  ge- 

wartet. 


Maus-Ereignis:  Es  wird  darauf  gewartet,  daB  der  Mauszeiger  einen  rechteckigen 

Teil  des  Bildschirms  betritt  Oder  verlaBt. 


Mitteilungs-Ereignis:  Die  Applikation  wartet  auf  eine  Nachdcht  von  einem  anderen 

ProzeB  (im  allgemeinen  dem  Screen  Manager,  der  das  Anklicken 
von  Menus  Oder  Veranderungen  der  Fenster  mitteilt). 

Timer-Ereignis:  Es  wird  auf  das  Verstreichen  einer  bestimmten  Zeitspanne  ge¬ 

wartet  (auf  gar  keinen  Fall  statt  dessen  eine  handgestrickte  War- 
teschleife  benutzen). 


Zusatzlich  kann  man  auf  eine  beliebige  Kombination  solcher  Ereignisse  warten  (Multi-Ereig- 
nis). 


Mitteilungs-Ereignisse 

Mitteilungs-Ereignisse  dienen  zur  Kommunikation  zwischen  verschiedenen  AES-Prozessen. 
In  den  allermeisten  Fallen  handelt  es  sich  urn  Nachrichten,  die  der  Screen  Manager  an  ein 
Accessory  oder  die  Hauptapplikation  schickt.  Die  AES  verschicken  Mitteilungen  in  Paketen 
zu  je  16  Bytes,  deren  Format  so  aussieht: 

WORD  mbuf [8] ; 

mbuf[0]:  Nachrichtennummer 

mbuf[  1  ] :  Nummer  (ap_id)  des  Absenders 
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mbuf[2]:  Anzahl  der  Bytes,  die  noch  nachtraglich  per  “appl_read()”  gelesen  werden 

mussen. 

Dies  ist  allerdings  nur  eine  Konvention,  die  eigentiich  nirgendwo  erzwungen  wird.  Nur  bei 
Redraw- Aufforderungen  (die  anhand  der  Nachrichtennummer  erkannt  werden)  nehmen  sich 
die  AES  die  Freiheit,  mehrere  Mitteilungen  zu  einer  einzigen  zu  sammeln. 

“mbuf[2J”  ist  zur  Zeit  bei  alien  vom  Screen  Manager  verschickten  Mitteilungen  Null  (da  sie 
immer  nur  16  Bytes  umfassen). 

Laut  Digital  Research  sollte  man  also  ungefahr  so  vorgehen: 
evnt_mesag  (rribuf) ; 

if  (rribuf  [2]  >  0) 

{ 

appl_read  (ap_id,  rribuf [2],  puffer) ; 

1 

Mitteilungen  mit  unbekannten  Nachrichtennummem  mussen  ignoriert  werden.  SchlieBlich 
konnte  der  Screen  Manager  eines  Tages  erweitert  werden  oder  mal  eine  benutzerdefinierte 
Mitteilung  eines  anderen  Programms  eintreffen. 

Fiir  die  einzelnen  Ereignistypen  hat  der  Rest  des  Nachrichtenpuffers  jeweils  unterschiedliche 
Bedeutungen: 

MN  SELECTED  (10) 

Ein  Eintrag  in  einem  Drop-Down-Menu  ist  angeklickt  worden: 

rribuf [3]:  Objektnummer  des  Mentititels 

mbuf[4J:  Objektnummer  des  Mentieintrags 

WM  REDRAW  (20) 

Ein  Teil  des  Arbeitsbereiches  eines  Fensters  muB  neu  gezeichnet  werden: 

mbuf[3]:  Kennung  des  wiederherzustellenden  Fensters 

mbuf[4]:  X-Koordinate  des  wiederherzustellenden  Fensterausschnitts 

mbuf[5]:  Y-Koordinate  des  wiederherzustellenden  Fensterausschnitts 

mbuf[6]:  Breite  des  wiederherzustellenden  Fensterausschnitts 

mbuf[7]:  Hohe  des  wiederherzustellenden  Fensterausschnitts 
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Bemerkungen 

Mehrere  aufeinanderfolgende  “WM_REDRAW”-Mitteilungen  werden  von  den  AES  zu  einer 
einzigen  Mitteilung  zusammengefaSt. 


WM  TOPPED  (21) 

Dieses  Fenster  wird  zum  aktuellen  Fenster. 
mbuf[3]:  Kennung  des  Fensters 

WM  CLOSED  (22) 

Das  SchlieSfeld  des  Fensters  ist  angeklickt  worden. 
mbuf[3]:  Kennung  des  Fensters 

WM  FULLED  (23) 

Die  Full-Box  (voile  BildschirmgrolJe)  des  Fensters  ist  angeklickt  worden. 
mbuf[3]:  Kennung  des  Fensters 


WMARROWED  (24) 

Einer  der  Pfeile  ist  angeklickt  worden. 


mbuf[3]: 

mbuf[4]: 


Kennung  des  Fensters 

Art  der  geforderten  Veranderung: 

WA„UPPAGE  (0);  Seite  aufwarts  (Balken  oberhalb des  Schiebers  angeklickt) 
Seite  abwarts  (Balken  unterhalb  des  Schiebers  angeklickt) 
Zeile  aufwarts  (Pfeil  nach  oben  angeklickt) 

Zeile  abwarts  (Pfeil  nach  unten  angeklickt) 

Seite  links  (Balken  links  des  Schiebers  angeklickt) 
Seite  rechts  (Balken  rechts  des  Schiebers  angeklickt) 
Spalte  links  (Pfeil  nach  links  angeklickt) 

Spalte  rechts  (Pfeil  nach  rechts  angeklickt) 


WA_DNPAGE  (1): 
WAJJPLINE  (2): 
WA_DNLINE  (3): 
WAJJFPAGE  (4): 
WA_RTPAGE  (5): 
WA_LFLINE  (6): 
WA_RTLINE  (7): 


WMHSLID  (25) 

Der  horizontale  Schieber  eines  Fensters  wurde  bewegt. 

mbuf[3]:  Kennung  des  Fensters 

mbuf[4];  von  0  (ganz  links)  bis  1000  (ganz  rechts) 


546 


ATARI  Profibuch 


WMVSLID  (26) 

Der  vcrtikale  Schieber  eines  Fensters  wurde  bewegt. 

mbuf[3]:  Kennung  des  Fensters 

mbuf[4]:  von  0  (ganz  oben)  bis  1000  (ganz  unten) 

WMSIZED  (27) 

Die  GroBe  eines  Fensters  wurde  geandert  (dabei  sind  die  AuBenmaBe  gemeint). 

mbuf[3]:  Kennung  des  Fensters 

mbuf[4]:  X-Koordinate 

mbuf[5] :  Y -Koordinate 

mbuf(6]:  neue  Breite 

mbuf[7]:  neueHohe 

WM  MOVED  (28) 

Die  Position  eines  Fensters  wurde  geandert  (wiederum  Angabe  der  AuBenmaBe). 

mbuf[3]:  Kennung  des  Fensters 

mbuf[4]:  Neue  X-Koordinate 

mbuf[5]:  Neue  Y-Koordinate 

mbuf[6]:  Breite  (sollte  gleichgeblieben  sein) 

mbuf[7]:  Hohe  (sollte  gleichgeblieben  sein) 

WM  NEWTOP  (29) 

Diese  Mitteilung  hatte  wohl  eine  ahnliche  Funktion  wie  “WM_TOPPED”,  ist  aber  mittlerwei- 
Ie  nicht  mehr  dokumentiert  und  scheint  auch  nicht  aufzutreten. 

WM_UNTOPPED  (30)  -  nur  in  PC -GEM  ab  Version  2.0 

Das  betreffende  Fenster  wird  gerade  inaktiv.  Diese  Nachricht  kann  man  benutzen,  urn  vorher 
den  Fensterinhalt  irgendwo  zu  sichem! 

mbuf(3]:  Kennung  des  Fensters 


AC_OPEN  (40) 

Der  Eintrag  des  Accessories  im  ersten  Drop-Down-Menii  wurde  angeklickt. 
mbuf[4]:  Kennung  (menu_id)  des  Menii-Eintrags 
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Bemerkungen 

Dies  scheint  ein  echter  Fehler  im  Atari-GEM  zu  sein,  da  in  samtlichen  PC-Dokumentationen 
mbuf[3]  angegeben  wird  -  es  bietet  sich  an,  diese  Information  gSnzlich  zu  ignorieren,  da  man 
die  AC_OPEN-Nachricht  sowieso  nur  fur  das  eigene  Accessory  empfangt.  Mehr  als  einen 
Menueintrag  (wie  die  erste  Version  des  Kontrollfeld-Accessories)  sollte  man  aus  Riicksicht 
auf  andere  Accessories  sowieso  nicht  verwenden. 

ACCLOSE  (41) 

Ein  Accessory  wurde  geschlossen.  Damit  ist  der  Start  Oder  das  Ende  einer  Haupt- Applikation 
gemeint.  Das  Accessory  braucht  seine  Fenster  nicht  selbst  zu  schlieften! 

mbuf[3]:  Kennung  (menujd)  des  Menii-Eintrags 

Bemerkungen 

Erst  ab  Atari-GEM  3.0  darf  man  sicher  sein,  dad  diese  Mitteilung  tatsachlich  vor  dem 
endgtiltigen  Ende  (also  dem  Verlust  von  Speicherblocken  und  Dateikennungen)  des 
Hauptprogramms  eintrifft. 

CT  UPDATE  (50),  CT  MOVE  (51),  CT_NEWTOP  (52) 

Von  Digital  Research  so  angegeben;  Funktion  unbekannt. 

CTJKEY  (S3) 

Diese  Mitteilungsnummer  wird  von  dem  modularen  Kontrollfeld  “XCONTROL”  zur  Mel- 
dung  von  Tasteneingaben  benutzt  (Genaueres  dazu  bei  der  Dokumentation  von  “XCON¬ 
TROL”). 


Benutzerdefinierte  Mitteilungen 

Neben  den  vordefinierten  Mitteilungen  kann  man  naturlich  auch  noch  selbst  definierte 
Nachrichten  einsetzen  -  zum  Beispiel,  urn  ein  Accessory  und  ein  Hauptprogramm  miteinan- 
derkommunizierenzulassen.DigitalResearchschlagtfursolcheNachrichtenMitteilungsnum- 
mem  jenseits  von  1024  vor. 

Mittlerweile  sind  viele  flexible  Protokolle  auf  Basis  der  AES-Events  festgelegt  worden. 
Exemplarisch  sei  das  “AV-Protokoll”  genannt,  das  im  altemativen  Desktop  “Gemini”  fur  die 
Kommunikation  zwischen  Desktop  und  Accessories  zustandig  ist  und  auch  leicht  auf  andere 
Programme  angewandt  werden  kann.  Einige  niitzliche  Eigenschaften: 
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-  Accessory-Fenster  konnen  in  die  Fensterverwaltung  des  Hauptprogramms  aufgenom- 
men  werden  (zum  Beispiel  fur  “Fenster  wechseln”). 

-  Accessories  konnen  Tastendriicke  an  das  Hauptprogramm  weiterleiten. 

-  Accessories  konnen  Statusinformationen  durch  das  Hauptprogramm  laden  und  sichem 
lassen. 

-  Accessories  werden  dariiber  informiert,  wenn  ein  Bildsymbol  in  das  Fenster  des 
Accessories  gezogen  wurde. 

-  Accessories  konnen  Gemini-Fenster  offrien  und  Programme  starten  lassen. 

Wie  man  sieht,  bietet  das  “AV-Protokoll”  allerlei  niitzliche  Dinge.  Eine  vollstandige 
Dokumentation  finden  Sie  in  der  Gemini-Dokumentation. 


Die  Menii-Bibliothek 

Zu  den  Grundlagen  der  Drop-Down-Menus  braucht  nicht  viel  gesagt  zu  werden  -  jeder  kennt 
sie  aus  Desktop  und  vielen  Anwendungsprogrammen. 

Anders  steht  es  mit  vielen  Details:  Welche  Standardmeniis  sollte  es  geben,  wie  zeigt  man 
Tastatur-Shortcuts  an?  Die  Antworten  zu  diesen  Fragen  finden  Sie  im  Kapitel  “Richtlinien  zur 
Benutzerfiihrung  und  Programmierung”. 

Die  aktuellen  AES-Versionen  auf  dem  Atari  erlauben  nur  eine  Meniileiste  -  Accessories 
mtissenalso  andere  WegederBenutzerfuhrunggehen.  Beim  PC-GEM  werden  dieMeniileisten 
automatisch  umgeschaltet:  je  nachdem,  welchem  AES  -ProzeB  das  aktive  Fenster  gehort.  Man 
darf  wohl  davon  ausgehen,  daB  es  unter  einem  kiinftigen,  multitaskingfahigen  AES  genauso 
funktionieren  wird. 

Noch  eine  Bemerkung  zur  Namensgebung:  Drop-Down-Menus  sind  etwas  anderes  als  die 
“Pull-Down”-Meniis,  wie  sie  zum  Beispiel  auf  dem  Macintosh  benutzt  werden.  Erste  “fallen 
herunter”,  wenn  man  sie  mit  dem  Mauszeiger  beriihrt.  “Pull-Down”-Meniis  hingegen  werden 
erst  ausgeklappt,  wenn  man  mit  gedriickter  Maustaste  in  den  Mentibereich  fahrt. 

“Drop-Down”-Meniis  haben  den  Nachteil,  daB  man  sie  oft  unabsichtlich  aktiviert  und  erst 
durch  einen  Mausklick  wieder  los  wird.  Mac-artige  Mentis  hingegen  sind  meist  fiir  Anfanger 
schwerer  zu  bedienen,  weil  sie  die  Koordination  von  Maustaste  und  Mausbewegung  erfordem. 
Ab  PC-GEM  Version  3  kann  man  das  Verhalten  der  Menus  mittels  “menu_click()”  einstellen. 


AES-Betriebssystemroutinen 


549 


Wenden  wir  uns  nun  der  interessanten  Frage  zu,  was  denn  so  ein  Menii-Objektbaum  (den  man 
mit  “menu_bar()”  auf  den  Bildschirm  bringt)  eigentlich  ist.  Dazu  schauen  wir  uns  einmal  die 
Objektstruktur  an,  die  ein  Resource-Construction-Programm  erzeugt,  wenn  man  eine  MENU- 
Struktur  entwirft. 

Der  Objektbaum  besteht  aus  insgesamt  17  Objekten  (nahere  Informationen  zu  Objekten 
iibrigens  im  Kapitel  iiber  die  Objekt-Bibliotheken..,): 

Objekt  0:  AuBere  Box  (IBOX),  die  den  gesamten  Baum  umfafit 

Objekt  1 :  Unsichtbare  Box  fur  den  Menii-Balken  (enthalt  Objekt  2) 

Objekt  2:  Solide  weiBe  Box,  die  alle  Menii-Titel  umfaBt  (enthalt  Objekt  3  und  4) 

Objekt  3:  Titel  “Desk” 

Objekt  4:  Titel  “File” 

Objekt  5:  Unsichtbare  Box,  liegt  genau  unterhalb  des  Menii-Balkens  (enthalt  Objekte  6 

und  15) 

Objekt  6:  Box  fur  das  Desk-Menu  (enthalt  als  Objekte  die  einzelnen  Eintrage  7-14) 

Objekt  7:  Eintrag  “Your  message  here...” 

Objekt  8:  Eintrag  “ - ” 

Object  9;  Eintrag  “Desk  Accessory  1  “ 

Object  10:  Eintrag  “Desk  Accessory  2  “ 

Object  11;  Eintrag  “Desk  Accessory  3  “ 

Object  12:  Eintrag  “Desk  Accessory  4  “ 

Object  13:  Eintrag  “Desk  Accessory  5  “ 

Object  14:  Eintrag  “Desk  Accessory  6  “ 

Objekt  15:  Box  fiir  das  File-Menu  (enthalt  Objekt  16) 

Objekt  16:  Eintrag  “Quit  “ 
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SchlieBIich  noch  ein  Hinweis  auf  kilnftige  Weiterentwicklungsmoglichkeiten:  Wann  immer 
moglich,  sollte  man  die  Funktionen  der  Menii-Bibliothek  benutzen,  anstatt  direkt  auf  die 
Objekte  zuzugreifen.  Die  momentan  benutzte  Struktur  schrankt  die  Anzahl  der  Accessory- 
Eintrage  auf  sechs  ein,  so  daft  unter  Umstanden  eines  Tages  eine  Umstellung  der  intemen 
Representation  der  Menus  vorgenommen  werden  konnte. 


Die  Objekt-Bibliothek 

Das  Konzept 

Objekte  sind  das  grundlegende  Element  der  AES.  Dateiauswahlbox,  Alarmboxen,  Fenster, 
Drop-Down-Meniis  -  alles  ist  intern  aus  Objekten  zusammengesetzt. 

Ein  “object”  ist  nichts  anderes  als  eine  Datenstruktur,  die  ein  grafisches  Objekt  (wie  eine  Box, 
einen  Text  oder  einen  Knopf)  beschreibt.  Dazu  gehoren  in  erster  Linie  Typ  (Knopf,  Text- 
eingabefeld...).  Position  und  verschiedene  Attribute  (zum  Beispiel  das  Fiillmuster  eines  Box- 
Objekts). 

Die  einzelnen  Objekte  sind  in  einer  visuellen  Hierarchie  geordnet.  Mit  Hierarchie  ist  in  diesem 
Zusammenhang  gemeint,  daB  zu  jedem  Objekt  genau  ein  iibergeordnetes  Parent- Objekt 
gehort  (auBer  es  handelt  sich  bereits  um  das  hochste  Objekt).  “Visuell”  steht  dafiir,  daB  sich 
die  Hierarchie  nicht  nur  in  der  Datenstruktur,  sondem  auch  in  der  Representation  auf  dem 
Bildschirm  wiederspiegelt. 

So  ist  in  einer  einfachen  Alarmbox  jedes  Objekt  (also  Texte,  Knopfe  und  das  Bildsymbol)  ein 
CTwM-Objekt  der  Hintergrundbox.  Dieses  nennt  man  oft  auch  das  Wurzelobjekt.  Die  Hierar- 
chieebenen  konnen  natiirlich  auch  noch  weitergehen.  Oft  sieht  man  mehrere  Knopfe,  die 
gemeinsam  in  einem  umgebenden  Rahmen  zusammengefaBt  sind. 

Vom  Modell  des  objekt-orientierten  Programmierens  kennt  man  die  Idee,  daB  ein  Parent- 
Objekt  an  die  ihm  untergeordneten  Objekte  Eigenschaften  vererbt.  Bei  den  AES -Objekten 
handelt  es  sich  freilich  nur  um  den  Bezugspunkt  der  Positionsangabe.  Diese  ist  also  immer  als 
Offset  zur  Position  des  tibergeordneten  Objekts  zu  verstehen.  Nur  beim  Wurzelobjekt  handelt 
es  sich  um  eine  absolute  Bildschirmposition. 

Jedes  Objekt  bedeckt  ein  genau  definiertes  Rechteck  (dessen  Breite  und  Hohe  in  der 
Objektstruktur  angegeben  ist).  Sinn  und  Zweck  der  visuellen  Hierarchie  ist,  daB  fur  jedes 
Objekt  das  zugehorige  Rechteck  vollstandig  in  dem  des  Parent-Objekts  enthalten  ist.  Die 
meisten  Resource-Constraction-Programme  fordem  diese  Gliederung,  indent  sie  vor  Uberlap- 
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pangen  wamen.  Zur  Veranschaulichung  wollen  wir  hier  den  AJgorithmus  darstellen,  den 
“objc_offset()”  benutzt,  um  die  absolute  Bildschirmposition  eines  Objekts  zu  ermitteln: 

WORD 

objc_offset  (OBJECT  *Tree,  WORD  ObNum,  WORD  *Xoff,  WORD  *Yoff) 

{ 

WORD  sumx  =  0,  sumy  =  0;  /*  Auf  0  initialisieren  */ 

do 

{ 

sumx  +=  Tree [ObNum] ,ob_x;  /*  Position  aufaddieren  */ 
sumy  +=  Tree [ObNum] .ob_y; 

ObNum  =  objc_get_parent  (Tree,  ObNum) ; 

}  while  (ObNum  !=  -1);  /*  -1:  Wurzel  erreicht  */ 

*Xoff  =  sumx; 

*Yoff  =  sumy; 

return  TRUE; 

) 

Es  werden  also  die  X-  und  Y-Positionen  des  betreffenden  Objekts  und  aller  tibergeordneter 
Objekte  aufsummiert. 

Auch  “objc_draw()”  macht  sich  die  Gliederung  eines  Objektbaums  zunutze.  Es  beginnt  bei 
dem  Wurzelobjekt  und  steigt  dann  rekursiv  immer  defer  die  Objekthierarchie  hinunter.  Folge 
ist  der  allseits  bekannte  Effekt,  daB  die  Objekte  der  untersten  Ebene  zuletzt  und  damit 
“zuoberst”  gezeichnet  werden. 

Eine  besonders  aufwendige  und  zeitkritische  Aufgabe  ist  es,  das  oberste,  an  einer  bestimmten 
Bildschirmkoordinate  liegende  Objekt  zu  finden.  Dieses  Problem  miissen  die  AES  bei  jedem 
einzelnen  Mausklick  in  eine  Dialogbox  bearbeiten. 

Die  hierarchische  Gliederung  macht  es  einfach:  Ein  Unterbaum  eines  Objekts  braucht  nur 
dann  untersuchtzu  werden,  wenn  die  Koordinaten  innerhalb  des  Rechtecks  des  Parent-Objekts 
liegen.  Auf  diese  Weise  werden  die  Suchzeiten  drastisch  reduziert  (fur  Mathematiker:  von 
O(n)  auf  0(log  «)). 

Wenn  man  jetzt  noch  weiB,  daB  die  Fenster  intern  als  Objektbaum  dargestellt  werden  und  ein 
Aufruf  von  “wind_find()”  ziemlich  direkt  zu  einem  Auffuf  von  “objc_find(>”  fiihrt,  wird 
dieses  Objekt-Modell  wohl  auch  recht  einleuchtend  erscheinen. 
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Die  Implementation 

Baumartige  Datenstrukturen  sind  zwar  sehr  fiexibel,  dafur  aber  im  Vergleich  zu  einfachen 
Feldem  etwas  schwerfallig.  Auf  modemen  Workstations  wiirde  man  vielleicht  tatsachlich 
einen  “echten”  Baum  benutzen.  1984  gait  es  jedoch,  moglichst  wenig  Platz  zu  verbrauchen 
und  so  effizient  wie  nur  moglich  zu  sein. 

Objektbaume  werden  deshalb  als  Felder  (Arrays)  von  einzelnen  Objektstrukturen  dargestellt. 
Dadurch  kann  bei  Kenntnis  der  Adresse  des  W  urzelobjekts  direkt  auf  jedes  Objekt  des  Baums 
zugegriffen  werden,  ohne  erst  lang  verzeigerte  Strukturen  durchlaufen  zu  miissen.  Die 
Verkettung  der  einzelnen  Objekte  erfolgt  nicht  iiber  echte  Zeiger,  sondem  jeweils  iiber  deren 
Nummerim  Feld.  Nachteil  dieses  Konzepts  ist,  daBbestehende  Baumenur  durch  Umkopieren 
vergrbficrt  werden  konnen.  Die  Gliederung  erfolgt  iiber  die  drei  speziellen  Eintriige  in  der 
Objekt-Struktur: 

ob_next:  Nummer  des  folgenden  Objekts  gleicher  Ebene  Oder  -  falls  es  das  letzte  Ele¬ 

ment  in  der  Ebene  ist  -  des  Parent-Objekts. 

ob_head:  Nummer  des  ersten  Kinds  des  Objekts. 

ob_tail:  Nummer  des  letzten  Kinds  des  Objekts. 

Zeiger,  die  nirgendwohin  weisen  (zum  Beispiel,  weil  es  keine  tiefere  Ebene  mehr  gibt),  haben 
den  Wert  “-1”  (gemeinhin  NIL  genannt). 

Bevor  wir  uns  nun  in  alle  Spielarten  von  Objekten  vertiefen,  sei  darauf  verwiesen,  daB  man 
Objektbaume  (im  Atari-Jargon  auch  geme  Resources  genannt)  iiblicherweise  nicht  “zu  FuB” 
im  Speicher  zusammensetzt  (das  geht  natiirlich  auch),  sondem  mit  einem  “Resource 
Construction  Set”  (RCS)  entwirft  und  in  einer  Resource-Datei  ablegt,  die  das  Programm  dann 
mittels  “rsrc_load()”  ladt.  Ein  sehr  leistungsfahiges  RCS  ist  das  Programm  “Interface”,  das 
von  der  Firma  Shift  vertrieben  wird. 


Die  Objekt-Struktur 

Ein  Objekt  hat  folgende  Struktur: 


typedef  struct 
{ 

WORD  ob_next  ; 
WORD  ob__head; 
WORD  ob  tail; 


/*  Nummer  des  nachsten  Objekts  */ 
/*  Nummer  des  ersten  Kinds  */ 

/*  Nummer  des  letzten  Kinds  */ 
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UWORD 

ob_type; 

/* 

Art  des  Objekts  */ 

UWORD 

ob_f lags ; 

/* 

Verschiedene  Flags  */ 

UWORD 

ob_state; 

/* 

Status  des  Objekts  */ 

void 

*ob__spec; 

/* 

typabhangig  */ 

WORD 

ob_x; 

/* 

X-Position  (rel.  zum  Parent- 
Objekt)  */ 

WORD 

ob_y; 

/* 

Y-Position  (rel.  zum  Parent- 
Objekt)  */ 

WORD 

ob  width; 

/* 

Breite  */ 

WORD 

}  OBJECT; 

ob_height; 

/* 

Hohe  */ 

Das  Strukturelement  “ob_spec”  ist  32  Bits  groB. 

Seine  Bedeutung  hangt  ganz  von  “ob_type”  des  Objekts  ab.  Fiir  C-Programmierer  erscheint 
daher  die  Deklaration  einer  "Union”  als  sinnvoll,  damit  man  ohne  die  lastige  Anwendung  von 
“typecasts”  zugreifen  kann: 

/*  Deklaration  von  "OBSPEC"  als  Union,  angelehnt  an  die  Definition 
im  AES.H  des  Turbo-C-Compilers  */ 

typedef  union  obspecptr 

{ 

LONG 

union  obspecptr 
bfobspec 
TED INFO 
ICONBLK 
BITBLK 
USEFBLK 
char 
}  OBSPEC; 

Die  Deklaration  von  “objspec”  in  der  OBJECT-Struktur  andert  sich  dadurch  zu: 

OBSPEC  ob_spec; 

Zum  Zugriff  auf  eine  TEDINFO-Struktur  wiirde  man  also 
Treefob] . ob_spec . tedinf o 


index; 

* indirect; 

obspec;  /*  siehe  unten  */ 

*tedinfo; 

*iconblk; 

*bitblk; 

*userblk; 

*free__string; 


anstelle  von 
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(TEDINFO  *)Tree[ob]  .ob_spec 

schreiben.  Ahnliche  Deklarationen  sind  auch  in  Pascal  oder  in  Modula-2  denkbar. 

Zu  besprechen  bleiben  also  noch  die  Strukturelemente  “ob . type”,  “ob_flags”,  “ob_state”  und 

“ob_spec”: 


Objekttypen  (obtype) 

Das  obere  By  te  des  Objekttyps  w  ird  von  den  AES  kompiett  ignoriert  und  steht  daher  fiir  eigene 
Anwendungen  zu  r  Verfiigung  (speziell  alsZusatzinfonnationfiir  selbstdefinierte  Objekttypen, 
wie  man  sie  mittels  der  USERDEF-Struktur  erzeugen  kann). 

Wenn  man  in  eigenen  Programmen  Entscheidungen  anhand  des  Objekttyps  fallt,  sollte  man 
also  immer  die  obersten  acht  Bits  ausmaskieren! 


GJBOX  (20) 


G_TEXT  (21) 
GBOXTEXT  (22) 


Rechteckiger  Kasten  mit  diversen  Attributen.  “ob_spec”  enthalt 
verschiedene  Mormationen  iiber  Rahmenstarke,  Farbe  und 
ahnliches. 

Grafik-Text.  “ob_spec”  zeigt  auf  eine  TEDINFO-Struktur. 

Rechteckiger  Kasten  mit  Grafik-Text.  “ob_spec”  zeigt  auf  eine 
TEDINFO-Struktur. 


GJMAGE  (23) 
G_USERDEF  (24) 


GJBOX  (25) 


G_BUTTON  (26) 


Ein  einfaches  Bild.  “ob_spec”  zeigt  auf  eine  BITBLK-Struktur. 

Dieser  Objekttyp  erlaubt  es,  eigene  Funktionen  zur  Ausgabe  zu 
definieren.  Die  AES  klimmem  sich  dabei  auf  Wunsch  um  die 
DarstellungderverschiedenenObjektzustande(siehe“ob„state”). 
“ob_spec”  zeigt  auf  eine  USERBLK-Struktur,  die  insbesondere 
einen  Zeiger  auf  eine  Ausgabefunktion  enthalt.  Dieser  Objekttyp 
wurde  urspriinglich  als  “G_PROGDEF”  bezeichnet. 

Unsichtbares  Rechteck  (ohne  Inneres).  Nur  wenn  die  Umrandung 
nicht  die  Dicke  Null  hat,  kann  man  es  sehen.  “ob_spec”  enthalt 
weitere  Mormationen  iiber  das  Aussehen. 

Zentrierter  Text  in  einem  Rechteck.  “ob_spec”  zeigt  auf  eine 
Zeichenkette  mit  dem  Text,  der  in  dem  Knopf  erscheinen  soli. 
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G_BOXCHAR  (27) 


G_STRING  (28) 
G_FTEXT  (29) 


Rechteck,  das  einen  einzigen  Buchstaben  enthalt.  In  “ob_spec” 
wird  nicht  nur  das  Aussehen  der  Umrandung,  sondem  auch  das 
Zeichen  definiert  (Detail  am  Rande:  Die  “Eckelemente”  der 
AES-Fenster  werden  intern  mit  diesem  Objekttyp  erzeugt). 

Zeichenkette.  “ob_spec”  zeigt  auf  den  entsprechenden  String  im 
Speicher. 

Formatierter  Grafik-Text.  “ob_spec”  zeigt  auf  eine  TEDINFO- 
Struktur. 


G_FBOXTEXT  (30)  Rechteck  mit  formatiertem  Grafik-Text.  “ob_spec”  zeigt  auf 

eine  TEDINFO-Struktur. 


G_ICON  (31)  Icon.  “objspec”  zeigt  auf  eine  ICONBLK-Struktur. 

G_TITLE  (32)  TiteleinesDrop-Down-Meniis.“ob_spec”zeigtaufeineZeichen- 

kette  im  Speicher. 


Viele  Bits  im  “ob  spec” 

Fur  G_BOX,  G_IBOX  und  G_BOXCHAR  zeigt  “ob_spec”  nicht  auf  eine  andere  Datenstruktur, 

sondem  enthalt  weitere  Informationen  zum  Aussehen  des  Objekts: 

Bit  24..3 1 :  Darzustellendes  Zeichen  (nur  bei  G_BOXCHAR,  ansonsten  unbenutzt) 

Bit  16..23:  0:  Rahmendicke  0  (kein  Rahmen) 

l  bis  128:  Der  Rand  liegt  1  bis  128  Pixel  im  Inneren  des  Objekts 
-1  bis  -127:  Der  Rand  liegt  1  bis  127  Pixel  auBerhalb  des  Objekts 

Bit  12..15:  Rahmenfarbe  (0..15) 

Bit  8. .11:  Textfarbe  (0..15) 

Bit  7:  Text  transparent  (0)  Oder  deckend  (1) 

Bit  4..6:  IP_HOLLOW  (0):  hohl 

BMPATT  (1):  ansteigende  Intensitat 
IP_2PATT  (2) 

BP_3PATT  (3) 
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IP_4PATT  (4) 

IP_5PATT  (5) 

IP_6PATT  (6) 

IP_SOLID  (7):  solide  Flache 
Bit0..3:  Innenfarbe  (0..15) 

Zum  vereinfachten  Zugriff  bietet  sich  die  Definition  eines  C-Bitfelds  an  (Voraussetzung  ist 
dabei  allerdings,  dafi  der  verwendete  C-Compiler  die  Bits  in  der  gleichen  “Richtung”  anordnet 
wie  das  hier  benutzte  Turbo-C): 


typedef  struct 

{ 

unsigned  character  :  8; 

signed  framesize  :  8; 

unsigned  framecol  :  4; 

unsigned  textcol  :  4; 

unsigned  textmode  :  1; 

unsigned  fillpattern  :  3; 

unsigned  interiorcol  :  4; 

}  bfobspec; 


Vorteii.  Zum  Zugriff  auf  einzelne  Teile  des  Bitfelds  kann  man  einfach  den  Namen  des  Feld- 
elements  angeben  -  ein  aufwendiges  Shiften  und  Ausmaskieren  von  Bits  entfallt.  Beispiel:  Die 
Textfarbe  erhalt  man  mit: 

Tree [ ob ] . ob_spec . obspec . textcol 


Objekt-Flags  (obflags) 

Fiir  jedes  Flag  wird  ein  Bit  in  “ob_flags”  benutzt.  AuBerdem  ist  meist  noch  die  Konstante 

“NONE”  (fiir  keine  Flags,  also  0)  vordefmiert. 

SELECTABLE  (0x0001)  Der  Benutzer  kann  das  Objekt  durch  Anklicken  selektieren. 

DEFAULT  (0x0002)  Hebt  normalerweise  das  Objekt  optisch  hervor  und  bedeutet,  daB 

das  Driicken  von  RETURN  mit  dem  Anklicken  dieses  Objekts 
gleichgesetzt  wird  (bei  Aufruf  von  “form_do()”).  Innerhalb 
eines  Dialoges  sollte  man  nur  bei  einem  Objekt  DEFAULT 
setzen. 
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EXIT  (0x0004)  “form_do()”  bricht  ab,  wenn  der  Benutzer  das  Objekt  anklickt. 

Man  beachte,  daB  die  AES  unter  “  Anklicken”  das  Niederdriicken 
und  Loslassen  einer  Maustaste  verstehen! 

EDITABLE  (0x0008)  Das  Objekt  ist  editierbar. 

RBUTTON  (0x0010)  Das  Objekt  ist  ein  sogenannter  Radioknopf  (radio  button).  Dies 

ist  eine  Metapher  aus  der  Zeit  der  Rundfunkgerate,  als  bei 
Anwahl  einer  Station  jeweils  die  anderen  Tasten  wieder  heraus- 
sprangen.  Auf  die  AES  iibertragen  bedeutet  dies,  da8  von  alien 
Objekten,  bei  denen  dieses  Flag  gesetzt  ist  und  die  in  der  gleichen 
Hierarchieebene  des  Objektbaums  stehen,  nur  eines  ausgewahlt 
sein  kann.  Wird  ein  anderes  angeklickt,  werden  alle  anderen 
automatisch  deselektiert, 

LASTOB  (0x0020)  Letztes  Objekt  im  Objektbaum-Feld.  Wird  zumindest  bei 

“form_do()”  beim  Durchsuchen  des  Baums  nach  DEFAULT- 
und  EDIT-Objekten  benotigt. 

TOUCHEXIT  (0x0040)  Diese  Bezeichnung  ist  ein  wenig  verwirrend  und  sollte  besser 

“CLICKEXrr”  lauten.  Wird  bei  “form_do()”  ein  solches  Objekt 
mit  gedriickter  Maustaste  beriihrt  (die  Maustaste  mu6  also  nicht 
erst  wieder  losgelassen  werden),  bricht  die  Funktion  ab  (und 
liefert  die  Objektnummer  des  beriihrten  Objekts). 

HIDETREE  (0x0080)  Versteckt  Objekt  und  alle  Unterobjekte.  Das  Objekt  wird  also 

nicht  nur  nicht  gezeichnet,  sondem  ist  auch  logisch  nicht  vorhan- 
den  (wichtigfiir  “objc_find()”!).  Editierbare  Objektekann  man 
ubrigens  auch  ausfiillen,  wenn  sie  versteckt  sind...  (prima  fiir 
Passwordeingaben...) 

INDIRECT  (0x0100)  Zeigt  an,  daB  in  “ob_spec”  ein  Zeiger  auf  den  eigentlichen 

“ob_spec”  steht. 

Alle  weiteren  Bits  sind  reserviert  und  sollten  laut  Digital  Research  auf  Null  gesetzt  werden. 

Objekt-Status  (obstate) 

Wahrend  die  “ob_flags”  in  erster  Linie  Informationen  tiber  die  Funktion  eines  Objekts 

enthalten,  beschreibt  der  Objekt-Status  den  Zustand.  des  Objekts  (oft  ist  auch  die  Konstante 

NORMAL  (0)  als  “Normalzustand”  vordefiniert). 
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SELECTED  (0x0001)  Das  Objekt  wird  hervorgehoben,  indem  es  invertiert  dargestellt 

wird.  Dieses  Bit  ist  iibrigens  immer  bei  dem  Objekt  gesetzt,  das 
das  Verlassen  eines  Dialoges  verursachthat,  und  sollte  deshalb 
beizeiten  wieder  geloscht  werden. 

CROSSED  (0x0002)  Im  Inneren  des  Objekts  (nur  fur  BOX-Objekte)  wird  ein  Kreuz 

gezeichnet. 

CHECKED  (0x0004)  Das  Objekt  wird  mit  einem  Hakchen  gezeichnet  (wird  beispiels- 

weise  bei  Eintragen  in  Drop-Down-Meniis  verwendet). 

DISABLED  (0x0008)  Das  Objekt  wird  grau  schattiert  gezeichnet  (normalerweise  bei 

Text).  Angezeigt  wird  damit,  daB  es  nicht  selektiert  werden 


OUTLINED  (0x0010)  Um  das  Objekt  wird  eine  zusatzliche  Umrandung  gezeichnet. 

SHADOWED  (0x0020)  Zusatzlich  wird  rechts  unter  dem  Objekt  ein  Schatten  gezeichnet 

(meistens  bei  BOX-Objekten). 

WHITEBAK  (0x0080)  Die  Icon-Maske  wird  nicht  mitgezeichnet.  Kann  die  Ausgabe 

beispielsweise  dann  beschleunigen,  wenn  der  Hintergrund  so- 
wieso  schon  weiB  ist  (nur  fur  PC-GEM  dokumentiert!) 

DRAW3D  (0x0040)  Nur  fiir  ICONBLK-Strukturen  und  auch  nur  ab  PC-GEM  2.0 

wird  ein  dreidimensionaler  Effekt  erzeugt,  indem  das  Icon 
dreimal  knapp  schrag  iibereinander  gezeichnet  wird. 

Objektfarben 

Folgende  Objektfarben  sind  vordefiniert  (das  hangt  natiirlich  von  der  gewahlten  Bildauflosung 
und  den  Einstellungen  des  Benutzers  ab): 

WHITE  (0)  WeiB 

BLACK  (1)  Schwarz 

RED  (2)  Rot 

GREEN  (3)  Griin 

BLUE  (4)  Blau 

CYAN  (5)  Cyan 

YELLOW  (6)  Gelb 

MAGENTA  (7)  Magenta 
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LWHITE  (8)  Hellgrau 

LBLACK  (9)  Dunkelgrau 

LRED  (10)  Hellrot 

LGREEN  (11)  Hellgriin 

LBLUE  (12)  Hellblau 

LCYAN  (13)  Hellcyan 

LYELLOW  (14)  Hellgelb 
LMAGENTA  (15)  Hellmagenta 


Die  Textinformations-Struktur  (TEDINFO) 

Ein  TEDINFO  hat  folgende  Struktur: 


typedef  struct 
{ 

char  *te_ptext; 
char  *tejptmplt; 
char  *te_pvalid; 
WORD  te__f ont ; 

WORD  te__resvdl; 
WORD  te_just; 

WORD  te_color; 
WORD  te_resvd2; 
WORD  te_thickness; 
WORD  te_txtlen; 
WORD  te__tmplen; 

}  TEDINFO; 


/*  Zeiger  auf  Text  */ 

/*  Zeiger  auf  Textmaske  */ 

/*  Zeiger  auf  Texttypmaske  */ 

/*  Zeichensatz  */ 

/*  reserviert  */ 

/*  Justifikation  */ 

/*  Farbe  des  betreffenden  Rechtecks  */ 
/*  reserviert  */ 

/*  Rahmen  */ 

/*  Lange  des  Textes  */ 

/*  Lange  der  Textmaske  */ 


Diese  Datenstruktur  wird  von  alien  Objekten  benutzt,  die  die  Eingabe  von  Text  zulassen. 
Die  einzelnen  Strukturelemente: 


te_ptext  Zeiger  auf  die  eigentliche  Zeichenkette  (die  durch  den  Editiervorgang  auch 
verandert  wird).  1st  das  erste  Zeichen  ein  (“Schneckennudel”  oder 
“Klammeraffe”),  werden  alle  folgenden  Zeichen  als  Platzhalter  angesehen, 
und  der  zunachst  ausgegebene  Text  besteht  aus  Leerzeichen  (“@2345678” 
liefert  beispielsweise  einen  acht  Leerzeichen  langen  String,  der  Klammeraffe 
wird  also  mitgezahlt).  Folge:  das  Zeichen  “@”  kann  niemals  am  Anfang  eines 
Edit-Felds  stehen!  Dieser  String  muB  genauso  lang  sein,  wie  in  “te_ptmplt” 
giiltige  Stellen  vorhanden  sind. 
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te_ptmplt  Dieser  String  enthalt  nicht  nur  den  Teil  der  Textinformation,  der  immer  gleich 

ist,  sondem  auch  eine  Maske  fur  die  Zeichen,  die  verandert  werden  diirfen. 
Dafiir  setzt  man  den  Unterstrich  ein,  der  allerdings  beim  Editieren  der  Texte 

mit  einem  RCS  meist  durch  die  Tilde  ersetzt  wird. 

te_pvalid  String,  der  fiir  jedes  Zeichen  in  “te_ptext”  eine  Zeichenkonstante  enthalt,  die 
iiber  die  Giiltigkeit  verschiedener  Zeichen  an  dieser  Stringposition  Auskunft 
gibt: 

“9”:  nur  Ziffern 

“A”:  nur  GroBbuchstaben  und  Leerzeichen 

“a”:  nur  Buchstaben  und  Leerzeichen 

“N”:  GroBbuchstaben,  Ziffern  und  Leerzeichen 

“n”:  Buchstaben,  Ziffern  und  Leerzeichen 

“F”:  alle  Zeichen,  die  zu  einem  Dateinamen  gehoren 

“P”:  alle  Zeichen,  die  zu  einem  Pfadnamen  gehoren 

“p”:  wie  “P”,  allerdings  ohne  “?”  und  “*” 

“X”;  alle  Zeichen 

Bemerkungen 

Unter  TOS  1 .00  fiihrt  die  Eingabe  eines  Unterstrichs  in  ein  nur  fiir  Ziffern  zugelassenes  Edit- 
Feld  zu  einem  Programmabsturz! 

Die  von  “F”,  “P”  und  “p”  zugelassenen  Zeichen  decken  sich  leider  nicht  mit  der  GEMDOS- 
Definition  eines  legalen  Datei-  bzw.  Pfadnamens. 

te_pfont  IBM  (3):  normaler  Zcichensatz  (verschieden  je  nach  Bildauflosung) 

SMALL  (5):  6*6-Systemzeiehensatz 

Bemerkungen 

Alle  bekannten  AES-Versionen  kommen  bei  “objc_edit()”  ausschlieBlich  mit  acht  Pixel 
breiten  Zeichensatzen  zurecht! 

tejust  TE_LEFT  (0):  linksbiindig 

TE_RIGHT  (1):  rechtsbiindig 

TE_CNTR  (2):  zcntriert 

te_color  Fiir  die  Farbe  des  begrenzenden  Rechtecks  sind  die  Bits  folgendermaBen 
belegt: 


Bit  12.. 15:  Rahmenfarbe  (0..15) 

Bit  8.. 11:  Textfarbe  (0..15) 
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Bit  7:  Text  transparent  (0)  oder  deckend  (1) 

Bit  4..6:  IP_HOLLOW  (0);  hohl 

UMPATT  (1):  ansteigende  Intensitat 

IP_2PATT  (2) 

IP_3PATT  (3) 

IP_4PATT  (4) 

IP_5PATT  (5) 

IP_6PATT  (6) 

IP_S0L1D  (7):  solide  Flache 

Bit  0..3:  Innenfarbe  (0..15) 

te_thickness  Fur  den  Rahmen  sind  folgende  Werte  giiltig: 

0:  Rahmendicke  0  (kein  Rahmen) 

1  bis  128:  Der  Rand  liegt  1  bis  128  Pixel  im  Inneren  des  Objekts, 

-1  bis  -127:  Der  Rand  liegt  1  bis  127  Pixel  auGerhalb  des  Objekts. 

Zur  Erlauterung  der  etwas  komplizierten  TEDINFO-Struktur  ein  Beispiel: 

te_ptext:  "301164" 

te„pvalid:  "999999" 

te_ptmplt:  "Bitte  Datum  angeben:  . .19 " 

Zunachst  fiigen  die  AES  den  Inhalt  von  “te_ptext”  in  die  mit  Unterstrichen  markierten  Positio- 
nen  von  “te_ptmplt”  ein: 

"Bitte  Datum  angeben:  30.11.1964" 

Die  Einfiigemarke  steht  zunachst  hinter  dem  letzten  Zeichen  von  “te_ptext”,  also  in  diesem 
Fall  am  Ende  der  Zeichenkette.  Der  Benutzer  kann  nun  neben  den  Ziffemtasten  (wegen 
“te_pvalid”)  innerhalb  des  Textes  mit  BACKSPACE,  DELETE,  den  Pfeiltasten  und  ESC 
(loscht  die  Eingabe)  editieren.  Nehmen  wir  als  Eingabe  “<ESC>231265”  an. 

Auf  dem  Bildschirm  sieht  es  dann  folgendermaGen  aus: 

"Bitte  Datum  angeben :  23.12. 1965" 

Wird  nun  der  Dialog  abgebrochen,  dann  enthalt  “te_ptext”  “231265”  -  also  genau  die  Eingabe 
des  Benutzers  bereinigt  von  alien  festen  Zeichen. 
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Die  Icon-Struktur  (ICONBLK) 

Was  ein  Icon  ist,  braucht  hier  sicherlich  nicht  mehr  erklart  zu  werden.  Wie  wird  es  jedoch  im 


Speicher  dargestellt? 

typedef  struct 
{ 

DWORD 

*ibj?inask; 

/* 

Zeiger  auf  Icon-Maske  */ 

UWORD 

*ib_j>data; 

/* 

Zeiger  auf  Icon-Daten  */ 

char 

*ibj?text; 

/* 

Zeiger  auf  Icon-Text  */ 

UWORD 

ib  char; 

/* 

Zeichen,  das  im  Icon  erscheinen 
soil,  und  Vorder-  und  Hintergrund¬ 
farbe  des  Icons  */ 

UWORD 

ib_xchar; 

/* 

dessen  X-Position  */ 

UWORD 

ib_ychar; 

/* 

dessen  Y-Position  */ 

UWORD 

ib_xicon; 

/* 

X-Position  des  Icons  */ 

UWORD 

ib_yicon; 

/* 

Y-Position  des  Icons  */ 

UWORD 

ib__wicon; 

/* 

Breite  des  Icons  */ 

UWORD 

ib_hicon; 

/* 

Hohe  des  Icons  */ 

WORD 

ib_xtext; 

/* 

X-Position  der  Beschriftung  */ 

WORD 

ib  ytext; 

/* 

Y-Position  der  Beschriftung  * / 

UWORD 

ib  wtext; 

/* 

Textbreite  in  Pixel  */ 

UWORD 

ib  htext; 

/* 

Texthohe  in  Pixel  */ 

UWORD 

}  ICONBLK; 

ib_resvd; 

/* 

reserviert  */ 

Die  einzelnen  Elemente  der  Struktur: 

ib_pmask  Ein  Zeiger  auf  ein  Feld  von  16-Bit-Werten,  in  denen  das  Bit-Image  der  Icon- 
Maske  abgelegt  ist.  Die  Icon-Maske  legt  fest,  an  welchen  Stellen  das  Icon 
iiberhaupt  gezeichnet  werden  sol!  und  welche  Pixel  “transparent”  bleiben  sol- 
len.  Erzielt  wird  dieser  Effekt  dadurch,  dab  der  Iconhintergrund  zunachst  mit 
den  Bits  der  Maske  “undiert”  und  dann  mit  den  Icondaten  “oderiert”  wird. 

ib_pdata  Zeiger  auf  das  eigentliche  Bild  des  Icons 

ipjptext  Zeiger  auf  den  Icontext 

ib_char  Bit  15..  12:  Vordergrundfarbe  des  Icons 
Bit  1 1..8:  Hintergrundfarbe  des  Icons 

Bit  7..0:  Das  Zeichen,  das  im  Icon  erscheinen  soli  (wie  der  Laufwerk- 

buchstabe  in  den  Desktop-Icons) 
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ib_xchar, 

ib_ychar  Position  des  Zeichens  innerhalb  des  Icons 
ib_xicon, 

ib_yicon  Position  des  Icons  auf  dem  Bildschinn.  Bei  Icons,  die  sich  innerhalb  eines 
Objektbaumes  befinden,  handelt  es  sich  um  die  relative  Position  zum  Mutter- 
objekt. 

ib_wicon, 

ib_hicon  Breite  (mu 6  ein  Vielfaches  von  16  sein)  und  Hflhe  des  Icons 
ib_xtext, 

ib_ytext  Position  der  Textzeile  innerhalb  des  Icons 
ib_wtext, 

ib_htext  Breite  und  Hohe  des  Icon-Textes 


ibjrcsv  Unbenutzt,  wird  allerdings  bei  den  meisten  RCS-Programmen  beim  Schreiben 
in  die  Resourcedatei  aufgenommen. 


Die  Bit-Image»Struktur  (BITBLK) 

Ein  Bit-Image  kann  man  immer  dortbenutzen,  wo  ein  nicht  anwahlbares  Icon  stehen  konnte. 
Der  entscheidende  Unterschied  ist  namlich,  daB  es  zu  einem  Bit  Image  keine  Maske  gibt. 

Die  Struktur: 

typedef  struct 
{ 

UWORD  *bi_pdata; 

UWORD  bi_wb; 

DWORD  bi_hl ; 

WORD  bi_x; 

WORD  bi_j/; 

WORD  bi_color; 

}  BITBLK; 

Die  einzelnen  Strukturelemente: 

bi_pdata  Zeiger  auf  Wort-Feld,  das  die  Bilddaten  enthalt  (siehe  unter  ib_pdata) 


/*  Zeiger  auf  Image  */ 

/*  Breite  in  Bytes  */ 

/*  H6he  in  Pixel zeilen  */ 
/*  X-Position  */ 

/*  Y~Position  */ 

/*  Farbe  */ 
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bi_wb  Breite  des  Images  in  Bytes  (mu8  durch  2  teilbar  sein) 

bi_W  Hohe  des  Images  in  Zeilen 

bi_x,bi_y  Position  des  Images 

bi_color  AES-Farbcode  fiir  das  Image 

Die  Application-Block-Struktur  (USERBLK) 

Schon  mal  iiber  “fehlende”  Objektformen  geargert?  Der  Objekttyp  “G_USERDEF”  erlaubt 
die  Definition  beliebiger  neuer  Objektarten.  “ob_spec”  zeigt  dabei  auf  eine  USERBLK- 
Struktur: 

typedef  struct 
{ 

WORD  (*ub__code)  (PARMBLK  *)  ; 

LONG  ub_parm; 

}  USERBLK; 

Dabei  ist  “ub_code”  ein  Zeiger  auf  eine  eigene  Funktion,  die  die  Darstellung  des  Objekts  voll 
iibemimmt.  Als  Parameter  erhalt  sie  einen  Zeiger  auf  eine  PARMBLK-Struktur: 


/*  Zeiger  auf  eigene  Funktion  */ 
/*  Ein  optionaler  Parameter  */ 


Die  Parameter-Block-Struktur  (PARMBLK) 

typedef  struct 
{ 


OBJECT 

*pb_tree; 

/*  Zeiger  auf  Objektbaum  */ 

WORD 

pb  obj; 

/*  Objektnummer  */ 

WORD 

pb_prevstate ;  /*  Vorheriger  Status  */ 

WORD 

pb_currstate;  /*  Neuer  Status  */ 

WORD 

pb_x; 

/*  X-Position  des  Objekts  */ 

WORD 

pb_y; 

/*  Y-Position  des  Objekts  */ 

WORD 

pb  w ; 

/*  Breite  */ 

WORD 

PbjN 

/*  Hohe  */ 

WORD 

pb_xc; 

/*  X-Position  des  Begrenzungsrechtecks  */ 

WORD 

pb  yc; 

/*  Y-Position  des  Begrenzungsrechtecks  */ 

WORD 

pb_wc; 

/*  Breite  des  Begrenzungsrechtecks  */ 

WORD 

pb  he; 

/*  Hohe  des  Begrenzungsrechtecks  */ 

LONG 

pb_parm; 

/*  Parameter  aus  USERBLK  */ 

}  PARMBLK; 
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In  dieser  S  truktur  werden  der  in  der  U  SERBLK-S  truktur  angegebenen  Funktion  eine  Fiille  von 
Informationen  fiber  das  Objekt  geliefert: 


pb_tree 

pb_obj 

pb_prevstate 

pb__currstate 


Anfangsadresse  des  betreffenden  Objektbaums 
Objektnummer  des  betreffenden  Objekts 
Status  des  Objekts  vor  der  aktuellen  Anderung 

Neuer  Status  des  Objekts  (nur  wenn  “pb_currstate”  und  “pb_prevstate” 
identisch  sind,  muB  das  Objekt  neu  gezeichnet  werden.  Anderenfalls  reicht 
ein  “Update”  des  Objektstatus). 


pb_x,pb_y, 

pb_w,pb_h  Position  und  MaBe  des  Objekts  in  absoluten  Bildschirmkoordinaten 
pb_xc,pb_yc, 

pb_wc,pb_hy  Position  und  Grofie  des  aktuellen  (bei  “objc„draw()”  angegebenen) 
Begrenzungsrechtecks  (clipping  rectangle).  Wenn  kein  Clipping  einge- 
schaltet  ist  (zum  Beispiel  bei  Objekten  in  Drop-Down-Menus),  dann  sind 
alle  Werte  Null. 


pb_parm  Der  optionale,  in  der  USERBLK-Struktur  angegebene  Parameter 


Zu  beachten  sind  folgende  Punkte: 


-  Die  eigene  Funktion  muB  im  Datenregister  DO  den  AES  zuriickliefem,  welche  Aspekte 

des  Objektstatus  noch  aktualisiert  werden  miissen.  Damit  ist  es  nicht  unbedingt  notig, 
in  der  eigenen  Ausgabefunktion  den  Code  zum  Invertieren  des  Objekts  auszuprogrammie- 
ren. 


Im  allgemeinen  wird  man  einige  Bits  des  Objektstatus  selbst  bearbeiten  wollen  und 
andere  den  AES  fiberlassen  (siehe  dazu  das  Beispiellisting  in  “Richtlinien  zur  Benutzer- 
fuhrung  und  Programmierung”). 

-  Die  Funktion  erhalt  den  PARMBLK-Zeiger  auf  dem  Stack  und  muB  daher  unter  Turbo- 
C  als  “cdecl”  deklariert  sein. 

Ein  vollstandiges  Neuzeichnen  des  Objekts  ist  nur  dann  notig,  wenn  “pb_prevstate”  und 
“pb_currstate”  gleich  sind.  Anderenfalls  hat  sich  nur  der  Objektstatus  geandert  (zum 
Beispiel  durch  Anklicken). 
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-  Die  eigene  Funktion  wird  de  facto  als  Unterprogramm  der  AES  ausgefiihrt.  Daher  sollte 
man  in  Hinsicht  auf  S  tackbenutzung  vorsichtig  sein.  Auflerdem  darf  man  natiirlich  keine 
weiteren  AES-Aufrufe  machen  (die  AES  sind  nicht  re-entrant!).  Aufrufe  der  VDI- 
Eingabefunktionen  hingegen  sind  an  dieser  S  telle  erlaubt! 

-  “pb_parm”  dient  dazu,  der  eigenen  Funktion  weitere  Informationen  -  wie  etwa  einen 
Zeiger  auf  einen  String  -  mit  auf  den  Weg  zu  geben  (vergleichbar  mit  dem  “ob_spec” 
in  der  Objekt-Struktur,  der  ja  bei  “G_USERDEF”-Objekten  bereits  durch  den  USERBLK- 
Zeiger  belegt  ist). 

-  Man  sollte  sich  nie  zu  weit  von  der  urspriinglichen  Optik  von  GEM  entfemen. 
Abgerundete  Rechtecke  oder  kursive  Texte  passen  sicherlich  nicht  in  das  normale 
Erscheinungsbild  einer  GEM-Applikation! 


Die  Formular-Bibliothek 


Einleitung 

Die  AES-Formular-Bibliothek  nimmt  sich  der  Verwaltung  von  Dialogboxen  (also  der 
Computerform  von  Formularen)  an.  Sie  bedient  sich  dabei  der  Objekt-Bibliothek,  die  fur  die 
Darstellung  der  einzelnen  Objekte  und  die  Verwaltung  von  Tasteneingaben  in  Edit-Felder 
verantwortlich  zeichnet. 

Direkt  zur  Verwaltung  der  Eingaben  in  Dialogboxen  ist  “form_do()”  bestimmt.  ‘Torm_do” 
wiederum  bedient  sich  dazu  der  Event-Funktionen  (um  Mausbewegungen  und  Tastendriicke 
zu  empfangen),  der  Objekt-Funktionen  (zum  Beispiel  fiir  die  Edit-Felder)  sowie  der  Formular- 
Funktionen  “form_keybd()”  und  “form_button()”. 

Details  konnen  Sie  dem  weiter  unten  angegebenen  Quelltext  von  “form_do()”  entnehmen.  Fiir 
das  eigentliche  Zeichnen  der  Dialogbox  ist  nicht  die  Formular-Bibliothek,  sondem 
“objc_draw()”  zustandig. 

**foim_dial()”  und  “form_centerO”  sind  spezielle  Hilfsroutinen  fiir  Dialogboxen,  die  zur  Vor- 
und  Nachbereitung  benutzt  werden  konnen.  “form_dial()”  sorgt  fiir  die  “Reservierung”  eines 
Bildschirmausschnitts  (zur  Zeit  eine  “leere”  Operation,  kann  sich  aber  durchaus  kiinftig 
andem),  das  Zeichnen  von  wachsenden  und  schrumpfenden  Rechtecken,  um  bei  bestimmten 
Operationen  mehr  Feedback  zu  bieten,  sowie  die  “Freigabe”  des  belegten  Bildschirmbereichs 
(was  zur  Zeit  Redraw-Nachrichten  an  die  betroffenen  Fenster  auslost).  Mit  “form_center()” 
wird  die  Dialogbox  auf  dem  Arbeitsbereich  des  Hintergrundfensters  (Fenster  0)  zentriert. 
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“form_alert()”  und  “form_error()”  schlieBlich  sind  “Frontends”,  die  auf  moglichst  einfache 
Art  und  Weise  Alarmboxen  erzeugen,  diese  anzeigen  und  auch  fur  die  Wiederherstellung  des 
belegten  Bildausschnitts  sorgen. 

Nahere  Informationen  dariiber,  auf  welche  Art  und  Weise  man  Dialogboxen  entwerfen  und 
programmieren  sollte,  entnehmen  Sie  bitte  dem  Kapitel  “Richtlinien  zurBenutzerfiihrung  und 
Programmierung”. 


Alarm-Boxen 

Alarm-Boxen  sind  eine  spezielle  Form  von  Dialogen,  bei  denen  man  auf  fiinf  Textzeilen  zu 
maximal  30  Zeichen,  ein  vordefiniertes  Bildsymbol  und  drei  Knopfe  zu  maximal  zehn  Zei- 
chen  begrenzt  ist.  Flir  die  Iconnummem  gilt: 

0:  Kein  Icon 

1 :  Ausrufezeichen  (Gefahr!) 

2:  Fragezeichen  (Nachfrage  vor  moglicherweise  gefahrlichen  Aktionen) 

3 :  Stopschild  (nun  ist  es  zu  spat  -  der  Fehler  ist  bereits  aufgetreten,  und  der  Benutzer  muB 
dariiber  informiert  werden) 

Die  Daten  flir  eine  Alarm-Box  werden  in  einem  String  folgenden  Formats  iibergeben: 

" [  >Icon-Nummer<  ] [  >Text<  ] [  >Knopfe<  ] " 

Dabei  ist  >Icon-Nummer<  eine  Zahl  zwischen  0  und  3  (als  ASCII-Zeichen),  >Text<  eine  oder 
mehrere  Textzeilen  (voneinander  durch  “I”  getrennt)  und  >Knopfe<  einer  oder  mehrere 
Knopfnamen  (ebenso  voneinander  getrennt). 

Ein  Beispiel: 

"[3) [Die  Datei  1 PBUCH.DOC  konnte | nicht  geschrieben  werden!] [  OK  ]  " 

Man  beachte  die  Leerzeichen  links  und  rechts  von  “OK”:  Sie  dienen  dazu,  dem  Knopf  eine 
sinnvolle  Mindestbreite  zu  verpassen. 

Eine  spezielle  Spielart  von  Alarm-Boxen  sind  die  Fehler-Boxen,  die  man  mittels  “form_error()” 
erzeugen  kann.  Bei  ibnen  ist  zu  beachten,  daB 
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-  der  Parameter  aus  Griinden  der  Kompatibilitat  zu  PC-GEM  eine  MS-DOS-Fehlemummer 
sein  muB 

-  daB  die  Texte  per  definitionem  in  der  gleichen  Landessprache  wie  das  benutzte  TOS 
erscheinen  und  daB 

-  es  nicht  fur  alle  GEMDOS-Fehlemummem  einen  passenden  Text  gibt. 

Ihr  Einsatz  bietet  sich  daher  nur  bei  kleineren  Programmen,  die  keiner  weiteren  Intemationali- 
sierung  bediirfen,  an. 


form_keybd()  und  form_button() 

Diese  beiden  Funktionen  sind  eine  Sache  fur  sich,  da  DR  sie  wissentlich  Oder  unwissentlich 
in  der  urspriinglichen  GEM-Dokumentation  weggelassen  hat.  Allerdings  sind  sie  sehr  wohl 
vorhanden  und  funktionieren  auch  so,  wie  sie  sollen. 

Um  sie  fur  das  DR-Entwicklungspaket  zu  installieren,  muB  man  folgendermaBen  vorgehen: 
Die  betreffenden  Funktionen  definiert  man  genau  so,  wie  in  der  AES-Referenz  angegeben. 
Zusatzlich  setzt  man  vor  den  ersten  Aufruf  im  Programm  die  Zeile 

ctrl_cnts [135 ] =3 ;  ctrl_cnts [136] =3;  ctrl_cnts [137] =1; 
ctrl_cnts [138]=2;  ctrl_cnts [139]=2;  ctrl_cnts [140]=1; 

Statt  dessen  kann  man  auch  mit  einem  Debugger  die  entsprechende  Stelle  in  der  Datei 
“apstart.o”  andem.  Bei  modemeren  Entwicklungssystemen  sind  diese  Funktionen  meistens 
schon  vorhanden. 

Beide  Funktionen  werden  intern  von  “form_do()”  zur  Bearbeitung  von  Formularen  benutzt. 
Dabei  kann  man  mit  “form_button()”  Mausknopf-Tastendriicke  simulieren  und  mit 
“foim_keybd()”  die  Giiltigkeit  eines  eingegebenen  Zeichens  an  einer  bestimmten  Position 
eines  editierbaren  Textfeldes  feststellen. 

Wie  das  genau  vor  sich  geht,  kann  man  am  besten  anhand  des  Quelltextes  von  “form_do()” 
verstehen: 

♦define  FMD_BACKWARD  -1 
# define  FMD_FORWARD  -2 
♦define  FMD  DEFLT  -3 


♦define  TRUE  1 
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/*  Objekt  bestimmten  Typs  suchen  */ 

WORD  find_object  (OBJECT  *tree,  WORD  start_object,  WORD  which) 

{ 

WORD  object,  flag,  theflag,  increment; 

object  =  0; 
flag  =  EDITABLE; 
increment  =  1; 

switch  (which) 

{ 

case  FMD_BACKWARD: 

increment  =  -If  /*  kein  Break!  */ 

case  FMD_FORWARD: 

object  =  start_object  +  increment; 
break; 

case  FMD_DEFLT: 

flag  =  DEFAULT; 
break; 

} 

while  (object  >=  0) 

1 

theflag  =  tree[object] .ob_flags; 

if  (theflag  &  flag) 
return  (object) ; 
if  (theflag  &  LASTOB) 

object  =  -1;  /*  Abbruch  */ 

else 

object  +=  increment; 

) 

return  start_object; 

1 

/*  Cursor  auf  St art f eld  */ 

WORD  ini_field  (OBJECT  *tree,  WORD  start_field) 

{ 

if  (start__field  —  0) 

start__field  =  find_object  (tree,  0,  FMD_FORWARD) ; 
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return  start  field; 


WORD  form_do  (OBJECT  *tree,  WORD  start_field) 

1 

WORD  edit_object,  next_object,  which,  cont; 

WORD  idx,  mx,  my,  mb,  ks,  kr,  br; 

wind_update  (BEG_UPDATE) ; 

next_object  =  ini_field  (tree,  start_field) ; 
edit__object  =  0; 

cont  =  TRUE; 

while  (cont) 

{ 

/*  ggfs.  Cursor  positionieren  */ 

if  ( (next__object  !=  0)  &&  (edit_object  !=  next_object) ) 

{ 

edit_object  =  next_object; 
next_object  =  0; 

objcjsdit  (tree,  edit^object,  0,  &idx,  ED_INIT) ; 

} 

/*  Maus-  Oder  Tastatur-Event  erwarten  */ 

which  =  evntjnulti  (MUJCEYBD | MU_BUTTON,  0x02,  0x01, 

0x01,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  OxOL, 

0,  0,  &mx,  &my,  &mb,  &ks,  &kr,  &br) ; 

if  (which  &  MU_KEYBD) 

{ 

cont  =  formjteybd  (tree,  edit_object,  next_object, 
kr,  &next__object,  &kr)  ; 

/*  kr  !=  0  ->  weiterverarbeiten !  */ 

if  (kr) 

obj c__edit  (tree,  edit_object,  kr,  &idx,  EDjCHAR)  ; 

} 
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if  (which  &  MU_BUTTON) 

{ 

next_object  =  objc_find  (tree,  0,  MAX_DEPTH,  mx,  my) ; 


if  (next_object  ==  -1) 

{ 

Bconout  (2,  7);  /*  Ping!  */ 

next_object  =  0; 

} 


} 


else 

cont  =  formjoutton  (tree,  next_object,  br, 
&next_object) ; 


/*  ggf.  Cursor  ausschalten  */ 


if  (icont  ||  ( (next_ob ject  !=  0)  && 

(next__object  !=  edit__object) ) ) 

{ 

objc_edit  (tree,  edit_object,  0,  &idx,  ED__END) ; 

} 

) 


wind_update  (ENDJDPDATE) ; 
return  next_object; 


Die  Grafik-Bibliothek 

Diese  Sammlung  von  Funktionen  ist  etwas  zusaramengewiiifelt  und  bietet  folgendes; 

-  Darstellung  von  Umrandungen  in  jeder  Variante  (schrumpfende,  sich  bewegende...).  In 
der  PC-Version  von  GEM  sind  diese  Funktionen  dera  in  der  Einleitung  erwahnten 
Rechtsstreit  zwischen  Digital  Research  und  Apple  zum  Opfer  gefallen. 

-  Anderung  des  Mauszeigers 

-  Abfrage  des  aktuellen  VDI-Handles  und  anderer  Informationen  liber  die  von  den  AES 
benutzte  VDI-Workstation 
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-  Abfrage  von  Position  und  Zustand  der  Maus  und  der  “Umschalt-Tasten”  Shift,  Control 

und  Alternate. 


Die  Scrap-Bibliothek 

Viele  Atari-Anwender  haben  sich  wahrscheinlich  schon  einmal  geffagt,  warum  bei  GEM  in 
keiner  Weise  die  beim  Apple  Macintosh  so  beliebte  “Zwischenablage”  verwirklicht  ist.  Die 
Antwort  konnte  glucklich  und  traurig  zugleich  stimmen:  Die  dafiir  notwendigen  Funktionen 
sind  namlich  allesamt  vorhanden  —  allerdings  werden  sie  nur  von  einer  kleinen  Zahl  von  Pro- 
grammen  richtig  benutzt. 

Einige  der  positiven  Ausnahmen  sind  “SciGraph”  (SciLab  GmbH),  “Clipboard”  (ein  Public- 
Domain-Programm  von  Dieter  und  Jiirgen  Geift),  “Gemini”  (der  alternative  Desktop)  und  - 
mit  Einschrankungen  -  “Wordplus”. 

Die  AES-Zwischenablage  ist  nichts  anderes  als  ein  ganz  normales  Verzeichnis  -  normalerwei- 
se  auf  einer  Festplatte.  Die  Funktionen  “scipjreadO”  und  Wscrp_write()”  dienen  lediglich  da- 
zu,  den  Namen  dieses  Verzeichnisses  zu  setzen  bzw.  abzufragen.  Leider  wirdim  Atari- AES 
kein  Verzeichnis  vorinitialisiert.  Daher  sollte  man  in  eigenen  Programmen  etwa  folgender- 
maBen  vorgehen: 

1 .  Verzeichnispfad  mit  “scrp_read()”  abfragen.  Wenn  das  Ergebnis  keine  leere  Zeichenkette 
ist,  dann  ist  man  schon  fertig  -  ein  anderes  Programm  hatbereits  den  Pfad  gesetzt.  Norma- 
lerweise  ist  der  Pfad  mit  abgeschlossen,  sonst  muB  man  es  selbst  anhangen. 

2.  Entscheiden,  wo  das  Clipboard  angelegt  werden  soil.  Vorschlag  von  Atari:  Falls  Lauf- 
werk  C:  existiert  (“DsetdrvO”  benutzen!),  das  Verzeichnis  “C:\CLIPBRD\”  benutzen. 
Andemfalls  “A:\CLIPBRD\”  nehmen  Oder  den  Benutzer  fragen.  Bei  notwendigem 
Anlegen  des  Verzeichnisses  sollte  man  nicht  vergessen,  mogliche  Fehler  korrekt  auszu- 
werten  (z.  B.  bei  schreibgeschutzten  Medien). 

Anderenfalls  gilt  es,  einen  anderen  Ort  zu  finden.  Normalerweise  versucht  man  es 
zunachst  mit  dem  Verzeichnis  “CLIPBRD”  im  Wurzelverzeichnis  des  Bootlaufwerks 
(siehe  Systemvariable  “_bootdev”).  Der  vollstandige  Pfad  ware  dann  also  “C:\CLIPBRD\”. 

3.  Sicherstellen,  daK  das  ausgewahlte  Verzeichnis  auch  tatsachlich  funktioniert  und 
beschreibbar  ist. 

Ebenso  wie  beim  Macintosh-Clipboard  kann  man  auch  unter  GEM  immer  nur  ein  Datenobjekt 
auf  einmal  ablegen. 
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Dabei  sind  allerdings  mehrere  Formate  moglieh.  Um  Daten  im  Clipboard  abzulegen,  muB  man 
also: 

1 .  alle  Clipboard-Dateien,  die  auf  die  Maske  “SCRAP.*”  passen,  loschen. 

2.  die  abzulegenden  Daten  in  einem  oder  mehreren  Formaten  sichern.  Der  Dateiname  ist 
dabei  immer  “SCRAP”,  die  Namenserweiterung  hangt  vom  gewahlten  Format  ab.  Nach 
Moglichkeit  sollte  immer  eines  der  folgenden  Standardformate  dabei  sein: 

TXT  ASCII-Textdatei,  jede  Zeile  mit  CR/LF  abgeschlossen 

GEM  GEM-Metadatei  (siehe  VDI-Dokumentation) 

IMG  GEM-Rasterbild  (siehe  Anhang) 

Zusatzlich  kann  man  eines  oder  mehrere  zusatzliche  Formate  unterstiitzen.  Der  Empfan- 
ger  hat  dann  die  Moglichkeit,  das  Format  mit  den  “meisten”  Informationen  zu  benutzen. 
Weitere  gebrauchliche  Formate  sind: 

ASC  ASCII-Textdatei,  jeder  Absatz  mit  CR/LF  abgeschlossen 

CSV  ASCH-Datei  mit  durch  Kommata  getrennten  Zahlen 

DIF  Export-Datei  von  Tabellenkalkulationen 

IWP  Wordplus-Format 

RTF  Microsoft  Rich  Text  Format 

EPS  Encapsulated  PostScript 

TEX  TeX 

CVG  Calamus  Vektorgrafik-Format 

Das  empfangende  Programm  sollte  zunachst  iiberpriifen,  welche  der  vorhandenen  Dateien  die 
meisten  Informationen  enthalt,  und  dann  diese  Datei  nehmen. 

Nochmals  zur  Erinnerung:  Jede  der  Dateien  enthalt  prinzipiell  die  gleichen  Informationen,  nur 
eben  in  einem  anderen  Format!  Wordplus  zum  Beispiel  importiert  “SCRAP.TXT”  nur  dann, 
wenn  “SCRAP.  1 WP”  nicht  gefunden  werden  konnte. 
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Beim  Import  von  Textdaten  aus  dem  Clipboard  sollte  man  Librigens  auch  mit  solchen  Dateien 
zurechtkommen,  bei  denen  das  “Carriage  Return”  am  Zeilenende  fehlt  und  nur  ein  “Linefeed” 
als  Zeilentrenner  benutzt  wird  -  viele  UNIX-basierten  Programme  legen  solche  Textdateien 
an! 

Wer  schon  einmal  an  einem  Macintosh  gearbeitet  hat,  wird  auch  das  “Album”-Accessory 
kennen,  das  anscheinend  mehrere  Datensatze  im  Clipboard  verwaltet.  Auch  das  konnte  man 
unter  GEM  leicht  verwirklichen:  Man  braucht  nur  ein  Accessory,  das  eine  kleine  “Datenbank” 
fiir  Dateien  in  verschiedenen  Formaten  bereitstellt  und  Daten  aus  dem  Clipboard  importieren 
und  in  das  Clipboard  exportieren  kann. 

Fiir  die  aktuelle  GEM-Realitat  ist  das  AES-Clipboard  zwar  brauchbar,  aber  teilweise  nur 
schwierig  zu  benutzen.  Die  wichtigsten  Einschrankungen  sind: 

-  Es  gibt  keine  Standardnachricht,  mit  der  anderen  Prozessen  mitgeteilt  werden  konnte, 
daB  sich  der  Inhalt  des  Clipboards  geandert  hat. 

Eine  direkte  Kommunikation  wie  beim  “DDE”  (Dynamic  Data  Exchange)  unter 
Microsoft  Windows  ist  nicht  mijglich. 

Beide  Probleme  werden  mit  einiger  Sicherheit  in  einer  multitaskingfahigen  GEM-Version 
beseitigt  werden. 


Die  Dateiauswahl-Bibliothek 

Die  Dateiauswahlbox  braucht  kaum  noch  genau  erklart  zu  werden  -  jedem,  der  schon  einmal 
eine  GEM-Anwendung  benutzt  hat,  ist  sie  bekannt.  Im  GEM  1.0  war  sie  noch  ob  ihrer 
Unzuveriassigkeit  (Absturze,  Limit  fiir  die  Anzahl  der  Dateien)  und  der  unpraktischen 
Bedienung  (Laufwerkswahl  ausschlieBlich  per  Tastatur)  sehr  unbeliebt.  Seit  GEM  1.4  ist  sie 
nun  aber  nicht  nur  relativ  stabil,  sondem  auch  komfortabel  zu  bedienen. 

Dennoch  seien  noch  einmal  kurz  die  Vorteile  aufgezahlt: 

Der  Anwender  kann  sehen,  welche  Dateien  es  gibt,  und  lauft  nicht  Gefahr,  sich  bei  der 
Eingabe  des  Namens  zu  vertippen. 

-  Die  Dateiauswalil  funktioniert  in  alien  Programmen  auf  gleiche  Art  und  Weise. 

-  Residente  Programme  konnen  den  Betriebssystemauffuf  abfangen  und  eine  eigene, 
leistungsfahigere  Routine  installieren,  die  dann  von  alien  Programmen  benutzt  wird. 
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-  Minimaler  Aufwand  beim  aufrufenden  Programm. 

-  Das  eigene  Programm  braucht  sich  nicht  urn  die  Details  des  verwendeten  Dateisystems 
zu  kiimmem. 

Doch  es  gibt  auch  Nachteile,  die  nicht  verschwiegen  werden  sollen: 

-  Vor  GEM  1.4  relativ  fehleranfallig  bei  kritischen  BIOS-Fehlem. 

-  Vor  GEM  1.4  keine  Mbglichkeit,  einen  erklarenden  Text  in  die  Dialogbox  aufzunehmen 
(siehe  “fsel_exinput()”). 

-  Es  werden  nicht  alle  fiir  Dateinamen  erlaubten  Zeichen  akzeptiert  (siehe  GEMDOS- 
Einleitung).  Andererseits  konnen  einige  Zeichen  eingegeben  werden,  die  eigentlich 
nicht  in  Dateinamen  auftreten  dtirfen  (wie  zum  Beispiel  nationale  Sonderzeichen). 

-  Es  konnen  nicht  alle  vorhandenen  Laufwerke  direkt  angewahlt  werden  (unter  Meta-DOS 
kann  es  bis  zu  26  Laufwerke  geben). 

-  Eigene  Verbesserungen  bei  der  Dialogbehandlung  (Tastaturbedienung,  automatisches 
Sichem  des  Bildschirmhintergrunds)  konnen  nicht  iibertragen  werden. 

-  In  der  Pfadangabe  kann  nur  eine  Suchmaske  anstelle  einer  Liste  von  Suchmasken  wie 
unter  PC-GEM  angegeben  werden. 

Wer  es  aus  den  oben  genannten  Griinden  fiir  notig  halt,  start  dessen  eine  eigene  Routine  zu 

benutzen,  sollte  folgende  Ratschlage  beherzigen: 

-  Als  Option  die  normale  Systemfunktion  anbieten. 

-  Fest  eingefahrene  Gewohnheiten  der  Benutzer  nicht  unnotig  storen! 


Die  Fenster-Bibliothek 

Einleitung 

Mit  Fenstem  diirfte  jeder  Atari-Programmierer  vertraut  sein  -  schlieBlich  kennt  man  sie  aus 
Desktop  und  vielen  anderen  GEM-Applikationen.  Doch  bevor  wir  uns  den  technischen  Details 
zuwenden,  soli  erst  einmal  die  gar  nicht  so  dumme  Frage  untersucht  werden,  wozu  es  eigent- 
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lich  Fenster  gibt  -  schlieBlich  laBt  sich  nicht  bestreiten,  daB  sie  auch  wertvolle  Bildschirmflache 
wegnehmen. 

Ein  wichtiger  Grand  ist  die  Multitaskingfahigkeit  von  GEM  -  auch  wenn  in  den  aktuellen 
Versionen  nur  ein  Hauptprogramm  und  sechs  Accessories  moglich  sind.  Wie  -  wenn  nicht  mit 
Hilfe  von  mehreren,  iiberlappenden  Fenstem  -  sollte  es  moglich  sein,  die  Bildschirmausgaben 
mehrerer  AES-Prozesse  zu  koordinieren?  Wer  also  in  eigenen  Programmen  egoistisch  unter 
Umgehung  des  Fenstersystems  direkt  auf  den  Bildschirmhintergrand  ausgibt,  nimmt  den 
Anwendem  die  Moglichkeit,  die  Multitaskingmoglichkeiten  der  AES  zu  nutzen. 

Auch  die  groBe  Vielfalt  von  Bildschirmen  (von  320  *  200  Punkten  auf  dem  ST  bis  zu  Auf- 
losungen  von  iiber  1000  *  1000  Pixeln  in  16  Millionen  Farben)  lassen  die  Direktausgabe  auf 
dem  Hintergrand  wie  einen  schlechten  Scherz  erscheinen. 

Niemand  wird  sich  einen  GroBbildschirm  kaufen,  um  in  der  Textverarbeitung  160  Zeichen  in 
eine  Textzeile  zu  zwangen.  Nur  mit  verschiebbaren  und  in  der  GroBe  verstellbaren  Fenstem 
kann  sich  ein  Programm  sinvoll  an  jedes  Bildschirmformat  anpassen. 

Und  schlieBlich  ist  es  fiir  GEM-Anwendungen  Standard,  daB  sie  mehrere  Dokumente  gleich- 
zeitig  bearbeiten  konnen,  schon  um  das  Ausschneiden  und  Einfiigen  von  Dokumentteilen  zu 
ermoglichen.  Wie  anders  als  durch  die  Nutzung  der  GEM-Fenster  sollte  man  dieses  Ziel  kom- 
fortabel  erreichen? 


Konzept 

Um  die  AES-Fensterfunktionen  korrekt  und  effizient  benutzen  zu  konnen,  muB  man  ihre 
Funktionsweise  genau  verstehen.  Daher  zuerst  eine  Liste  von  Funktionen,  um  die  sich  die  AES 
nicht  kiimmem: 

-  Die  Verwaltung  von  Koordinaten:  Programme,  die  Bildschinmausgaben  in  Fenstem 
machen  wollen,  miissen  Koordinaten  im  Fenster  selbsttatig  in  absolute  Bildschiimkoor- 
dinaten  umrechnen. 

-  Das  Puffem  von  Bildausschnitten:  die  AES-Fensterfunktionen  bieten  keine  Moglichkeit, 
diese  Aufgabe  den  Programmen  abzunehmen.  Statt  dessen  werden  Nachrichten  ver- 
schickt,  die  iiber  die  neu  zu  zeichnenden  Bildausschnitte  Auskunft  geben. 

Man  tut  also  gut  daran,  sich  die  AES-Fensterbibliothek  zunachst  nur  als  eine  Sammlung  von 
Routinen  vorzustellen,  die  sich  mit  der  Verwaltung  rechteckiger  Bildausschnitte,  der  Fenster, 
befaBt. 
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Rechteckliste 

Fenster  konnen  sich  bekanntlich  gegenseitig  iiberlappen.  Die  AES  nehmen  sich  dieses  Pro¬ 
blems  an,  in  dem  sie  fiir  jedes  Fenster  die  sichtbaren  Ausschnitte  in  mehrere  Rechtecke  auftei- 
len.  Gemeinsam  bilden  sie  die  “Rechteckliste”  eines  Fensters,  die  ein  Programm  mit  mehreren 
aufeinanderfolgenden  Aufrufen  der  Fensterbibliothek  erfragen  kann. 

Dabei  beachte  man,  daB  Fenster  auch  teilweise  auBerhalb  des  Bildschirms  liegen  konnen  - 
man  mu6  also  erst  die  Schnittflache  der  Rechtecke  mit  dem  sichtbaren  Bildschirm  bilden. 

Dazu  eine  Beispielfunktion: 

/*  GEM-Standardstruktur  fiir  Rechtecke  */ 

typedef  struct 

{ 

WORD  g_x;  /*  X-Position  */ 

WORD  g_y;  /*  Y-Position  */ 

WORD  g_w;  /*  Breite  */ 

WORD  g_h;  /*  Hohe  */ 

}  GRECT; 

/*  Schnittflache  zweier  Rechtecke  bilden.  Der  Returnwert  ist  genau 
dann  Null,  wenn  sich  die  Rechtecke  nicht  uberschneiden .  Die 
zweite  GRECT-Struktur  wird  mit  den  Koordinaten  der  Schnittflache 
iiberschrieben  */ 

WORD  rcjLntersect  (GRECT  *pl,  GRECT  *p2) 

{ 

WORD  tx,  ty,  tw,  th; 

tw  =  min  (p2->gx  +  p2->gw,  pl->gx  +  pl->gw) ; 

th  =  min  (p2->gy  +  p2->gh,  pl~>gy  +  pl->gh) ; 

tx  =  max  (p2->gx,  pl->gx) ; 

ty  =  max  (p2->gy,  pl->gy) ; 

p2->gx  =  tx; 

p2~>gy  =  ty; 

p2->gw  -  tw  -  tx; 

p2->gh  =  th  -  ty; 

return  ( (tw  >  tx)  &&  (th  >  ty) ) ; 


) 
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Die  Rechtecklisten  andem  sich  natiiiiich  jedesmal  dann,  wenn  irgendetwas  an  den  Fenstem 
verandert  wird  (Lage  oder  Grofie,  Reihenfolge,  Anzahl  etc.).  Fatal  ware  natiirlich,  wenn  dies 
wahrend  der  Abfrage  der  Rechteckliste  und  damit  verbundenen  Bildschirmausgaben  stattfin- 
den  wiirde.  Die  AES  bieten  daher  ein  spezielles  ProtokoU  an:  Jedes  Programm,  das  Rechteckli¬ 
sten  abrufen  und  dabei  Bildschirmausgaben  machen  mochte,  mull  dies  mit  der  Funktion 
“  wind_update()”  anktindigen.  Damit  haben  die  AES  die  Moglichkeit,  bei  Bedarf  den  aufrufen- 
den  ProzeB  so  lange  zu  blockieren,  bis  er  gefahrlos  weiterarbeiten  kann. 

Kontrollelemente 

Damit  sind  natiirlich  noch  nicht  alle  Aufgaben  der  Fensterfunktionen  genannt  -  zu  einem 
Fenster  gehoren  nicht  nur  der  “Arbeitsbereich”  (“work  area”),  in  den  Programme  ausgeben 
diirfen,  sondem  auch  die  “Kontrollelemente”,  wie  SchlieBbox  Oder  Slider.  Fiir  die  Verwaltung 
dieser  Fensterelemente  ist  allein  der  Screen  Manager  zustandig.  Das  Anwendungsprogramm 
gibt  beim  Anlegen  des  Fensters  lediglich  an,  welche  Elemente  benutzt  werden  sollen. 

Die  Interaktion  mit  den  Kontrollelementen  wird  vollstandig  vom  Screen  Manager  iibemom- 
men.  Soisteres,  der  beim  Verandem  der  FenstergroBe  die  neuen  Umrisse  des  Fensters  anzeigt. 
Hat  dann  am  Ende  tatsiichlich  eine  Veranderung  stattgefunden,  wird  eine  entsprechende 
Mitteilung  an  den  Besitzer  des  betreffenden  Fensters  geschickt.  Konsequenz  ist,  daB  das 
Anwendungsprogramm  die  endgiiltige  Entscheidung  dariiber  trifft,  ob  und  wie  es  die  Wiin- 
sche  des  Benutzers  erfiillt. 

Diese  Freiheit  darf  man  freilich  nicht  miBbrauchen.  Wenn  man  beispielsweise  nicht  auf  eine 
WM_CLOSE-Mitteilung  zu  reagieren  gedenkt,  sollte  man  gar  nicht  erst  ein  SchlieB-Feld 
erscheinen  lassen!  Vollig  unakzeptabel  ist  es,  Fenster-Kontrollelemente  fur  andere  Zwecke 
-  etwa  die  Umschaltung  zwischen  zwei  verschiedenen  Betriebsarten  -  zu  miBbrauchen. 

Hier  eine  Liste  der  Kontrollelemente  und  der  Reaktionen,  die  normalerweise  damit  verbunden 
sein  sollten: 

Titelzeile  T  ext,  der  im  oberen  Fensterrand  als  Beschriftung  erscheint.  Sollte  laut  Original- 

Dokumentation  maximal  80  Zeichen  umfassen.  Normalerweise  werden  am 
Anfang  und  am  Ende  je  ein  Leerzeichen  angefiigt. 

Infozeile  Zusatzliche  Informationszeile,  die  normalerweise  unterhalb  der  Titelzeile  auf- 
taucht  und  ebenso  bis  zu  80  Zeichen  Text  aufnehmen  kann. 

SchlieBfeld  Kleine  Box  zum  SchlieBen  des  Fensters  (normalerweise  links  oben  in  derEcke). 
Ein  Mausklick  hierhin  fiihrt  zu  einer  “WM_CLOSE”-Nachricht. 
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Voile  GroCe  “Fullbox”  -  kleine  Box  zur  Umschaltung  zwischen  maximaler  und 

aktueller  Fenstergrofie  (normalerweise  rechts  oben  in  der  Ecke).  Ein 
Anklicken  der  “Fullbox”  zieht  eine  “WM_FULLED”-Nachricht  nach 
sieh. 

Bewegungsbalken  “Move  bar”  -  nimmt  den  gleichen  Platz  wie  die  Titelzeile  ein  und 
erlaubt  es  dem  Anwender,  mit  Hilfe  einer  UmriBlinie  das  Fenster  neu 
zu  positionieren.  Resultat  ist  eine  “WM_MOVED”-Mitteilung. 

GroBenfeld  Kleine  Box  rechts  unten  im  Fenster,  die  eine  Veranderung  der 

Fenstergrofie  ermoglicht.  Der  Anwender  sieht  dabei  nur  einen  Umrifi 
mit  der  neuen  Fenstergrofie.  Nach  Abschlufi  der  Operation  wird  eine 
“WM_SIZED”-Mitteilung  verschickt. 

Aufwarts-Pfeil  Kleine  Box  mit  Aufwartspfeil  am  rechten  Fensterrand.  Nach  Anklicken 

erhalt  das  Programm  eine  “WM_ARROWED”-Mitteilung. 

Abwarts-Pfeil 

Rechts-Pfeil 

Links-Pfeil  Analog  zum  Aufwarts-Pfeil. 

Vertikaler  Balken  Dieses  Kontrollelement  liegt  zwischen  Aufwarts-  und  Abwartspfeil 
und  besteht  aus  einem  Hintergrundobjekt  und  dem  Slider.  Die  Grofie 
des  Sliders  zeigt  dabei  an,  wie  sich  der  sichtbare  Anted  zur  Dokument- 
grofie  verhalt.  Mausklicks  fiber  und  unter  den  Slider  fiihren  zu 
“WM_ARROWED”-MitteiIungen,  die  als  Aufforderung,  um  einen 
Fensterinhalt  in  die  betreffende  Richtung  zu  blattem,  interpretiert  wer- 
den  sollten.  Ein  Verschieben  des  Sliders  zieht  eine  “  WM_VSLID”-Mit- 
teilung  nach  sich. 

Horizontaler  Balken  Analog  zum  vertikalen  Balken. 

Achtung:  Man  darf  niemals  Annahmen  fiber  Grofie,  Lage  und  Position  der  Fensterelemente 
machen  -  es  ist  durchaus  moglich,  den  AES  einen  anderen  Fenstermanager  unterzuschieben, 
bei  dem  die  Fensterkontrollen  ganz  anders  aussehen  und  auch  an  anderer  Stelle  liegen.  Die 
Funktion  “wind_calc()”  erlaubt  es,  auf  portable  Art  und  Weise  aus  der  Gesamtflache  den 
Arbeitsbereich  (und  umgekehrt)  zu  berechnen. 

Ab  Atari-GEM  3.0  kann  man  mit  “wind_set()”  jedem  Kontrollelement  eigene  Farben  und 
FUllmuster  zuordnen  -  und  zwar  getrennt  fur  akti  ve  und  inaktive  Fenster.  Die  Einstellung  kann 
entweder  fiir  ein  spezielles  Oder  als  Default  fur  alle  neu  erzeugten  Fenster  geschehen.  Diese 
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Aufgabe  wird  normalerweise  vom  XCONTROL-Modul  “Fensterfarben”  iibemommen.  Lei- 
der  ist  es  nicht  moglich,  die  aktuellen  Einstellungen  abzufragen. 


Das  Desktop-Fenster 

Eine  besondere  Rolle  nimmt  Fenster  Null,  das  Desktop-  Oder  Hintergrund-Fenster,  ein.  Es 
nimmt  die  gesamte  Bildschirmflache  in  Anspruch,  ist  immer  geoffnet  und  kann  auch  nicht 
geschlossen  werden.  Der  Arbeitsbereich  ist  die  Flache  unter  der  Meniileiste.  Nur  in  diesem 
Arbeitsbereich  diirfen  andere  Programme  Bildschiimausgaben  machen  oder  eigene  Fenster 
offnen. 

Normalerweise  erscheint  der  Arbeitsbereich  des  Desktop-Fensters  als  solide  grime  Flache  (bei 
Farbbetrieb)  bzw.  als  graues  Raster  (auf  monochromen  Bildschirmen).  Der  Screen  Manager 
kummert  sich  vollig  selbsttatig  um  den  Redraw.  Anwendungsprogramnie  konnen  mittels 
“wind_set()”  einen  beliebigen  anderen  Objektbaum  als  Hintergrund  verankem.  Auch  dann 
kiimmert  sich  der  Screen  Manager  um  das  fallige  Neuzeichnen  von  Bildausschnitten.  Ein 
bekanntes  Beispiel  ist  das  Desktop,  das  die  Laufwerkssymbole  als  eigenstandige  Objekte  im 
selbstinstallierten  Objektbaum  verwaltet.  Obwohl  diese  Moglichkeitnatiirlich  sehr  verlockend 
ist,  gibt  es  etliche  Griinde,  die  gegen  eine  Benutzung  des  Desktop-Fensters  sprechen: 

-  Unter  Atari-GEM  ist  es  nicht  moglich,  auf  saubere  Art  und  Weise  Farbe  und  Fiillmuster 
des  Standardhintergrunds  abzufragen.  Die  Folge  ist  die  sehr  haBliche  Anderung  der 
Hintergrundfarbe  beim  Starten  von  Programmen,  die  einen  eigenen  Hintergrund  instal- 
lieren. 

-  Auch  unter  einem  multitaskingfahigen  GEM  kann  es  nur  einen  Bildschirmhintergrund 
geben.  Der  sollte  dem  Programm  vorbehalten  bleiben,  das  daraus  den  meisten  Nutzen 
ziehen  kann  -  und  das  ist  das  Desktop  bzw.  ein  Programm,  das  als  Desktop-Ersatz  konzi- 
piert  ist  (auf  dem  Macintosh  sieht  es  iibrigens  genauso  aus:  Nur  der  “Finder”  greift  auf 
den  Bildschirmhintergrund  zu). 

Fazit:  Der  Desktophintergrund  sollte  nach  Moglichkeit  in  eigenen  ProgTammen  nicht  benutzt 
werden. 


Implementation 

Alle  von  den  AES  ftir  Fenster  benutzten  Datenstrukturen  sind  statisch,  haben  also  eine  fixe 
Lange.  Das  liegt  nicht  etwa  daran,  daB  die  Programmierer  von  Digital  Research  zu  dumm  fur 
eine  dynamische  Verwaltung  waren.  Der  Grund  ist  vielmehr  darin  zu  suchen,  daB  ein  dyna- 
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misches  Nach-Anfordem  von  Speicher  beim  Beenden  von  Programmen  zu  einer  haBlichen 
Zersplitterung  des  freien  Speichers  fiihren  wiirde. 

Die  Folge  ist,  daB  die  Fensterzahl  auf  das  kleinstmogliche  Level  festgesetzt  worden  ist:  fiir 
jeden  AES-ProzeB  mindestens  ein  Fenster. 

So  kommt  es  zur  Maximalzahl  von  acht  Fenstem  in  der  aktuellen  AES-Version.  Zu  beachten 
ist  auch  noch,  dab  jedes  zusatzliche  Fenster  die  Maximallange  einer  Rechteckliste  erhoht  - 
und  auch  die  wird  in  einem  festen  Speicherbereich  abgelegt. 

Auch  wenn  man  nur  selten  wirklich  mehr  als  die  vorhandenen  Fenster  benotigt,  ware  es  schon, 
kbnnte  man  vor  Start  der  AES  auf  irgendeine  Weise  die  Maximalzahl  einstellen.  Vielleicht 
kann  sich  Atari  ja  eines  Tages  mal  mit  dieser  Idee  anfreunden. 

VieleGEM-Applikationen,  so  auch  das  Desktop  vor  Atari-GEM  3.0,  schranken  sich  freiwillig 
auf  vier  Fenster  ein,  um  fur  Accessories  Fenster  freizuhalten.  Diese  Vorsicht  ist  allerdings  aus 
vielerlei  Griinden  nicht  zu  empfehlen: 

-  Kilnftige  AES-Versionen  werden  definitiv  mehr  Fenster  gleichzeitig  offnen  konnen. 

-  Jedes  Programm,  das  Fenster  benutzt,  muB  mit  einem  Fehler  bei  “wind_create()”  rech- 
nen-  Daher  ist  es  nicht  besonders  sinnvoll,  dem  Anwender  unnotige  Einschrankungen 
aufzuerlegen. 


Prinzipielle  Yorgehensweise 

Wenn  man  Fenster  in  eigenen  Programmen  benutzen  will,  sollte  man  in  etwa  folgendermaBen 
vorgehen: 

1 .  Die  Grofie  der  verfiigbaren  Bildschirmflache  feststellen.  Das  macht  man  mit  “  wind_get()” 
(“wLgfield”:  WF_WORKXYWH)  fiir  Fenster  Null  (das  Desktop-Fenster). 

2.  Mit  “wind_calc()”  berechnet  man  sodann,  wie  groB  der  Arbeitsbereich  des  Fensters  bei 
gegebenen  Randkomponenten  werden  kann. 

3 .  Man  vergleicht  die  erhaltenen  Werte  mit  der  gewtinschten  Grofie  (und  argert  sich,  wenn 
nicht  genug  Platz  ist). 

Die  so  festgelegte  GroGe  des  Arbeitsbereiches  wird  zusammen  mit  den  Randkomponenten 
in  “wind_calc()”  eingespeist,  welches  daraus  die  AuBenmaGe  des  Fensters  berechnet. 


4. 
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5.  Das  Fenster  wird  unter  Angabe  dieser  AuBenmaBe  und  der  Fensterkomponenten 
angemeldet  (“wind_create()”).  Dabei  erhalt  man  entweder  eine  Fehlermeldung  oder  die 
Kennung  des  neuen  Fensters. 

6.  Das  Fenster  wird  mit  “wind_open()”  auf  den  Bildschirm  gebracht.  Dies  lost  automatisch 
eine  Redraw-Mitteilung  iiber  die  Arbeitsflache  des  Fensters  aus. 

7.  Das  Fenster  wird  vom  Programm  benutzt... 

8.  Mit  “wind_close()”  wird  das  Fenster  vom  Bildschirm  geloscht,  kann  aber  immer  noch 
mit  “wind_open()”  emeut  geoffnet  werden. 

9.  “wind_delete()”  entfemt  das  Fenster  endgiiltig  aus  dem  Speicher  und  gibt  insbesondere 
die  Fensterkennung  fiir  andere  Fenster  frei. 

Zum  Redraw  eines  Fensterausschnitts  verfahrt  man  wie  folgt: 

/*  Ausschnitt  "area"  in  Fenster  "wh"  neuzeichnen.  Basiert  auf 
Beispielfunktion  aus  "Professional  GEM"  (Tim  Oren)  */ 

void  redraw  (WORD  wh,  GRECT  *area) 

{ 

GRECT  box,  full; 

grafjnouse  (M_OFF,  NULL) ;  /*  Maus  ausschalten  */ 

windjupdate  (BEG_UPDATE) ;  /*  Rechteckliste  sperren  */ 

/*  Arbeitsbereich  von  Fenster  Null  abfragen  */ 
wind_get  (0,  WF_WORKXYWH,  &full.g_x,  &full.g_y,  &full.g_h, 
&full.g_w) ; 

/*  erstes  Element  der  Rechteckliste  erfragen  */ 
wind_get  (wh,  WF_FIRSTXYWH,  &box.g_x,  &box.g_y,  &box.g_w, 
&box.g_h) ; 

/*  solange  giiltiges  Rechteck  (Breite  und  Hohe  ungleich  Null)*/ 
while  (box.g_w  &&  box.g_h) 

{ 

if  (rcjlntersect  (Sfull,  &box) )  /*  sichtbar  */ 

{ 

if  ( rc_intersect  (area,  &box) )  /*  Uberlappung?  */ 
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{ 

/*  Clipping  auf  Bereich  "box"  setzen  und 
Fensterinhalt  neu  ausgeben  */ 

} 


/*  nachstes  Element  der  Rechteckliste  erfragen  */ 


} 


wind__get  (wh,  WF_NEXTX¥WH,  &box.g_x,  &box.g_y,  &box.g_w, 
&box.g_h) ; 


wind_update  (END_UPDATE) ; 
graf jmouse  (M_ON,  NULL) ; 


Tips 

Und  hier  noch  ein  paar  weitere  Hinweise  zu  den  Fenster-Funktionen: 

-  Viele  Programme  erlauben  es ,  beim  Verlassen  Position  und  GroBe  der  geoffheten  Fenster 
zu  speichem,  Diese  Daten  sollte  man  immer  auflosungsunabhangig  (also  zum  Beispiel 
relativ  zu  einem  “normalisierten”  Koordinatensystem  von  32768  *  32768  Punkten) 
speichem.  Anderenfallskann  es  zu  so  unschonen  Effekten  wiebei  “Wordplus’’kommen 
(Fenster  erscheinen  innerhalb  der  Menuleiste  oder  auBerhalb  des  sichtbaren  Bildschirmbe- 
reichs). 

-  In  einigen  Programmen  werden  Fenster  an  der  horizontalen  Position  “-1  ”  geoffnet,  urn 
den  Arbei  tsbereich  des  Fensters  an  Position  0  beginnen  zu  lassen.  Dabei  verlaBt  man  sich 
nicht  nur  auf  die  nicht-dokumentierte  Tatsache,  daB  die  AES  negative  Koordinaten 
korrekt  verarbeiten,  sondem  macht  auch  eine  unsichere  Annahme  tiber  die  Breite  der 
Fensterrander. 

Hinzu  kommt,  daR  nicht  bei  alien  Bildschirmen  der  Bildrand  schwarz  ist,  so  daR  man  nur 
schwer  Fenster  und  Bildrand  auseinanderhalten  kann. 

-  Der  Screen  Manager  verschickt  in  mehreren  Fallen  unnotige  Redraw-Mitteilungen,  auf 
deren  Eintreffen  man  sich  jedoch  nicht  verlassen  sollte.  Wenn  ein  Fenster  zum  obersten 
Fenster  wird,  erhalt  es  eine  Redraw-Mitteilung  iiber  die  gesamte  Arbeitsflache  -  auch 
liber  die  Bereiche,  die  bereits  sichtbar  waren.  Gleiches  gilt  fur  das  VergroBem  eines  Fen¬ 
sters. 
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Die  Resource-Bibliothek 


Einleitung 

Die  Resourcen  eines  Programms  sind  alle  Daten,  die  normalerweise  in  der  Resource-Datei 
(“*.RSC”)  gespeichert  sind.  Dazu  gehoren  Informationen  iiber  Dialoge,  Meniis,  Icons  usw. 
Die  Speicherung  in  einer  separaten  Datei  hat  den  Vorteil,  dafi  man  das  Erscheinungsbild 
(insbesondere  bei  Texten  die  Sprache)  andem  kann,  ohne  am  Programm  etwas  modifizieren 
zu  miissen. 


Die  Resource-Datei 

Am  Anfang  einer  solchen  Datei  steht  stets  folgende  Struktur: 


typedef  struct 
{ 


UWORD 

rsh_vrsn; 

/* 

DWORD 

rsh  object; 

/* 

UWORD 

rsh_tedinfo; 

/* 

UWORD 

rsh_iconblk; 

/* 

UWORD 

rsh_bitblk; 

/* 

UWORD 

rsh_frstr; 

/* 

UWORD 

rsh_string; 

/*■ 

UWORD 

rsh  imdata; 

/* 

UWORD 

rsh^frimg; 

/* 

UWORD 

rsh  trindex; 

/* 

UWORD 

rsh__nobs; 

/* 

UWORD 

rshjntree; 

/* 

UWORD 

rsh  nted; 

/* 

UWORD 

rsh  nib; 

/* 

UWORD 

rsh_nbb; 

/* 

UWORD 

rsh_nstring; 

/* 

UWORD 

rsh_nimages; 

/* 

UWORD 

rsh__rssize; 

/* 

}  RSHDR; 


null  */ 

Position  des  Objekt-Feldes  */ 
Position  der  TEDINFO-Strukturen  */ 
Position  der  ICONBLK-Strukturen  */ 
Position  der  BITBLK-Strukturen  */ 
Position  der  freien  Strings  */ 
uribenutzt  */ 

Position  der  Image-Daten  */ 

Position  der  freien  Images  */ 
Position  der  Objektbaumtabelle  */ 
Gesamtzahl  der  Objekte  */ 

Gesaratzahl  der  Objektbaume  */ 
Gesamtzahl  der  TEDINFO-Strukturen  */ 
Gesamtzahl  der  ICONBLK-Strukturen  */ 
Gesamtzahl  der  BITBLK-Strukturen  */ 
Gesamtzahl  der  Strings  */ 

Gesamtzahl  der  Images  */ 

Gesamtlange  der  RSC-Datei  */ 


Alle  Positionsangaben  sind  relativ  zum  Dateianfang  zu  verstehen.  Noch  ein  Wort  zu  den 
“freien  Strings”.  Zu  diesen  gehoren  nicht  nur  die  Zeichenketten,  in  denen  sich  die  Daten  fur 
Alarmboxen  befinden,  sondem  auch  alle  anderen  Strings,  die  ein  Programm  zu  seiner  Arbeit 
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benutzt.  Ein  Beispiel  daftir  ware  der  Dateiname  einer  einzulesenden  Datei  oder  ein  Eintrag, 
der  mit  “menu_text()”  in  einem  Menu  vorgenommen  wird. 

Diesem  Datei  kopf  folgen  die  eigentlichen  Resource-Daten.  Man  beachte  dabei,  da8  eine 
Resource-Datei  aufgrund  der  Verwendung  von  1 6-Bit- Werten  als  Zeiger  nur  eine  GesamtgroBe 
von  maximal  64  KByte  erreichen  kann.  Dateien  dieses  Formats  werden  von  alien  RCS- 
Programmen  (“Resource  Construction  Set”)  abgespeichert. 


Resourcen  im  Programm 

Aus  mancherlei  Griinden  kann  es  sinnvoll  sein,  Resource-Daten  direkt  in  das  Programm 

aufzunehmen.  Einige  Vorteile  sind: 

-  In  Accessories  ist  das  Nachladen  von  RSC-Dateien  problematisch  (Finden  der  Datei, 
Anfordem  von  Speicher). 

-  In  XCONTROL-Moduln  darf  “rsrc_load()”  gar  nicht  aufgerufen  werden  (mehr  dazu  im 
Kapitel  iiber  “XCONTROL”). 

-  Resource-Dateien  diirfen  nicht  langer  als  64  KByte  werden. 

Wenn  man  daher  die  Resource-Daten  direkt  einbinden  mochte,  muB  man  folgende  Probleme 

losen: 

1 .  Die  Resource-Strukturen  vom  Resource-Construction-Programm  in  ein  Format  bringen 
lassen,  das  von  der  benutzten  Programmiersprache  verstanden  wird.  Das  ist  meist  nur  fur 
C-Compiler  moglich. 

2.  In  den  RSC-Daten  stehen  anstelle  “echter”  Zeiger  noch  die  Indizes  der  jeweiligen 
Feldelemente.  Diese  Verweise  miissen  vom  Programm  in  richtige  Zeiger  umgerechnet 
werden.  Das  RCS  “Interface”  erlaubt  es,  schon  passend  initialisierte  C-Datenstrukturen 
zu  erzeugen. 

3 .  SchlieBlich  miissen  diezeichenorientierten  Koordinatenangaben  in  echte  Pixelkoordinaten 
konvertiert  werden.  Dazu  kann  die  Funktion  “rsrc_obfix”  benutzt  werden. 


Die  Shell-Bibliothek 

Die  Shell-Bibliothek  ist  sozusagen  die  Schaltzentrale  im  Innem  der  AES.  Sie  sorgt  fur  das 
Starten  der  einzelnen  GEM-Prozesse  und  versorgt  sie  mit  Informationen  iiber  ihre 
Arbeitsumgebung.  Daneben  stellt  sie  dem  Desktop  mehrere  Hilfsfunktionen  zur  Verfiigung. 
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Beginnen  wir  mit  “shel_read()”:  MitdieserFunktion  kann  ein  Programm  auf  betriebssystemun- 
abhangige  Art  und  Weise  Informationen  iiber  den  eigenen  Dateinamen  und  die  iibergebenen 
Parameter  erfragen.  Leider  liefert  sie  nur  dann  korrekte  Resultate,  wenn  das  betreffende  Pro¬ 
gramm  tatsachlich  mit  Hilfe  der  Shell-Bibliothek  gestartet  worden  ist. 

Daher  ist  es  meistens  sinnvoller,  diese  Informationen  aus  der  Basepage  und  dem  Environment 
(ARGV-Verfahren)  zu  extrahieren. 

“shel_write()”  erlaubt  es,  einen  neuen  AES-ProzeB  zu  starten.  Dies  allerdings  erst  nach 
Beendigung  des  eigenen  Prozesses  und  auch  nur  dann,  wenn  der  Aufrufer  zum  Programmstart 
tatsachlich  die  AES-Shellfunktionen  benutzt  hat.  PC-GEM  kenntbei  dieser  Funktion  spezielle 
Parameter  zum  Starten  von  Programmen  im  Textmodus  (ohne  VDI  und  AES).  Kiinftige  AES- 
Versionen  werden  vermutlich  zusatzliche  AES-Prozesse  starten  konnen,  ohne  dazu  erst  den 
aktuellen  ProzeB  beenden  zu  miissen. 

Ebenso  wie  “shel_read()”  die  betriebssystemabhangige  Abfrage  der  Kommandozeile  erspa- 
ren  soil,  ist  “shel_envm()”  zur  poitablen  Abfrage  von  Environment-Variablen  gedacht.  Man 
beachte,  daB  “sheLenvm()”  stets  auf  das  Environment  zugreift,  das  beim  Starten  der  AES 
aktuell  war.  Hinzu  kommen  einige  Probleme  mit  der  “PATH”-Variablen  (siehe  unter 
“shel_envm()”),  so  daB  eine  sinnvolle  Nutzung  dieser  Funktion  kaum  moglich  ist.  Statt  dessen 
sollte  man  das  normale  GEMDOS-Environment  abfragen! 

Nutzlicher  ist  da  schon  “shel_find()”,  das  zum  Suchen  von  Dateien  benutzt  wird.  Auch 
“rsrc_load()”  nimmt  es  in  Anspruch,  um  die  angegebene  RSC-Datei  zu  finden.  Speziell  seit 
GEM-Version  1 .4  ist  “shel_find()”  von  groBer  Bedeutung,  da  das  Desktop  beim  Starten  einer 
Applikation  unter  bestimmten  Umstanden  nicht  in  das  Verzeichnis  der  Applikation  wechselt 
und  man  daher  nur  mit  “shel  _find()”  Dateien,  die  im  gleichen  Verzeichnis  wie  das  gestartete 
Programm  liegen,  finden  kann. 

Die  AES  kennen  ein  Programm,  das  eine  herausgehobene  Bedeutung  besitzt:  das  Default- 
Desktop-Programm,  das  automatisch  nach  dem  Start  von  GEM  und  nach  dem  Beenden  einer 
GEM-Applikation  geladen  wird.  Im  Atari-GEM  ist  das  Desktop  fest  im  ROM  verankert  und 
zusammen  mit  den  AES  zu  einem  Programm  zusammengefafit.  Unter  PC-GEM  kann  der 
Name  auch  nachtraglich  noch  mit  “shel_rdef()”  abgefragt  und  mit  “shel_wdef()”  verandert 
werden. 

Speziell  fur  dieses  Programm  gibt  es  den  sogenannten  “Shell-Puffer”  -  einen  statischen 
Speicherbereich,  der  immer  resident  bleibt.  Er  erlaubt  es  dem  Desktop,  seine  aktuellen 
Einstellungen  vor  jedem  Programmstart  zu  sichem,  ohne  erst  eine  Datei  anlegen  zu  miissen 
(man  bedenke,  daB  1984  Festplatten  noch  nicht  zur  Standardausstattung  gehorten).  Dieser 
Puffer  kann  mittels  “shel_putQ”  beschrieben  und  mit  “shel_read()”  ausgelesen  werden. 
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liber  den  Inhalt  des  Shell-Puffers  entscheidet  allein  das  Desktop-Programm.  Das  Atari- 
DesktopverwaltetdenPufferalsTextdatei,diebeimSystemstartausderDatei“DESKTOP.INF” 
(bis  einschlieBlich  GEM  1.4)  bzw.  “NEWDESK.INF’’  ausgelesen  wird.  Je  nach  Desktop- 
Version  wird  das  Ende  der  Daten  durch  ein  Nullbyte  Oder  Control-Z  (ASCII  26)  gekennzeich- 
net. 


Die  XGRF-Bibliothek 

Diese  Funktionssammlung  ist  eine  PC-GEM-spezifische  Erweiterung.  Die  beiden  XGRF- 
Punktionen  erlauben  es,  Ersatz  fur  die  im  PC-GEM  gestrichenen  Routinen  fur  schrumpfende, 
wachsende  and  sich  bewegende  Rechtecke  zu  schaffen. 

AES-Bindings 

Der  AES-Parameter-Block 

Ebenso  wie  beim  VDI  benutzt  man  auch  bei  den  AES  zur  Parameteriibergabe  spezielle  Ein- 
und  Ausgabefelder.  Im  einzelnen  sind  das: 

WORD  contrl[5]; 

Fiinf  Werte,  mit  denen  Informationen  iiber  die  aufgerufene  Funktion  und  ihre  Parameter  fest- 
gelegt  werden.  Die  Belegung  ist  wie  folgt: 

contrl[0]  Nummer  der  AES-Funktion 

contrl[l]  Anzahl  der  16-Bit-Werte  im  int_in-Feld 

contrl[2]  Anzahl  der  16-Bit-Werte  im  int_out-Feld 

contrl[3]  Anzahl  der  32-Bit- Werte  im  addrjn-Feld 

contrl[4]  Anzahl  der  32-Bit-Werte  im  addr_  out-Feld 

Dariiber,  welche  Werte  vor  einem  AES-Auffuf  gesetzt  werden  miissen,  gibt  es  keine  klaren 
Informationen.  Notig  ist  es  auf  jeden  Fall  fur  contrl  [0] ,  contrl[  1  ]  und  contrl[3] .  Wenig  sinnvoll 
erscheint  es  fur  contrl[2]  und  contrl[4]  -  schlielMich  wissen  ja  die  AES-Funktionen  selbst,  wie 
viele  Werte  sie  in  den  Ausgabefeldem  zuriickliefem. 
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Die  mit  dem  Original-Entwicklungspaket  mitgelieferten  Bindings  (unten  beschrieben)  setzen 
allerdings  alle  Werte  des  Arrays. 

WORD  global[12]; 

Dieses  Feld  enthalt  globale  Daten  fur  die  Application  und  wird  teils  von  “appl_init()”,  teils 
von  anderen  AES-Funktionen  benutzt.  Genauere  Informationen  dazu  im  Abschnitt  iiber  die 
Applikations-Bibliothek. 

WORD  int_in[16]; 

In  diesem  Array  werden  alle  16-Bit  grofien  Parameter  iibergeben. 

WORD  int_out[7]; 

Hier  iibergeben  AES-Funktionen  alle  16-Bit  grofien  Rtickgabewerte. 

LONG  addr  in[2]; 

Dient  zur  Ubermittlung  von  Zeigerparametem  (wie  Zeiger  auf  Zeichenketten)  an  AES- 
Funktionen. 


LONG  addr  out[l]; 

Hier  werden  32-Bit  grofieRiickgabewerte  zuriickgeliefert.  Wird  zurZeit  nurfiir  “rsrc_gaddr()” 
benutzt. 


Die  Anfangsadressen  der  sechs  Parameterfelder  werden  im  “AES  Parameterblock”  abgelegt: 


typedef  struct 

{ 

WORD  *cb_pcontrol; 
WORD  *cb_jpglobal  ; 
WORD  *cb_pintin; 
WORD  *cb_pintout; 
LONG  *cb_padrin; 
LONG  *cb_padrout; 

}  AESPB; 


/*  Zeiger  auf  contrlf]  */ 

/*  Zeiger  auf  global []  */ 

/*  Zeiger  auf  int_in[]  */ 

/*  Zeiger  auf  int_out[]  */ 
/*  Zeiger  auf  addr_in[]  */ 
/*  Zeiger  auf  addr_out[]  */ 


Beim  Aufruf  von  AES-Funktionen  ist  damit  nur  noch  ein  Zeiger  auf  den  Parameterblock  zu 
iibergeben. 


AES  -Betriebssystemroutinen 


589 


Der  AES-Trap 

Zum  Aufruf  einer  AES-Punktion  ladt  man  Datenregister  DO  mit  der  Konstante  200  und  D1 
mit  der  Anfangsadresse  des  AES-Parameterblocks  und  macht  einen  “TRAP  #2”- Aufruf: 

.text 

.globl  ^crystal 
_crystal : 

move.l  4(sp),dl 
move.w  #200, dO 

trap  #2 

rts 

Die  Bezeichnung  “crystar  stammt  aus  der  Ursprungszeit  von  GEM,  als  Digital  Research  noch 
nicht  den  endgultigen  Namen  gefunden  hatte,  Dariiber,  welche  Register  verandert  werden, 
gibt  es  keine  klaren  Informationen.  Tatsache  aber  ist,  daB  die  entsprechenden  Routinen  im 
ROM  alle  Register  retten.  Riickgabewerte  erhalt  man  nicht  in  Registem,  sondem  im  “int_out”- 
und  “addr_out”-Feld. 

Eine  weitere  wichtige  Frage  ist,  inwieweit  GEM  fehlertolerant  ist,  das  heiBt,  ob  es  eine 
Absicherung  gegen  Abstiirze  infolge  fehlerhafter  Aufrufe  gibt:  Darauf  kann  man  nur  mit 
einem  klaren  Jein  antworten.  Falsche  AES-Funktionsnummem  werden  von  den  AES  vorbild- 
lich  mit  einer  Alarm-Box  (falsche  Funktionsnummer)  quittiert.  Falsche  Parameter  hingegen 
werden  nur  in  den  seltensten  Fallen  vemiinftig  abgefangen  und  fiihren  normalerweise  zu 
Absttirzen  Oder  anderem  Fehlverhalten. 

AES-Aufrufe  aus  dem  Supervisor-Modus  sind  nur  schwer  durchzufuhren.  Dies  ist  auch  nicht 
weiter  schlimm,  da  sich  Aufrufe  aus  Interrupts  heraus  sowieso  verbieten  -  die  AES  sind  nicht 
re-entrant.  Wer  es  dennoch  probieren  will,  mufi  folgende  Punkte  beachten: 

-  Viele  AES-Funktionenkehren  auch  dann  im  User-Modus  zuriick,  wennman  sie  aus  dem 
Supervisor-Modus  heraus  aufgerufen  hat.  Daher  muB  man  nach  jedem  Aufruf  mittels 
“Super(lL)”  feststellen,  ob  der  Modus  wieder  korrigiert  werden  muB. 

-  Bei  AES-Aufrufen  diirfen  sich  User-Stack  und  Supervisor-Stack  nicht  uberschneiden. 
Genau  dies  ist  jedoch  der  Fall,  wenn  man  mittels  “Super(OL)”  in  den  Supervisor-Modus 
geschaltet  hatte.  Abhilfe:  eigenen  Supervisor-Stack  zu  FuB  anlegen. 

-  Hinzu  kommt,  daB  die  AES  sogar  iiber  das  Ende  des  Supervisor-Stacks  hinausschreiben. 
Ein  “sicherer”  Aufruf  sollte  daher  etwa  so  aussehen  (Quelle:  “TOS  1 .4  Release  Notes”): 


;  Adresse  AESPB  (AES  Parameter  Block) 
;  Opcode  fur  AES 
;  Trap  fur  GEM 
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char  my__stack [8192]; 

old_ssp  =  Super  (&my_stack[8180] ) ;/*  nicht  ganz  aufs  Ende!  *7 
/*  Aufrufe  im  Supervisor-Modus...  */ 

Super  (old_ssp) ; 


Ein  Beispiel-Binding 

Die  Funktion  “crysjf”  (“Crystal  Interface”)  sorgtfiir  die  Besetzung  des  “contrl”- Arrays  und 
macht  den  eigendichen  AES-Aufruf.  Dazu  bedient  es  sich  einer  Tabelle,  in  der  fiir  jede 
einzelne  AES-Funktion  die  Werte  fiir  contrl[l],  contrl[2]  und  contrl[3]  vermerkt  sind: 

.text 

.globl  _ctrl__cnts 

.data 
Ctrl  cnts: 


.dc.b 

0, 

1, 

0 

* 

appl__in.it 

.dc.b 

2, 

1, 

1 

■k 

appl_read 

.dc.b 

2, 

1, 

1 

k 

appl_write 

.dc.b 

0, 

1, 

1 

k 

appl  find 

.dc.b 

2, 

1, 

1 

k 

appl_tplay 

.dc.b 

1, 

1, 

1 

* 

appl_trecord 

.dc.b 

2, 

1, 

0 

* 

appl_bvset 

.dc.b 

o, 

1, 

0 

k 

appl_yield 

.dc.b 

o. 

0, 

0 

k 

AES  18 

.dc.b 

0, 

1, 

0 

* 

appl__exit 

.dc.b 

0, 

1, 

0 

* 

evnt  keybd 

.dc.b 

3, 

5, 

0 

* 

evnt_button 

.dc.b 

5, 

5, 

0 

* 

evnt  mouse 

.dc.b 

0, 

1, 

1 

* 

evnt_mesag 

.dc.b 

2, 

1, 

0 

* 

evnt_timer 

.dc.b 

16, 

7, 

1 

k 

evnt  multi 

.dc.b 

2, 

1, 

0 

k 

evnt_dclicks 

-dc.b 

0, 

0, 

0 

k 

AES  27 

.dc.b 

o, 

0, 

0 

* 

AES  28 

.dc.b 

0, 

o, 

0 

* 

AES  29 

.dc.b 

1, 

1, 

1 

* 

menu  bar 
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.dc.b  2,  1,  1  *  menu_icheck 

.dc.b  2,  1,  1  *  menu_ienable 

.dc.b  2,  1,  1  *  menu_tnormal 

.dc.b  1,  1,  2  *  menu__text 

.dc.b  1,  1,  1  *  menu_register 

.dc.b  1,  1,  0  *  merm_unregister 

•  dc.b  2,  1,  0  *  menu_cl.ick 

.dc.b  0,  0,  0  *  AES  38 

.dc.b  0,  0,  0  *  AES  39 

.dc.b  2,  1,  1  *  objc__add 

.dc.b  1,  1,  1  *  obje_delete 

.dc.b  6,  1,  1  *  objc_draw 

.dc.b  4,  1,  1  *  objc_find 

.dc.b  1,  3,  1  *  objc_offset 

.dc.b  2,  1,  1  *  objc_order 

.dc.b  4,  2,  1  *  objc_edit 

.dc.b  8,  1,  1  *  objc__change 

.dc.b  0,  0,  0  *  AES  48 

.dc.b  0,  0,  0  *  AES  49 

.dc.b  1,  1,  1  *  form_do 

.dc.b  9,  1,  0  *  form_dial 

.dc.b  1,  1,  1  *  form_alert 

.dc.b  1,  1,  0  *  form_error 

.dc.b  0,  5,  1  *  form_center 

.dc.b  3,  3,  1  *  forra_keybd 

.dc.b  2,  2,  1  *  fonn_button 

.dc.b  0,  0,  0  *  AES  57 

.dc.b  0,  0,  0  *  AES  58 

.dc.b  0,  0,  0  *  AES  59 

.dc.b  0,  0,  0  *  AES  60 

.dc.b  0,  0,  0  *  AES  61 

.dc.b  0,  0,  0  *  AES  62 

.dc.b  0,  0,  0  *  AES  63 

.dc.b  0,  0,  0  *  AES  64 

.dc.b  0,  0,  0  *  AES  65 

.dc.b  0,  0,  0  *  AES  66 

.dc.b  0,  0,  0  *  AES  67 

.dc.b  0,  0,  0  *  AES  68 

.dc.b  0,  0,  0  *  AES  69 

.dc.b  4,  3,  0  *  graf_rubberbox 

.dc.b  8,  3,  0  *  graf_dragbox 
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.dc.b 

6, 

1, 

0 

: k 

graf  movebox 

.dc.b 

8, 

1, 

0 

* 

graf  growbox 

-dc.b 

8, 

1, 

0 

* 

graf  shrinkbox 

.dc.b 

4, 

1, 

1 

* 

graf  watcbbox 

.dc.b 

3, 

1, 

1 

* 

graf _s 1 idebox 

.dc.b 

0, 

5, 

0 

* 

graf_handle 

.dc.b 

1, 

1, 

1 

k 

graf_mouse 

.dc.b 

0, 

5, 

0 

* 

graf_mkstate 

.dc.b 

0, 

1, 

1 

* 

scrp  read 

.dc.b 

0, 

1, 

1 

k 

scrp  write 

.dc.b 

0, 

1, 

0 

k 

scrpjclear 

.dc.b 

0, 

0, 

0 

k 

AES  83 

.dc.b 

0, 

0 , 

0 

k 

AES  84 

.dc.b 

o, 

0, 

0 

* 

AES  85 

.dc  .b 

0, 

0, 

0 

k 

AES  86 

.dc.b 

0, 

0, 

0 

k 

AES  87 

.dc.b 

0, 

0, 

0 

k 

AES  88 

.dc.b 

o, 

0, 

0 

k 

AES  89 

.dc.b 

0, 

2, 

2 

k 

fseljLnput 

.dc.b 

0, 

2, 

3 

k 

fsel_exinput 

.dc.b 

0, 

0, 

0 

k 

AES  92 

.dc.b 

0, 

0, 

0 

k 

AES  93 

.dc.b 

0, 

0, 

0 

k 

AES  94 

.dc.b 

0, 

0, 

0 

k 

AES  95 

.dc.b 

0, 

0, 

0 

k 

AES  96 

.dc.b 

0, 

0, 

0 

k 

AES  97 

.dc.b 

0, 

0, 

0 

k 

AES  98 

.dc.b 

0, 

0, 

0 

k 

AES  99 

.dc.b 

5, 

1, 

0 

k 

wind_create 

.dc.b 

5, 

1  r 

0 

k 

wind__open 

.dc.b 

1, 

1, 

0 

k 

wind  close 

.dc.b 

1, 

1, 

0 

k 

wind  delete 

.dc.b 

2, 

5, 

0 

k 

wind  get 

.dc.b 

6, 

1, 

0 

k 

wind  set 

.dc.b 

2, 

1, 

0 

k 

wind  find 

.dc.b 

1, 

1, 

0 

k 

wind  update 

.dc.b 

6, 

5, 

0 

k 

wind_calc 

.dc.b 

0, 

0, 

0 

k 

wind  new 

.dc.b 

0, 

1, 

1 

k 

rsrc  load 

.dc.b 

0, 

1, 

0 

k 

rsrcjfree 

.  dc  .b 

2, 

1, 

0 

k 

rsrc_gaddr 
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.dc.b 

2, 

1, 

1 

* 

rsrc_saddr 

.dc.b 

1, 

1, 

1 

* 

rsrc  obfix 

.dc.b 

o, 

0, 

0 

* 

AES  115 

.dc.b 

o, 

0, 

0 

* 

AES  116 

.dc.b 

0, 

0, 

0 

* 

AES  117 

.dc.b 

0, 

0, 

0 

* 

AES  118 

.dc.b 

0, 

0, 

0 

* 

AES  119 

.dc.b 

0, 

1, 

2 

shel_read 

.dc.b 

3, 

1, 

2 

* 

sheljwrite 

.dc.b 

1, 

1, 

1 

* 

shel  get 

.dc.b 

1, 

1, 

1 

* 

shel_put 

.dc.b 

0, 

1, 

1 

* 

shel__find 

.dc.b 

0, 

1, 

2 

■k 

shel_envrn 

.dc.b 

0, 

1, 

2 

~k 

shel  rdef 

■  dc.b 

0, 

0, 

2 

•k 

shel  wdef 

.dc.b 

0, 

0, 

0 

-k 

AES  128 

.dc.b 

0, 

0, 

0 

* 

AES  129 

.dc.b 

6, 

6, 

0 

* 

xgrf  stepcalc 

.dc.b 

.end 

9, 

1, 

0 

•k 

xgrf_2box 

Der  AES-Parameter-Block  wird  direkt  vor  dem  Aufmf  der  Funktion  “appl_init()”  initialisiert 
(siehe  dort): 

AESPB  c; 

WORD  crys_if  (WORD  opcode) 

( 

WORD  i; 

WORD  *paesb; 

contrl  [0]  =  opcode; 

paespb  =  &ctrl__cnts  [  (opcode-10)  *3] ; 

for  (i  =  1;  i  <  4;  i++) 

control [i]  =  *paespb++; 

crystal  (c) ; 
return  int  out [ 0 ] ; 
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AES-Referenz 

APPL-Funktionen 


APPLINIT  (AES  10) 


Diese  Funktion  initialisiert  die  GEM-Arrays  (namentlich  das  Global-Feld)  und  meldet  das 
laufende  Programm  als  GEM-Applikation  an.  Die  DR-Dokumentation  zu  GEM  2.0  gibt  an, 
daB  die  erste  ProzeBumschaltung  friihestens  nach  zehn  AES-Aufrufen  stattfmdet.  Innerhalb 
dieses  Zeitraums  sollte  man  notwendige  Speicherallozierungen  -  sei  es  mittels  “rsrc_load()” 
oder  “MallocO”  -  vomehmen,  urn  eine  iiberfliissige  Speicher-Zersplitterung  zu  vermeiden. 

Bei  Accessories  ist  besondere  Vorsicht  geboten,  da  ab  GEM  1.4  das  Desktop  das  Laden  einer 
Autostart-  Anwendung  vorsieht.  Man  darf  also  nicht  davon  ausgehen,  daB  der  Rest  des  Systems 
wahrend  der  Accessory-Initialisierung  stillhalt.  Dadurch  wird  alles,  was  Speicheranfordemngen 
an  GEMDOS  provoziert  (“rsrc_load()”,  “v_opnvwk(>”  etc.),  zum  Problem:  Es  konntebereits 
ein  anderer  GEMDOS-ProzeB  am  Ruder  sein,  bevor  man  seine  eigene  Initialisierung  beendet 
hat.  Bei  Beendigung  dieses  Prozesses  wird  dann  der  ganze  in  der  Zwischenzeit  allozierte 
Speicher  freigegeben! 

Daher  sollte  die  Accessory-Initialisierung 

-  gleich  nach  dem  “appl_init()”  beginnen  (und  nicht  erst  nach  der  “AC„OPEN”-Mittei- 
lung  anfangen) 

-  mit  “wind_update()”  (BEG_UPDATE/END_UPDATE)  geklammert  werden  (damit 
kann  man  normalerweise  das  Starten  der  Autostart- Applikation  bremsen). 

Deklaration  in  C: 

extern  AESPB  c; 

WORD  int_in [16],  intjout [ 7 ] ,  contrl [ 5 ] ,  global [ 15 ] ; 

LONG  addr_ln [ 2 ] ,  addr_out [ 1 ] ; 

WORD  appl_init  (void) 

{ 

c .  cbjpcontrol  =  control; 
c.cb_pglobal  =  global; 
c.cbjointin  =  int^in; 
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c.cb_pintout  =  int_out; 
c.cb_padrin  =  addr_in; 
c.cb_padrout  =  addr_out; 
control [ 4 ]  =  0 ; 
crys__if  (10)  ; 
return  int_out[0]; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

10 

Opcode  fur  APPL_INIT 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  addrjn 

contrl+8 

contrl(4] 

0 

#  Eintrage  in  addr_out 

int_out 

int_out[0] 

Return-Wert 

Parameter: 

appl_init():  Bei  erfolgreicher  Initialisierung  die  Identifikationsnummer  fiir  die  Applikation. 

Im  Fehlerfall  erhalt  man  — 1.  Dann  sollte  man  das  Programm  mit  einer 
Fehlermeldung  abbrechen  und  insbesondere  weitere  AES-Aufrufe  vermeiden 
(viele  Bibliotheken  liefem  iibrigens  immer  die  1 !).  Die  AES  selbst  merken  sich 
die  Kennung  im  intemen  GLOBAL-Feld  der  Applikation. 

Bemerkungen 

Wenn  man  “appl_init(>”  auffuft,  ohne  daB  die  AES  betriebsbereit  sind  (also  aus  dem  AUTO- 
Ordner  heraus),  wird  speziell  die  AES-Versionsnummer  im  GLOBAL-Feld  nicht  gesetzt, 
Wenn  man  dort  vorher  eine  Null  hineinschreibt,  kann  man  also  leicht  feststellen,  ob  das 
Programm  aus  dem  AUTO-Ordner  heraus  gestartet  worden  ist.  Dieses  Verfahren  ist  zwar 
nirgendwo  offiziell  dokumentiert,  wird  aber  ebenfalls  vom  Atari-Mausbeschleuniger 
“MACCEL3”  verwendet. 
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APPLREAD  (AES  11) 

Liest  eine  bestimmte  Anzahl  von  Bytes  aus  einem  Ereignispuffer  (Message  Pipe). 

Deklaration  in  C: 

WORD  appl__read  (WORD  rwid,  WORD  length,  void  *pbuff) 

{ 

int_in[0]  =  rwid; 
int_in[l]  =  length; 
addr_in[0]  =  buff; 
return  crys_if  (11) ; 

) 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

1 1  Opcode  fur  APPL_READ 

contrl+2 

contrl[l] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

1  #  Eintrage  in  addr_in 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

rwid 

int_in+2 

int_in[l] 

length 

addr_in 

addr_in[0] 

pbuff 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

rwid:  id  der  Application,  aus  deren  Ereignispuffer  (Message  Pipe)  gelesen  werden 

soil  (normalerweise  der  eigene!) 
length:  Anzahl  der  zu  empfangenden  Bytes 

pbuff:  Anfangsadresse  des  Puffers,  in  dem  die  Nachricht  abgelegt  werden  soil 
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APPL  WRITE  (AES  12) 


Schreibt  eine  Anzahl  von  Bytes  in  einen  Ereignispuffer  (Message  Pipe) .  Eine  besonders  nette 
Anwendung  dieser  Funktion  ist  es,  wenn  eine  Applikation  sich  selbst  eine  WM_REDRAW- 
Mitteilung  schickt.  Mehrere  solcher  Ereignisse  werden  namlich  von  den  AES  nach  Moglich- 
keit  zu  einer  einzigen  Mitteilung  zusammengefaBt. 

Leider  gibtes  einen  kleinen  Haken:  der  AES-Dispatcher  legt  bei  “appl_write()”  einen  Prozeft 
schlafen,  wenn  die  Message-Queue  bereits  voll  ist.  Wenn  aber  alle  bereits  in  der  Message- 
Queue  liegenden  Mitteilungen  an  das  eigene  Programm  gerichtet  sind,  kommt  es  zum  System- 
stillstand  -  nichts  geht  mehr! 

Abhilfe:  Durch  einen  Mechanismus  im  eigenen  Programm  daftir  sorgen,  dal)  nicht  mehrere 
Mitteilungen  auf  einmal  in  die  Message-Queue  eingespeist  werden. 

Deklaration  in  C: 

WORD  appl_write  (WORD  rwid,  WORD  length,  void  *pbuff) 

{ 

int_in[0]  =  rwid; 
int_in[l]  =  length; 
addr_in[0]  =  pbuff; 
return  crys_if  (12) ; 

} 


GEM- Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

1 2  Opcode  fur  APPL_WRITE 

contrl+2 

contrlfl] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrI[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

intjn[0] 

rwid 

int_in+2 

int_in[l] 

length 

addr_in 

addr_in[0] 

pbuff 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 
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Parameter: 

rwid:  id  der  Application,  zu  der  die  Mitteilung  gesendet  werden  soil  (im  Normalfall 

ein  anderes  Programm,  z.  B.  ein  Accessory) 

length:  Anzahl  der  zu  sendenden  Bytes  (mindestens  der  Inhalt  eines  Message-Puffers, 

also  16  Bytes).  Eigene  Versuche  ergaben,  daB  in  den  vorhandenen  AES-Ver- 
sionen  maximal  128  Bytes  erlaubt  sind. 

pbuff:  Anfangsadresse  des  Puffers,  in  dem  sich  die  zu  sendende  Information  befindet 

(sollte  in  den  ersten  16  Bytes  dem  AES-Standardformat  fur  Mitteilungen  ent- 
sprechen) 
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APPLJFIND  (AES  13) 


Um  Informationen  mit  parallel  laufenden  Programmer]  austauschen  zu  konnen,  mu8  man 
zunachst  deren  Identifikationsnummem  (id)  feststellen  (siehe  zum  Beispiel  bei  “appl_read()n 
und“appl_write()”).Mit“appLfind()’’kannmandieIdentifikationsnummereinerApplikation, 
deren  Dateiname  bekannt  ist,  ermitteln  -  allerdings  nur,  wenn  sie  mittels  “shel_write()” 
gestartet  worden  ist. 

Leider  arbeitet  diese  Funktion  nicht  ganz  fehlerfrei.  Hat  man  eine  Application  beendet  und 
ist  zum  Desktop  zuriickgekehrt,  behauptet  “appLfindO”  immer  noch,  die  Application  sei  im 
Speicher!  Die  Ursache  hierfur  istdarin  zu  suchen,  daB  das  Desktop  auf  dem  Atari  keine  echte 
Application  ist  und  daher  die  AES  von  seiner  Existenz  nichts  wissen.  Daher  wird  auch  der 
Name  der  vorher  aktiven  Application  nicht  geloscht. 

Auf  dem  Atari  hat  das  aktive  Hauplprogramm  immer  die  Identifikationsnummer  0.  Nummer 
1  ist  der  Screen  Manager  (SCRENMGR  ist  der  Name  der  Applikation).  Die  folgenden 
Nummem  werden  an  die  Accessories  vergeben.  Dies  kann  natiirlich  unter  einer  multitasking- 
fahigen  GEM- Version  anders  sein. 


Deklaration  in  C: 

WORD  appl_find  (const  CHAR  *pname) 
{ 

addr_in(0]  =  pnarae; 
return  crys_if  (13) ; 

1 


GEM- Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

13 

Opcode  fiir  APPL_FIND 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  addr Jn 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

pname 

int_out 

int_out[0] 

Return- Wert  (-1:  Fehler) 
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Parameter: 

pname: 

appl_find(): 


Name  der  zu  suchenden  Applikation.  Dabei  handelt  es  sich  nur  um  den  eigent- 
lichen  Datejnamen  des  Programms  (also  ohne  Extension).  1st  dieser  kiirzer, 
mu6  der  String  mit  Leerzeichen  aufgefiillt  werden. 

Identifikationsnummer  des  gesuchten  Programms  (oder  -1,  wenn  es  nicht 
gefunden  werden  konnte) 
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APPLTPLAY  (AES  14) 


Die  AES  erlauben  es,  Benutzeraktionen  (also  Mausbewegungen,  TastendrUcke  etc.)  wie  ein 
Bandgerat  zu  speichem  und  anschlieBend  wieder  abzuspielen.  Diese  Wiedergabefunktion 
ubemimmt  “appl_tplay()”. 

Deklaration  in  C: 

WORD  appl__tplay  (APPLRECORD  *tbuffer,  WORD  t length,  WORD  tscale) 

{ 

int_in[0]  =  tlength; 
int_in[l]  =  tscale; 
addr_in[0]  =  tbuffer; 
return  crys_if  (14); 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

14  Opcode  fur  APPL_TPLAY 

contrl+2 

contrl[l] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl[2J 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

tlength 

int_in+2 

int_in[l] 

tscale 

addr_in 

addr_in[0] 

tbuffer 

int_out 

int_out[0] 

Retum-Wert  (immer  1) 

Parameter: 

tlength:  Anzahl  der  wiederzugebenden  Ereignisse 

tscale:  GeschwindigkeitsfaktorbeimAbspielenderEreignisse(50:halbeGeschwindig- 

keit,  100:  normale  Geschwindigkeit,  200:  doppelte  Geschwindigkeit  usw.) 
tbuffer:  Zeiger  auf  den  Speicherbereich,  in  dem  die  Ereignisse  gespeichert  worden  sind 


602 


ATARI  Profibuch 


APPL  TRECORD  (AES  IS) 


Dient,  analog  zu  “appl_tplay()’\  zum  Speichem  von  Benutzerereignissen,  um  sie  spater 
wieder  abspielen  zu  konnen.  Jedes  Ereignis  belegt  acht  Bytes  (bzw.  6  Bytes  auf  PC-GEM)  im 
Speicher. 

typedef  struct 
{ 

LONG  type;  /*  WORD  auf  PC-GEM! ! !  */ 

'LONG  what; 

}  APPLRECORD; 


Dabei  gibt  “type”  die  Art  des  Ereignisses  an  (siehe  unter  EVNT-Funktionen): 

0:  Timer-Ereignis 
1 :  Button-Ereignis 

2:  Maus-Ereignis 
3:  Tastatur-Ereignis 

“what”  enthalt  dann  jeweils  folgende  Informationen: 


Timer-Ereignis: 

Button-Ereignis: 

Maus-Ereignis: 

T  astatur-Ere  ignis : 


Anzahl  der  verstrichenen  Millisekunden 

Status  der  Maustaste  im  unteren  Wort  (0:  nicht  gedruckt,  1 :  gedruckt); 
Anzahl  der  Tastendriicke  im  oberen  Wort. 

X-Koordinate  (Oberes  Wort),  Y-Koordinate  (Unteres  Wort) 

Eingegebenes  Zeichen  (Unteres  Wort),  Tastaturstatus  (Oberes  Wort: 
K_RSHIFT  (0x0001),  K_LSHIFT  (0x0002),  K_CTRL  (0x0004), 
K.ALT  (0x0008) 


Deklaration  in  C: 

WORD  applet record  (APPLRECORD  *tbuffer,  WORD  t length) 

{ 

int_in[0]  =  t length; 
addr_in[0]  =  tbuffer; 
return  crys_if  (15) ; 

} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

15 

Opcode  fur  APPLJTRECORD 

contrl+2 

contrl[l] 

1 

#  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

intjn 

int_in[0] 

tlength 

addr_in 

addr_in[0] 

tbuffer 

int_out 

int_out[0] 

Return- Wert 

Parameter: 

lbuffer: 


tlength: 

appl_trecord(): 


Speicherbereich,  in  dem  die  Benutzerereignisse  gespeichert  werden 
(sollte  wegen  des  Speicherformats  achtmal  bzw.  sechsmal  so  groB  wie 
count  sein) 

Anzahl  der  zu  speichemden  Ereignisse 
Anzahl  der  gespeicherten  Ereignisse 


Bemerkung 

Aufgrund  eines  Fehlers  funktioniert  diese  Funktion  erst  ab  GEM  1 .2. 
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APPLBVSET  (AES  16)  -  nur  in  PC-GEM  ab  Version  2.0 


PC-GEM  benotigt  Informationen  iiber  die  angeschlossenen  logischen  Laufwerke  (fiir  die 
Dateiauswahlbox).  Mit  “appl_bvset()”  kann  man  die  entsprechenden  Informationen  setzen. 

Deklaration  in  C: 

WORD  appl_bvset  (UWORD  bvdisk,  UWORD  bvhard) 

{ 

int_in[0]  =  bvdisk; 
int_in[l]  =  bvhard; 
return  crys_if  (16) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

16 

Opcode  fur  APPL.  BVSET 

contrl+2 

contrl[l] 

2 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addr_in 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

int_in 

int_in[0] 

bvdisk 

int_in+2 

int_in[l] 

bvhard 

int_out 

int_out[0] 

Retum-Wert 

Parameter: 

bvdisk:  Bitvektor  mit  alien  vorhandenen  Disklaufwerken.  Bit  1 5  (also  das  hochste  Bit) 

steht  fiir  Laufwerk  “A:”! 

bvhard:  Bitvektor  mit  alien  vorhandenen  Harddisklaufwerken  (Format  wie  zuvor) 
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1  APPLYIELD  (AES  17)  -  nur  in  PC-GEM  ab  Version  2,0 


Kann  benutzt  werden,  urn  andere  AES-Prozesse  ans  Ruder  zu  lassen  (genauer:  Es  wird  ein 
AES-ProzeR-S witch  erzwungen). 

Auf  Atari-GEM-Versionen  kann  man  statt  dessen  einen  entsprechend  kurzen  Aufruf  von 
“evnt_timer()”  machen. 


Deklaration  in  C: 

WORD  appl_yield  (void) 

{ 

return  crys_if (17) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

17 

Opcode  fur  APPL_  YIELD 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addr„in 

contrI+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

int_out 

int_out[0] 

Return-Wert 
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APPLEXIT  (AES  19) 


Mit  “appLexitO”  meldet  sich  ein  Programm  bei  den  AES  ab.  Die  id  des  Programms  wird 
wieder  freigegeben  und  steht  fur  andere  Programme  zur  Verfiigung.  AuBerdem  wird  instal- 
lierten  Accessories  eine  AC_CLOSE-Mitteilung  geschickt. 

Deklaration  in  C: 

WORD  appl_exit  (void) 

{ 

return  crys_if  (19) ; 

} 


GEM-Arrays: 


Adresse 

Feideiement 

Belegung 

contrl 

contrl[0] 

19 

Opcode  fur  APPL_EXIT 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  intjn 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  inl.  out 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 
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EVNT-Funktionen 


EVNTJKEYBD  (AES  20) 


Wartet  auf  einen  Tastendruck  und  gibt  den  entsprechenden  Code  zuriick.  Keyboard- 
Ereignisse  werden  tibrigens  immer  nur  der  Applikation  gemeldet,  der  das  aktive  Fenster  gehort 
-  also  Vorsicht  bei  Accessories. 


Deklaration  in  C: 

WORD  evnt__keybd  (void) 

( 

return  crys_if  (20) ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

20 

Opcode  fur  EVNT_KEYBD 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int Jn 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int__out 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  addr  Jn 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

int_out 

int_out[0] 

Retum-Wert 

Parameter: 

evnt_keybd():  Tastencode  der  gedriickten  Taste 

(Bit  0..7:  ASCH-Code,  Bit  8..  15:  Scan-Code) 
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EVNTBUTTON  (AES  21) 


Wartet  auf  ein  festzulegendes  Maustasten-Ereignis. 


Deklaration  in  C: 

WORD  evht_button  (WORD  clicks,  DWORD  mask,  UWORD  state,  WORD  *pmx, 
WORD  *pmy,  WORD  *pmb,  WORD  *pks) 

{ 

int_in[0]  ~  clicks; 
int_in[l]  =  mask; 
int_in[2]  =  state; 
crys_if  (21)  ; 

*pmx  =  int_out[l]; 

*pmy  =  int_out[2]; 

*pmb  =  int_out[3]; 

*pks  =  int_out [ 4 ] ; 
return  int_out[0]; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

21  Opcode  fur  EVNTJ3  UTf ON 

contrl+2 

contrl[l] 

3  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

5  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

clicks 

intJ:n+2. 

int_in[l] 

mask 

int_in+4 

int_in[2] 

state 

int_out 

int_out{0] 

Retum-Wert 

int_out+2 

int_out[l] 

pmx 

int_out+4 

int_out[2] 

pmy 

int_out+6 

int_out[3] 

pmb 

int_out+8 

int_out[4] 

pks 
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Parameter: 

clicks:  Anzahl  der  maximal  gezahlten  Tastendriicke  (2:  Doppelklick  etc.) 

mask:  Maske  fur  den  gewiinschten  Mausknopf  (Bit  0:  linker  Knopf,  Bit  1 :  rechter 

Knopf) 

state:  Erwiinschter  Status  (Bitbelegung  wie  bei  mask,  ein  Bit  muB  genau  dann 

gesetzt  sein,  wenn  der  zugehorige  Mausknopf  gedriickt  werden  soli,  um  das 
Ereignis  auszulosen) 

pmx:  X-Koordinate  des  Mauszeigers  bei  Ereignisauslosung 

pmy:  Y-Koordinate  des  Mauszeigers  bei  Ereignisauslosung 

pmb:  Maustastenstatus  (siehe  state) 

pks:  Tastaturzustand  im  Augenblick  der  Meldung  des  Ereignisses.  Dabei  gilt 

folgende  Bitbelegung: 

K_RSHIFT  (0x0001):  rechte  Shift-Taste 
KJLSHIFT  (0x0002):  linke  Shift-Taste 
K_CTRL  (0x0004):  Control-Taste 

K„ALT  (0x0008):  Alternate-Taste 

e vnt_button() :  Anzahl  der  aufgetretenen  Maustastendrucke  (ist  immer  kleiner  oder  gleich 

clicks) 

Bemerkung 

Es  ist  nicht  moglich,  mittels  “evnt_buttonQ”  beide  Maustasten  gleichzeitig  (und  unabhangig 
voneinander)  abzufragen!  Ab  PC-GEM/3  unterstiitzen  die  Event-Funktionen  iiberhaupt  nur 
noch  eine  (die  linke)  Maustaste. 
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EVNTMOUSE  (AES  22) 


Wartet,  bis  der  Mauszeiger  einen  rechteckigen  Teil  des  Bildschirms  betritt  oder  verlaBt. 

Deklaration  in  C: 

WORD  evnt_mouse  (WORD  flags,  WORD  x,  WORD  y,  WORD  width, 

WORD  height,  WORD  *pmx,  WORD  *pmy,  WORD  *pmb, 
WORD  *pks) 

{ 

int_in [ 0 ]  ~  f lags ; 
int_in[l]  =  x; 
int_in[2]  =  y; 
int_in[3]  =  width; 
int_in[4]  =  height; 
crys_if  (22) ; 

*pmx  =  int_out [ 1 ] ; 

*pmy  =  int_out [2] ; 

*pmb  =  int__out[3]; 

*pks  =  int_out[4]; 
return  ( int_out [ 0 ] ) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

22  Opcode  fur  EVNT_MOUSE 

cor>trl+2 

contrl[l] 

5  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

5  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr_in 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

flags 

int_in+2 

int_in[l] 

X 

int_in+4 

int_in[2] 

y 

int_in+6 

int_in[3] 

width 

int_in+8 

int_in[4] 

height 
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Adresse 

Feldelement 

Belegung 

int_out 

int_out[0] 

Retum-Wert  (reserviert,  immer  1) 

int_out+2 

int_out[l] 

pmx 

int_out+4 

int_out[2] 

pmy 

int_out+6 

int_out[3] 

pmb 

int_out+8 

int_out[4] 

pks 

Parameter: 


flags: 

x,  y,  width,  height: 
pmx,  pmy; 
pmb: 

pks: 


Betreten  (0)  Oder  Verlassen  (1)  des  Rechtecks  melden 

Rechteck-Koordinaten 

Position  des  Mauszeigers 

Tastenstatus  beim  Eintreten  des  Ereignisses  (Bit  0:  linker  Mausknopf, 
Bit  1:  rechter  Mausknopf) 

Tastaturzustand  im  Augenblick  der  Meldung  des  Ereignisses. 

Dabei  gilt  folgende  Bitbelegung: 

KJRSHIFT  (0x0001):  rechte  Shift-Taste 

K_LSfflFT  (0x0002):  linke  Shift-Taste 

K_CTRL  (0x0004):  Control-Taste 

K_ALT  (0x0008):  Altemate-Taste 
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EVNT_MESAG  (AES  23) 


Wartet,  bis  im  Ereignispuffer  eine  Meldung  (Message)  vorliegt. 

Dekiaration  in  C: 

WORD  evnt__mesag  {WORD  *pbuf£) 

{ 

addr_in[0]  =  pbuff; 
return  crys_if  (23) ; 

} 

GEM-Arrays: 


Adresse 

Feidelement 

Beiegung 

contrl 

contrl[0] 

23 

Opcode  fiir  EVNT_MESAG 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1 

#  EintrSge  in  addrjn 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

int_out 

int_out[0] 

Retum-Wert  (reserviert,  immer  1) 

addrjn 

addrjn  [0] 

pbuff 

Parameter: 

pbuff:  Adresse  des  Speichers  fur  die  erwartete  Message  (Lange:  16  Bytes) 
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EVNTTIMER  (AES  24) 


Wartet,  bis  die  in  Millisekunden  anzugebende  Zeit  verstrichen  ist.  Man  sollte  in  Programmen 
niemals  “irgendwelche”  Warteschleifen  benutzen,  sondem  immer  nur  diese  (so  kann  namlich 
in  der  Zwischenzeit  beispielsweise  einem  Accessory  Prozessorzeit  zugewiesen  werden). 


Deklaration  in  C: 

WORD  evnt_timer  (UWORD  locnt,  UWORD  hicnt) 
{ 

int_in[0]  =  locnt; 
int_in[l]  =  hicnt; 
return  (crys_if (24) ) ; 

} 


GEM-Arrays: 


Adresse 

Feidelement 

Belegung 

contrl 

contrl  [0] 

24  Opcode  fur  EVNTJTIMER 

contrl+2 

contrl  [1] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addtrjn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

locnt 

intJn+2 

int_in[l] 

hicnt 

int_out 

int_out[0] 

Retum-Wert  (reserviert,  immer  1) 

Parameter: 

locnt,  hicnt:  Low-  und  High-Word  der  Anzahl  von  Millisekunden 
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Wartet  auf  eine  Kombination  verschiedener  Ereignisse.  Vorsicht  -  es  kann  mehr  als  ein 
Ereignis  gleichzeitig  auftreten! 


Deklaration  in  C: 

WORD  evntjmilti  (UWORD  flags,  UWORD  bclk,  DWORD  bmsk,  UWORD  bst, 
WORD  ml flags,  UWORD  mix,  UWORD  mly,  UWORD  mlw, 
UWORD  mlh,  UWORD  m2 flags,  UWORD  m2x,  UWORD  m2y, 
UWORD  m2w,  UWORD  m2h,  WORD  *mepbuff,  UWORD  tic, 
UWORD  the,  UWORD  *pmx,  UWORD  *pmy,  WORD  *pmb, 
WORD  *pks,  UWORD  *pkr,  WORD  *pbr) 

{ 

int_in[0]  =  flags; 
int_in[l]  =  bclk; 
int_in[2]  =  bmsk; 
int_in[3]  =  bst; 
int_in[4]  =  ml flags; 
int_in[5]  =  mix; 
int_in[6J  =  mly; 
int_in[7]  =  mlw; 
int_in[8]  =  mlh; 
int_in[9]  =  m2flags; 
int_in[10]  =  m2x; 
int_infll]  =  m2y; 
int_in[12]  =  m2w; 
int_in[13]  =  m2h; 
addr_in[0]  =  mepbuff; 
int_in[14]  =  tic; 
int_in [15]  =  the ; 
crys_if  (25) ; 

*pmx  =  int_out(l]; 

*pmy  =  int_out[2]; 

*pirib  =  int_out  [3]  ; 

*pks  =  int_out[4]; 

*pkr  =  int_out[5]; 

*pbr  =  int_out[6]; 
return  int  out[0]; 


} 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

25  Opcode  fur  EVNT  JvtULTI 

contrl+2 

contrlfl] 

1 6  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

7  #  Eintrage  in  int_.out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

flags 

int_in+2 

int_in[l] 

bclk 

int_in+4 

int_in[2) 

bmsk 

intjn+6 

int„in[3] 

bst 

intjn+8 

int_in[4] 

mlflags 

intjn+10 

int_in[5] 

mix 

int_in+12 

int_in[6] 

mly 

intjn+14 

int_in[7] 

mlw 

int_in+16 

int_in[8] 

mlh 

int_in+18 

int_in[9] 

m2flags 

intjn+20 

int_in[10] 

m2x 

int_in+22 

int_in[ll] 

m2y 

intjn+24 

int_in[12] 

m2w 

intjn+26 

int_in[13] 

m2h 

intjn+28 

int_in[14] 

tic 

int_in+30 

int_in[15] 

the 

int_out 

int_out[0] 

Retum-Wert 

int_out+2 

int_out[l] 

pmx 

int_out+4 

int_out[2] 

pmy 

int_out+6 

int_out[3] 

pmb 

int_out+8 

int_out[4] 

pks 

int_out+10 

int_out[5] 

pkr 

int_out+12 

int_out[6] 

pbr 

addrjn 

addrjn  [0] 

mepbuff 

Parameter: 

Die  meisten  Parameter  ergeben  sich  direkt  aus  der  Definition  von  “evnt_mouse()”, 
“evntjceybdO”,  “evnt_button()”  und  “evntjnesagO”.  Man  beachte  dabei,  daB  man  auf  zwei 
verschiedene  Maus-Ereignisse  (mlflags  und  m2flags  etc.)  priifen  kann. 
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Alle  weiteren  Parameter: 

flags:  Legt  fest,  auf  was  fur  ein  Ereignis  die  Application  warten  soil.  Die  Bedeutung 

der  einzelnen  Bits: 

Bit  0:  MUJKEYBD  (0x0001)  (Tastaturereignis) 

Bit  1:  MU_BUTTON  (0x0002)  (Mausknopfereignis) 

Bit  2:  MU_M1  (0x0004)  (erstes  Mausereignis) 

Bit  3:  MU_M2  (0x0008)  (zweites  Mausereignis) 

Bit  4:  MU_MESAG  (0x0010)  (Mitteilungs-Ereignis) 

Bit  5:  MUTIMER  (0x0020)  (Timer-Ereignis) 
evnt_mu]ti():  Die  Ereignisse,  die  tatsachlich  eingetreten  sind.  Bitbelegung  wie  bei  flags. 

Bemerkungen 

“pmx”,  “pmy”,  “pmb”  und  “pks”  werden  immer  -  ungeachtet  “flags”  -  zuriickgeliefert.  Die 
zuriickgelieferten  Werte  spiegeln  jeweils  den  Zustand  bei  Abfrage  des  Ereignisses  wieder. 

Durch  die  unglaubliche  Parameterzahl  verbraucht  ein  Aufruf  von  “evnt_multi()”  betrachtlich 
Prozessorzeit.  Man  denke  daran,  dafi  zunachst  alle  Parameter  auf  den  Stack  gepackt  und  dann 
auf  die  Eingabearrays  verteilt  werden.  Genau  dasselbe  passiert  dann  noch  mal  intern  in  den 
AES.  Erschwerend  kommt  hinzu,  dafi  man  meistens  viele  Parameter  gar  nicht  setzen  will. 

Das  hat  mittlerweile  auch  Digital  Research  erkannt:  Im  GEM/3-Toolkit  findet  man  daher  die 
folgende  Alternative,  bei  der  man  nur  einen  Zeiger  auf  eine  “MEVENT’-Struktur  tibergibt. 

typedef  struct 
{ 

WORD  g_x,  g_y,  g_w,  g_h; 

}  GRECT; 

typedef  struct 
{ 

UWORD  e__f  lags ; 

UWORD  e_bclk; 

UWORD  e_bmsk; 

UWORD  e_bst ; 

UWORD  e_ml flags; 

GRECT  e_ml; 

UWORD  e_m2  flags; 

GRECT  e_m2  ; 

WORD  *e_mepbuf; 

ULONG  e  time; 
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WORD 

e  mx; 

WORD 

ejmy; 

UWORD 

ejnb; 

UWORD 

e__ks; 

UWORD 

e_kr; 

UWORD 

e_br; 

UWORD 

e_iu3  flags ; 

GRECT 

e__m3; 

WORD 

e_xtraO; 

WORD 

*e_sroepbuf 

ULONG 

e_xtral ; 

ULONG 

e__xtra2; 

}  MEVENT; 

WORD  evnt_event  (MEVENT  *pmevent) 

{ 

inemcpy  {int_in,  prevent,  14  *  sizeof  (UWORD) ) ; 
addr_in[0]  =  pmevent->e_mepbuf ; 
int_in[14]  =  (WORD)  ( (pmevent->e_time)  OxFFFF) ; 
int_in[15]  =  (WORD)  ( (pmevent->e_time)  »  16); 
crys_if  (25)  ; 

memcpy  (& (pmevent->e_mx) ,  & (int_out [1] ) ,  6  *  sizeof  (UWORD)); 
return  int_out[0]; 

} 
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EVNTDCLICK  (AES  26) 

1  .  i  , 

Setzt  die  Geschwindigkeit  fur  das  “Doppelklicken”  der  Maus  Oder  stellt  den  aktuellen  Wert 
ein. 


Deklaration  in  C: 

WORD  evnt_dclick  (WORD  rate,  WORD  setit) 
{ 

int__in[0]  =  rate; 
int_in[l]  =  setit; 
return  crys_if  (26)  ; 

) 

GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

26  Opcode  fiir  EVNT_DCLICK 

contrl+2 

contrI[l] 

2  #  EintrHge  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

0  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

rate 

int_in+2 

int_in[l] 

setit 

int_out 

int_outfO] 

Return-Wert 

Parameter: 

rate:  Neue  Geschwindigkeit  fiir  Doppelklicks  (0..4) 

setit:  0:  aktuellen  Wert  feststellen  und  rate  ignorieren 

1:  neuen  Wert  setzen 

evnt_dclick:  jetzt  giiltige  Geschwindigkeit  (unabhangig  von  setit) 
Bemerkungen 

In  dlteren  GEM-Dokumentationen  auch  haufig  “evnt_dclicks()”  genannt. 
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MENU-Funktionen 


MENU JBAR  (AES  30) 


Setzt  oder  desaktiviert  die  Meniileiste  eines  Meniiobjektbaums.  Auf  gar  keinen  Fall  vor  Been- 
digung  des  Programms  vergessen! 

Deklaration  in  C: 

WORD  menu__bar  (OBJECT  *tree,  WORD  showit) 

{ 

addr__in[0]  ~  tree; 
int_in[0]  =  showit; 
return  crys___if  (30) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

30 

Opcode  fiir  MENU_BAR 

contrl+2 

contrlfl] 

1 

#  Eintrage  in  intjn 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

intjn 

int_in[0] 

showit 

addrjn 

addr_in[0] 

tree 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

showit:  0:  Meniileiste  loschen 

1:  Meniileiste  setzen 

tree:  Anfangsadresse  des  Objektbaumes  des  Mentis 
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MENU  JCHECK  (AES  31) 


Loscht  Oder  setzt  ein  Hakchen  vor  einem  Meniieintrag  (dazu  sollte  man  jeden  Eintrag  mit  zwei 
Leerzeichen  beginnen).  Ab  PC-GEM  2.0  gibt  es  statt  dessen  kleine  Pfeilspitzen  (Dreiecke). 

Deklaration  in  C: 

WORD  menu_icheck  (OBJECT  *tree,  WORD  itemnum,  WORD  checkit) 

{ 

addr_in[0]  =  tree; 
int_in[0]  =  itemnum; 
int_in[lj  =  checkit; 
return  crys__if  (31) ; 

) 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

3 1  Opcode  fur  MENUJCHECK 

contrl+2 

contrl[l] 

2  #  Eintrage  in  int_in 

contrl44 

contrl[2] 

I  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr  Jn 

contrI+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

itemnum 

int_in+2 

int_in[l] 

checkit 

addr_in 

addr_in[0] 

tree 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

itemnum:  Objektnummer  des  betreffenden  Meniieintrags 

checkit:  0:  Hakchen  loschen 

1:  Hakchen  setzen 

tree:  Anfangsadresse  des  Menii-Objektbaums 
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MENU JENABLE  (AES  32) 


Schaltet  Meniieintrage  ein  und  aus  (gekennzeichnet  durch  graue  Schattierung). 


Deklaration  in  C: 

WORD  menu_i  enable  (OBJECT  *tree,  WORD  itemnum,  WORD  enableit) 
{ 

addr_in[0]  =  tree; 
int_in [ 0 ]  ~  itemnum ; 
int_in[l]  =  enableit; 
return  crys_if  (32) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO) 

32  Opcode  fur  MENU  JENABLE 

contrl+2 

contrl[l] 

2  #  Eintrage  in  intjn 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr  Jn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr__out 

int_in 

int_in[0] 

itemnum 

int_in+2 

int_in[l] 

enableit 

addr_in 

addr_in[0) 

tree 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

itemnum:  Objektrmmmer  des  zu  bearbeitenden  Mentieintrags 

enableit:  0:  desaktivieren,  1 :  aktivieren 

tree:  Anfangsadresse  des  Menu-Objektbaums 
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MENUTNORMAL  (AES  33) 

Invertiert  Meniititel. 


Deklaration  in  C: 

WORD  menu_tnormal  (OBJECT  *tree,  WORD  titlenum,  WORD  norraalit) 

{ 

addr_in[0]  =  tree; 
int_in[0]  =  titlenum; 
int_in[l]  =  normalit; 
return  crys_if  (33) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

33 

Opcode  fur  MENU  JTNORMAL 

contrl+2 

contrl[l] 

2 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

int_in 

int_in[0] 

titlenum 

int_in+2 

int_in[  1  j 

normalit 

addrjn 

addr_in[0] 

tree 

int_out 

int_out[0] 

|  Return- Wert  (0:  Fehler) 

Parameter: 

titlenum:  Objektnummer  des  Meniititels 

normalit:  0:  invers  darstellen 

1:  normal  darstellen 

tree:  Anfangsadresse  des  Menti-Objektbaums 
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MENUTEXT  (AES  34) 


Andert  den  Text  in  einem  Meniieintrag.  Damithat  man  die  Moglichkeit,  Texte  in  Mentis  vom 
momentanen  Zustand  eines  Programms  abhangig  zu  machen  (“kontext-sensitiv”). 

Accessories  konnen  diese  Methode  natiirlich  nicht  benutzen,  da  sie  die  Adresse  des  aktiven 
Meniibaums  nicht  kennen.  Statt  dessen  muB  man  also  von  Beginn  an  genug  Platz  fur  den 
Meniieintrag  freihalten  und  dann  den  entsprechenden  Text  an  die  entsprechende  Adresse 
kopieren. 


Deklaration  in  C: 

WORD  menu_text  (OBJECT  *tree,  WORD  inum,  CHAR  *ptext) 
{ 

addr_in[0]  =  tree; 
int_in  [  0 ]  =  inum; 
addr_in[l]  =  ptext; 
return  crys_if  (34); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

34  Opcode  fiir  MENU_TEXT 

contrl+2 

contrl[l] 

1  #  Eintrage  in  intjn 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

2  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

intjn[0] 

inum 

addrjn 

addrjn[0] 

tree 

addr_in+4 

addr_in[l] 

ptext 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

item:  Objektnummer  des  zu  andemden  Meniieintrags 
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text:  Anfangsadresse  des  neuen  Eintrags  (GEM  benutzt  nur  den  Zeiger,  legt  also  keine 
Kopie  an!).  Sollte  nicht  langer  als  der  bisherige  Eintrag  sein. 
tree:  Anfangsadresse  des  Menii-Objektbaums 

Bemerkungen 

Ab  PC-GEM  2.0  legen  die  AES  eine  Kopie  des  Menii-Objektbaums  an.  Daher  muB  man  nach 
jeder  Anderung  eines  Eintrags  das  Menu  mittels  “menu_bar()”  neu  auf  den  Bildschirm 
bringen!  Fiir  Accessories  hat  man  sich  gezwungenermaBen  einen  Ausweg  einfallen  lassen:  Sie 
konnen  in  “tree”  anstelle  der  (unbekannten)  Baumadresse  die  Nummer  des  Accessory- 
Eintrags  (Riickgabewert  von  “menu_register()”)  iibergeben  (dazu  setzt  man  das  obere  Wort 
auf  Null  und  iibergibt  im  unteren  Wort  die  Nummer  des  Eintrags). 
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MENU  REGISTER  (AES  35)  ,  -  ' 

Tragt  Namen  im  ersten  Drop-Down-Menu  fur  Accessories  ein.  Insgesamt  sechs  quasi  gleich- 
zeitig  laufende  Accessories  konnen  gemeinsam  sechs  Eintrage  im  Menii  benutzen. 

Deklaration  in  C: 

WORD  menu_register  (WORD  pid,  const  CHAR  *pstr) 

{ 

int_in [ 0 ]  =  pid; 
addr_in[0]  =  pstr; 
return  crys_if  (35) ; 

} 


GEM-Arrays: 


Adresse 

Feidelement 

Belegung 

contrl 

contrl[0] 

35  Opcode  fiir  MENU_REGISTER 

contrl+2 

contrl[l] 

1  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

pid 

addr_in 

addr_in[0] 

pstr 

int_out 

int_out[0] 

Retum-Wert 

Parameter; 

pid:  Identifikation  des  Accessories  (ap_id) 

pstr:  Anfangsadresse  des  Textes  fiir  den  Meniieintrag  (GEM  benutzt  nur  den 

Zeiger,  legt  also  keine  Kopie  an) 

menu_register():  Menti-Kennung  fiir  das  Accessory  oder  -1,  falls  kein  Platz  fiir  weitere 
Eintrage  ist 

Bemerkungen 

Ein  Aufiruf  von  “menu_register(>”  wirkt  sicherstdann  aus,  wenn  das  jeweilige  Hauptprogramm 
einen  Aufruf  von  “menu_bar()”  macht.  Daher  sollte  man  bei  Accessories  gleich  nach  Start  den 
Eintrag  vomehmen  -  sonst  verpaBt  man  namlich  den  “menu_bar()”- Aufruf  des  Desktops. 
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MENUUNREGISTER  (AES  36)  -  nur  in  PC-GEM  ab  Version  2.0 


Ab  PC-GEM  2.0  konnen  Accessories  ihren  Namen  wieder  aus  dem  Desk-Menu  entfemen. 


Deklaration  in  C: 

WORD  menu_unregister  (WORD  mid) 

{ 

int_in[0]  =  mid; 
return  crys_if  (36);. 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

36 

Opcode  fur  MENUJJNREGISTER 

contrl+2 

contrl[l] 

1 

#  Eintrage  in  intjn 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  addr  Jn 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

intjn 

int_in[0] 

mid 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

mid:  Identifikation  des  Accessories  (ap_id) 
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MENUCLICK  (AES  37)  -  nur  in  PC-GEM/3 


Ab  PC-GEM/3  kann  man  die  Behandlung  der  Drop-Down-Meniis  auf  “Pull-Down”  umstel- 
len. 


Deklaration  in  C: 

WORD  menu_click  (WORD  click,  WORD  setit) 
{ 

int_in(0]  =  click; 
int_in[l]  =  setit; 
return  crys_if  (37); 

1 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

37  Opcode  fiir  MENU_CLICK 

contrl+2 

contrl  [1] 

2  #  Eintrage  in  int  Jn 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrI[3] 

0  #  Eintrage  in  addr  Jn 

eontrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

click 

intJn+2 

int_in[l] 

setit 

int_out 

int„out[0] 

Retum-Wert 

Parameter: 

click:  0:  Dropdown,  1:  Pulldown 

setit:  0:  abfragen,  1:  setzen 

menu_click():  0:  Dropdown,  1:  Pulldown 
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OB  JC-F  unktionen 


OBJCADD  (AES  40) 


Stellt  die  hierarchische  Verknupfung  zwischen  zwei  Objekten  in  einem  Objektbaum  her. 
Deklaration  in  C: 

WORD  objc_add  (OBJECT  *tree,  WORD  parent,  WORD  child) 

{ 

addr_in[0]  =  tree; 
int_in[0]  =  parent; 
int_in[l]  =  child; 
return  crys_if  (40)  ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Betegung 

contrl 

contrl  [0] 

40  Opcode  fur  OBJC_ADD 

contrl+2 

contrl[l] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr_in 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

parent 

int_in+2 

int_in[l] 

child 

addr_in 

addr_in[0] 

tree 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

parent:  Objektnummer  des  Objekts,  zu  dem  das  Child  hinzugefiigt  werden  soli 

child:  Objektnummer  des  hinzuzufiigenden  Objekts  (“ob_head”  und  “objail”  miis- 

sen  bereits  passend  initialisiert  sein). 
tree:  Adresse  des  Objektbaumes 
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OB  JC_DELETE  (AES  41) 


LQst  ein  Objekt  aus  der  Liste  des  Objektbaumes. 
Deklaration  in  C: 

WORD  objc_delete  (OBJECT  *tree,  WORD  delob) 
{ 

addr_in[0]  =  tree; 
int_in[0]  =  delob; 
return  crys_if  (41); 

> 

GEM- Arrays: 


Adresse 

|  Feldelement 

Belegung 

contrl 

contrl[0] 

4 1  Opcode  fur  OB JC_DELETE 

contrl+2 

contrlfl] 

1  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in(0] 

delob 

addr_in 

addr_in[0] 

tree 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

delob:  Objektnummer  des  herauszulosenden  Objekts 
tree:  Anfangsadresse  des  Objektbaums 
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OBJCJDRAW  (AES  42) 


Stellt  ganze  Objekte  Oder  Teile  von  Objekten  auf  dem  Bildschirm  dar.  Dabei  kann  zusatzlich 
ein  Bildschirmausschnitt  in  Koordinaten  angegeben  werden,  auf  den  die  Darstellung  be- 
schrankt  wird.  Dies  ist  beispielsweise  beim  Wiederherstellen  von  Bildausschnitten,  die  von 
einem  Fenster  iiberlagert  wurden,  niitzlich. 

Deklaration  in  C: 

WORD  objcjdraw  (OBJECT  *tree,  WORD  drawob,  WORD  depth,  WORD  xc, 

WORD  yc,  WORD  wc,  WORD  he) 

{ 

addr_in[0]  =  tree; 
int_in[0]  =  drawob; 
int_in[l]  =  depth; 
int_in[2]  =  xc; 
int_in[3]  =  yc; 
int_in[4]  =  wc; 
int_in[5]  =  he; 
return  crys_if  (42) ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

42  Opcode  fur  OBJC_DRAW 

contrl+2 

contrl[l] 

6  #  Eintrage  in  intjn 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

1  #  Eintrage  in  addrjn 

contrI+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

drawob 

int_in+2 

int_in[l] 

depth 

int_in+4 

int_in[2] 

xc 

int_in+6 

int_in[3] 

yc 

int_in+8 

int_in[4] 

wc 

mt_in+10 

int_in[5] 

he 

addr_in 

addr_in[0] 

tree 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 
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Parameter: 

drawob:  Objektnummer  des  ersten  zu  zeichnenden  Objekts 

depth:  Anzahl  der  zu  zeichnenden  Objekt-Ebenen  (0:  nur  das  erste  Objekt) 

xc,  yc, 

wc,  he:  Position  und  MaBe  des  begrenzenden  (clipping)  Rechtecks 

tree:  Anfangsadresse  des  betreffenden  Objektbaums 
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OBJCFIND  (AES  43) 

Ermittelt,  iiber  welchem  Objekt  sich  der  Mauszeiger  befindet  (oder  allgemeiner:  welches 
Objekt  an  einer  gegebenen  Bildschirmposition  steht). 

Deklaration  in  C: 

WORD  objc_find  (OBJECT  *tree,  WORD  startob,  WORD  depth,  WORD  mx, 

WORD  my) 

( 

addr_in[0]  =  tree; 
int_in[0]  =  startob; 
int_in[l]  =  depth; 
int_in[2]  =  mx; 
int_in[3]  =  my; 
return  crys_if  (43); 

} 

GEM-Arrays: 

Adresse  |  Feldelement  |  Belegung 

Opcode  fur  OBJCJTND 

#  Eintrage  in  int_in 

#  Eintrage  in  int_out 

#  Eintrage  in  addr_in 

#  Eintrage  in  addr_out 


addr_in  addr_in[0]  tree 

int_out  int_out[0]  Retum-Wert  (-1:  nichts  gefunden) 

Parameter: 

startob:  Objektnummer  des  Objekts,  bei  dem  die  Suche  beginnen  soli 


contrl  contrl[0]  43 

contrl+2  contrl[l]  4 

contrl+4  contrl  [2]  1 

contrl+6  contrl[3]  1 

contrl+8  contrl[4]  0 

int_in  int_in[0]  startob 

int„in+2  int_in[l]  depth 

int_in+4  int_in[2]  mx 

int_in+6  int_in[3]  my 
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depth: 

mx,my: 

free: 

objc_find(): 


Anzahl  der  Ebenen  in  der  Objekthierarchie,  die  durchsucht  werden  sollen  (0: 
nur  Mutterobjekt) 

Koordinaten  der  betreffenden  Bildschirmposition 
Anfangsadresse  des  zu  untersuchenden  Objektbaums 
Objektnummer  des  gefundenen  Objekts 
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OBJCOFFSET  (AES  44) 


Berechnet  die  Position  eines  Objekts  in  absoluten  Bildschirmkoordinaten. 

Deklaration  in  C: 

WORD  objc_offset  (OBJECT  *tree,  WORD  obj,  WORD  *poffx,  WORD  *poffy) 

{ 

addr_in[0]  =  tree; 
int_in[0]  =  obj; 
crys_if  (44); 

*poffx  =  int_out[l]; 

*pof  f y  =  int_out  [2 ] ; 
return  int_out [ 0 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

44  Opcode  ftir  OBJCOFFSET 

contrl+2 

contrl[l] 

1  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

3  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

obj 

addr_in 

addr_in[0] 

tree 

int_out 

int_out[0| 

Return- Wert  (0:  Fehler) 

int_out+2 

int„out[l] 

poffx 

int_out+4 

int_out[2] 

poffy 

Parameter: 

obj:  Objektnummer  des  betreffenden  Objekts 

tree:  Anfangsadresse  des  Objektbaums 

poffx,  poffy:  die  berechneten  Koordinaten 
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|~  QBJCQRDER  (AES  45) 


Die  Position  eines  Objekts  innerhalb  eines  Unterbaums  wird  geandert. 


Deklaration  in  C: 

WORD  objc_order  (OBJECT  *tree,  WORD  movjobj,  WORD  newpos) 

{ 

addr_in[0]  =  tree; 
int_in[0]  =  mov_obj; 
int_in[l]  =  newpos; 
return  crys_if  (45) ; 

} 


GEM-Arrays: 


Adresse 

Feidelement 

Belegung 

contrl 

contrl[0] 

45  Opcode  fur  OBJC_ORDER 

contrl+2 

contrlfl] 

1  2  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

intjn 

intjn  [0] 

mov_obj 

int_in+2 

intjnfl] 

newpos 

addrjn 

addrjn[0] 

tree 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 


mov_obj: 

newpos: 


tree: 


Objektnummer  des  betreffenden  Objekts 
0:  an  den  Anfang 

1 :  an  zweite  Stelle 

2:  an  dritte  Stelle  (usw.) 

-1:  andasEnde 

Anfangsadresse  des  Objektbaums 
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OBJCEDIT  (AES  46) 


Erlaubt  Texteingaben  in  Objekte  vom  Typ  G_FTEXT  oder  G_FBOXTEXT. 


Deklaration  in  C: 


WORD  objc_edit  (OBJECT  *tree,  WORD  obj,  WORD  inchar,  WORD  *idx, 
WORD  kind) 


{ 

addr_in [ 0 ]  =  t  ree ; 
int_in[0]  =  obj; 
int_in[l]  =  inchar; 
int_in[2]  =  *idx; 
int_in[3]  =  kind; 
crys_if  (46); 

*idx  =  int__out[l]; 
return  int^out [0] ; 

} 


GEM-Arrays; 


Adresse 

Feldelement 

contrl 

contrl[0] 

contrl+2 

contrl[l] 

contrl+4 

contrl[2] 

contrl+6 

contrl[3] 

contrl+8 

contrl[4] 

int_in 

int_in[0] 

int_in+2 

int_in[l] 

int_in+4 

int_in[2] 

int_in+6 

int_in[3] 

addrjn 

addr_in[0] 

int.out 

int_out[0] 

int_out+2 

int_out[l] 

Belegung 


46  Opcode  fiir  OBJC_EDIT 
4  #  Eintrage  in  int_in 

2  #  Eintrage  in  int_out 

1  #  Eintrage  in  addr_in 

0  #  Eintrage  in  addr_out 

obj 

inchar 

Inhalt  von  idx 
kind 

tree 

Return- Wert  (0:  Fehler) 
idx 
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Parameter: 


obj: 

inchar: 

idx: 

kind: 


Nummer  des  zu  editierenden  Objekts 
Eingegebenes  Zeichen 
Position  des  Zeichens  im  String 
Funktionsauswahl: 


EDJ3TART  (0): 
D_IN1T(1): 

ED_CHAR  (2): 

ED_END  (3): 


reserviert 

Berechne  aus  te_ptext  und  te„ptmplt  einen  formatierten 
String  und  schalte  Cursor  ein 

Betreffendes  Zeichen  verarbeiten  und  den  String  neu 
anzeigen 

Cursor  ausschalten 


Bemerkungen 

Vorsicht!  Bei  dem  hier  angegebenen  Binding  wird  davon  ausgegangen,  daB  man  fur  int_in[2] 
dieselbe  Variable  wie  fur  int_out[l]  verwendet  -  genauso  sieht  es  auch  in  den  Bibliotheken 
von  DR  und  Megamax  aus.  In  der  urspriinglidien  GEM-Dokumentation  von  DR  hingegen 
waren  dafiir  verschiedene  Variablen  angegeben.  Der  Aufruf  lautete  also: 


objc_edit  (tree,  obj,  inchar,  idx,  kind,  sidx)  ; 

Moglicherweise  existieren  AES-Bibliotheken,  bei  denen  “objc_edit()”  noch  immer  auf  diese 
Weise  eingebunden  ist! 
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!  OBJC  CHANGE  (AES  47) 


Andert  den  Status  (ob_state)  eines  Objekts  und  zeichnet  es  gegebenenfalls  neu,  sofem  es  sich 
innerhalb  eines  gegebenen  Begrenzungsrechtecks  (clipping  rectangle)  befindet. 

Deklaration  in  C: 

WORD  objc_change  (OBJECT  *tree,  WORD  drawob,  WORD  resvd,  WORD  xc, 
WORD  yc,  WORD  wc,  WORD  he,  WORD  newstate, 

WORD  redraw) 

{ 

addr_in[0]  =>  tree; 
int_in[0]  =  drawob; 
int_in(l)  =  resvd; 
int_in[2]  =  xc; 
int_in[3]  =  yc; 
int_in[4]  =  wc; 
int_in[5]  =  he; 
int__in[6]  =  newstate; 
int_in[7]  =  redraw; 
return  crys_if  (47) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

47  Opcode  fur  OBJC_CHANGE 

contrl+2 

contrl[l] 

8  #  Einhage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl(4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

drawob 

int_in+2 

int_in[l] 

resvd 

int_in+4 

int_in[2] 

xc 

int_in+6 

int_in[3] 

yc 

int_in+8 

int_in[4] 

wc 

int_in+10 

int_in[5] 

he 

int_in+12 

int_in[6] 

newstate 
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Adresse 

Feldelement 

Belegung 

int_in+14 

int„in[7] 

redraw 

addrjn 

addr_inf0] 

tree 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 


drawob: 
resvd: 
xc,  yc, 
wc,  he: 
newstate: 
redraw: 

tree: 


Objektnummer  des  betreffenden  Objekrs 
Reserviert;  mu  8  0  sein 

Koordinaten  des  begrenzenden  Rechtecks 
Neuer  Status  (ob_state)  des  Objekts 
0:  Objekt  nicht  neu  zeichnen 
1 :  Objekt  neu  zeichnen 
Anfangsadresse  des  Objektbaums 


Bemerkung 

In  neueren  Bindings  wird  das  resvd-Feld  auch  haufig  ausgelassen  und  automatisch  auf  Null 
gesetzt. 
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FORM-Funktionen 

FORMDO  (AES  50) 

Dies  ist  die  zentrale  Routine  im  Dialog-Manager.  Sie  iibemimmt  die  komplette  Verwaltung 
eines  Formular-Objektes,  bis  der  Benutzer  ein  Objekt  mit  EXIT-  oder  TOUCHEXIT-Status 
anklickt. 

Deklaration  in  C: 

WORD  form_do  (OBJECT  *fom,  WORD  start) 

{ 

addr_in(0]  =  form; 
int_in[0]  —  start; 
return  crys  if  (50)  ; 

} 

GEM-Arrays: 


Adresse 

Feideiement 

Belegung 

contrl 

contrl  [0] 

50  Opcode  fiir  FORM_DO 

contrl+2 

contrl[l] 

1  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

start 

addrjn 

addrjn[0] 

form 

int_out 

int_out[0] 

Retum-Wert 

Parameter: 

start:  Nummer  des  ersten  zu  editierenden  Objekts  im  Baum  (oder  Null) 

form:  Adresse  des  Objektbaums 

form_do():  Nummer  des  Objekts,  das  der  Benutzer  zur  Beendigung  angeklickt  hat  (bei 
Doppelklick  auf  TOUCHEXIT-Objekten  wird  Bit  15  gesetzt). 
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FORMDIAL  (AES  51) 


“FMD_START”  reserviert  einen  Bildschirmausschnitt,  Dies  hat  normalerweise  keine  weitere 
Auswirkung,  wird  aber  haufig  von  “Bildschirmbeschleunigem”  benutzt,  um  den  belegten 
Bildschinnausschnitt  in  einen  Puffer  zu  kopieren.  Daher  auf  gar  keinen  Fall  weglassen! 

“FMD_GROW”  zeichnet  eine  Reihe  von  sich  ausdehnenden  Rechtecken.  Man  sollte  diese 
Funktion  nicht  iiberstrapazieren,  nur  selten  ist  sie  wirklich  sinnvoll.  Ihr  Sinn  und  Zweck 
besteht  darin,  dem  Benutzer  zusatzliche  Informational  darzubieten  -  zum  Beispiel  wenn  ein 
selektiertes  Objekt  per  Tastaturkiirzel  “geoffnet”  wird. 

Im  Zweifelsfall  sollte  man  eine  Option  anbieten,  diese  Funktion  auszulassen:  Geubte  Benutzer 
werden  es  einem  danken. 

“FMD_SHR1NK”  ist  das  Gegenstiick  zu  “FMDJ3ROW”  (schrumpfende  Rechtecke). 

“FMD_FINISH”  gibt  den  durch  “FMD_START”  reservierten  Bildausschnitt  wieder  frei.  In 
der  Realitat  heiBt  das:  GEM  sorgt  dafiir,  daB  alle  betroffenen  Fensterinhalte  wieder  restauriert 
werden  (das  heiBt  allerdings  auch:  Das  Rechteck  muB  vollstandig  innerhalb  des  Arbeitsbereichs 
von  Fenster  0  liegen).  Dazu  verschickf  es  an  alle  betroffenen  AES-Prozesse  entsprechende 
WM_REDR  A  W  -Mitteilungen. 


Deklaration  in  C: 


WORD  form_dial  (WORD  flag,  WORD  littlx, 
WORD  littlh,  WORD  bigx, 
WORD  bigh) 


{ 


int_in[0] 
int_in  [1] 
int_in [2] 
int_in[3] 
int_in [ 4  ] 
int_in[5] 
int_in[6] 
int_in[7] 
int  in [8] 


flag; 

littlx; 

littly; 

littlw; 

littlh; 

bigx; 

bigy; 

bigw; 

bigh; 


return  crys_if  (51); 


WORD  littly,  WORD  littlw, 
WORD  bigy,  WORD  bigw. 
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GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

5 1  Opcode  fiir  FORM_DIAL 

contrl+2 

contrl[l] 

9  #  Eintrage  in  intjn 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr  Jn 

contrI+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

intjn 

intjn  [0] 

flag 

intJn+2 

intjn[i] 

littlx 

intJn+4 

intjn[2] 

littly 

intJn+6 

intjn  [3] 

littlw 

intJn+8 

intjn[4] 

littlh 

int_in+10 

intjn[5] 

bigx 

intjn+12 

intjn  [6] 

bigy 

int_in+14 

intjn[7] 

bigw 

intjn+16 

intjn[8] 

bigh 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

flag:  Typ  der  FORM_DIAL-Funktion: 

FMD_START  (0):  Reserviert  Bildschirmbereich  fiir  Dialogbox. 

FMDJ3ROW  (1):  Zeichnet  sich  ausdehnendes  Rechteck. 

FMD_SHRINK  (2):  Zeichnet  schrumpfendes  Rechteck. 

FMD_FINISH  (3):  Gibt  Bildschirmbereich  wieder  frei. 
littL.:  Koordinaten  fiir  Rechteck  in  seiner  kleinsten  GroBe 
big...:  Koordinaten  fiir  Rechteck  in  seiner  groBten  Ausdehnung 

Bemerkungen 

Die  Subfunktionen  “FMD_GRO  W”  und  “FMD_SHRINK”  sind  ubrigens  inPC-GEM  2.0  dem 
Rechtsstreit  zwischen  Digitial  Research  und  Apple  zum  Opfer  gefallen! 

“FMD_FINISH”  wird  gem  dazu  benutzt,  um  einen  Bildsehirmneuaufbau  auszulosen.  Aber 
Vorsichf.  Die  Meniileiste  (die  auBerhalb  des  Arbeitsbereichs  von  Fenster  0  liegt)  kann  man 
so  nicht  restaurieren! 
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FORMALERT  (AES  52) 


Stellt  eine  Alarmbox  (Alertbox)  auf  dem  Bildschirm  dar. 

“form_alert()”  ist  kein  Ersatz  fur  eine  Dialogbox  und  solite  ausschlieBlich  fiir  kurze  lnforma- 
tionen  und  Fehlermeldungen  eingesetzt  werden.  Dabei  solite  man  die  verschiedenen  Symbole 
folgendermaBen  benutzen: 

Das  Ausrufezeichen  (“NOTE”)  steht  fur  eine  kurze  Meldung,  die  der  Benutzer  nur  bestatigen 
soli.  Das  konnte  ein  Sicherheitshinweis,  aber  auch  eine  Benachrichtigung  iiber  einen  abge- 
schlossenen  Arbeitsgang  sein. 

Das  Fragezeiehen  (“WAIT”)  dient  fiir  Sicherheitsabfragen,  bevor  ein  bestimmter  Vorgang 
(wie  zum  Beispiel  das  Formatieren  einer  Diskette)  durchgefiihrt  wird. 

Das  Stopschild  (“STOP”)  ist  angebracht,  wenn  ein  emsthaftes  Problem  aufgetreten  ist,  das  der 
Benutzer  unbedingt  zur  Kenntnis  nehmen  muB. 

Deklaration  in  C: 

WORD  form_alert  (WORD  defbut,  const  CHAR  *astring) 

{ 

int_in[0]  =  defbut; 
addr_in[0]  =  astring; 
return  crys__if  (52) ; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

52  Opcode  fur  FORM_.ALERT 

contrl+2 

contrl[l] 

1  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

defbut 

addrjn 

addr_in[0] 

astring 

int_out 

int_out[0] 

Retum-Wert 
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Parameter: 

defbut: 

astring: 


form_alert(); 


Nummer  des  Default-Knopfes  (0:  keiner,  1:  erster  etc.) 

Adresse  des  Strings  mit  den  Daten  fur  die  Alertbox. 

Format:  “[<Icon>][<Text>][<Buttons>]”,  wobei  <Icon>: 

NOJCON  (0):  kein  Icon 
NOTE  (I) 

WAIT  (2) 

STOP  (3) 

<Text>:  maximal  fiinf  Textzeilen  mit  max.  30  Zeichen,  untereinander 

durch  >l<  getrennt 

<Buttons>:  bis  zu  drei  durch  >l<  getrennte  Button-Namen. 

Nummer  des  Knopfs,  mit  dem  die  Alertbox  verlassen  wurde  (der  am  weitesten 
links  stehende  Knopf  hat  die  Nummer  1). 
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FORMERROR  (AES  53) 


Zeigt  eine  Wammeldung  fur  MS-DOS -Fehler  an.  Dies  aus  Kompatibilitatsgriinden  zum  PC- 
GEM.  Daher  muB  man  zunachst  die  GEMDOS-Fehlemummem  auf  die  Codierung  von  MS- 
DOS  umrechnen! 


Deklaration  in  C: 

WORD  form_error  (WORD  errnum) 
{ 

int_in[0]  =  errnum; 
return  crys_if  (53) ; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

^53 

Opcode  fiir  FORM_ERROR 

contrl+2 

contrl[l] 

1 

#  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

int_in 

int_in[0] 

ermum 

int_out 

int_out(0] 

Retum-Wert 

Parameter: 

ermum:  MS-DOS -Fehlemummer.  Als  Formel  zur  Berechnung  der  Fehlemummer  aus 

dem  vom  GEMDOS  gelieferten  Code  hat  sich  “(~ermo)~30”  bewahrt. 
2,3,18:  “Diese  Anwendung  kann  das  angesprochene  Objektnicht  finden.” 
4:  “Die  Anwendung  bendtigt  mehr  Platz  zum  Offnen  einer  neuen 

Datei.  SchlieBen  Sie  eine  nicht  benotigte  Datei.” 

5 :  “Objekt  mit  gleichem  Namen  bereits  vorhanden  bzw.  hat  den  “Nur- 

Lesen”-Status.” 

8,10,1 1:  “Der  Arbeitsspeicher  reicht  nicht  ftir  diese  Anwendung.” 

15:  “Floppy  mit  dieser  Kennung  unbekannt.” 
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form_error():  Nummer  des  Buttons,  den  der  Benutzer  gedriickt  hat  (immer  0,  da  alle  Alert- 
Boxen  nur  einen  Knopf  haben) 

Bemerkungen 

Der  Wortlaut  der  Fehlermeldungen  in  PC-GEM  2.0  weicht  teilweise  betrSchtlich  davon  ab, 
SinngemaG  erhalt  man  aber  die  gleichen  Mitteilungen. 
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FORM_CENTER  (AES  54) 


Zentriert  Objekt  in  der  Bildschirmmitte  und  gibt  die  tatsachliche  Position  auf  dem  Bildschirm 
zuriick.  Dabei  werden  fur  Breite  und  Hohe  auch  die  speziellen  Attribute  wie  z.  B.  “Outlined” 
beriicksichtigt  (Ausnahme:  “Shadowed”).  Diese  Werte  kann  man  dann  speziell  in  Verbindung 
mit  “form_dial()”  und  “objc_draw()”  verwenden. 

In  alten  GEM-Versionen  wird  aufierdem  das  Objekt  so  positioniert,  da8  der  linke  Rand  auf 
einer  By  tegrenze  liegt.  Wenn  man  also  darauf  erpicht  ist,  daft  das  Objekt  an  einer  By  te-Grenze 
beginnt,  sollte  man  dafiir  sorgen,  daft  die  Objektbreite  in  Zeichen  gerade  ist  (bei  einem  aeht 
Pixel  breiten  Systemzeichensatz). 

Deklaration  in  C: 

WORD  form_center  (OBJECT  *tree,  WORD  *pcxr  WORD  *pcy,  WORD  *pcw, 

WORD  *pch) 

{ 

addr_in[0]  =  tree; 
crys_if  (54); 

*pcx  =  int_out[l]; 

*pcy  =  int_out [ 2 ] ; 

*pcw  =  int_out[3); 

*pch  =  int_out[4]; 
return  int_out [0] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

54  Opcode  fur  FORM_CENTER 

contrl+2 

contrl[l] 

0  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

5  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr  Jn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

tree 

int_out  | 

int_out[0] 

Return- Wert  (reserviert,  i miner  1) 

int_out+2 

int_out[l] 

pcx 
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Adresse 

Feldelement 

Belegung 

int_out+4 

int_out[2] 

pcy 

int_out+6 

int_out[3] 

pew 

int_out+8 

int_out[4] 

pch 

Parameter: 

tree:  Anfangsadresse  des  Objektbaums 

pcx,  pcy, 

pew,  pch:  zentrierte  Koordinaten 
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FORMJCEYBD  (AES  55) 


Nimmt  Tastatureingaben  in  ein  Formular  vor  (siehe  auch  “objc_edit()”).  Dabei  wird  unter 
Umstanden  das  Eingabefeld  geandert  (Cursor-Tasten  und  “TAB”)  oder  das  Default-Objekt 
selektiert  (“RETURN”). 


Dekiaration  in  C: 

WORD  formjceybd  (OBJECT  *forra,  WORD  obj,  WORD  nxt_obj, 

WORD  thechar,  WORD  *pnxt_obj,  WORD  *pchar) 

{ 

addr_in[0]  =  form; 
int_in[0]  =  obj; 
int_in[l]  =  thechar; 
int_in(2]  -  nxt__obj; 
crys_if  (55)  ; 

*pnxt_obj  =  int_out[lj; 

*pchar  =  int_out[2]; 
return  int_out  [0] ; 

} 

GEM-Arrays: 


Adresse 

Feldeiement 

Belegung 

contrl 

contrl[0] 

55  Opcode  fur  FORMJCEYBD 

contrl+2 

contrl[l] 

3  #  Eintrage  in  int_in 

contrl+4 

contr][2] 

3  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr_in 

contrl+8 

contrl[4J 

0  #  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

form 

intjn 

int_in[0] 

obj 

int_in+2 

int_in[l] 

thechar 

int_in+4 

int_in[2] 

nxt__obj 

int_out 

int_out[0] 

Retum-Wert 

int_out+2 

int_out[l] 

pnxt_obj 

int_out+4 

int„out[2] 

pchar 
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Parameter: 

form: 

obj: 

nxt_obj: 

thechar: 

form_keybd(): 

pnxtobj: 

pchar: 


Anfangsadresse  des  Objektbaums 
Objektnummer  des  aktuellen  EDIT-Objektes 
unbenutzt  -  auf  0  setzen 

Eingegebenes  Zeichen,  das  eingetragen  werden  soli 
0:  Exit-Objekt  gedriickt 

>0:  Dialog  noch  nicht  beendet 

aktuelles  EDIT-Objekt  fiir  den  nachsten  Aufruf  (verandert  sich,  wenn 
“TAB”,  Cursor-Tasten  oder  “RETURN”  ubergeben  wurde) 

0:  Zeichen  war  Cursortaste,  “TAB”  oder  “RETURN” 

>0:  iibergebenes  Zeichen 
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FORMJBUTTON  (AES  56) 


Nimmt  Mausknopfeingaben  in  ein  Formular  vor  (simuliert  das  Anklicken  eines  Objekts). 


Deklaration  in  €: 

WORD  forrn_button  (OBJECT  *form,  WORD  obj,  WORD  elks, 
WORD  *pnxt_obj) 

{ 

addr_in[0]  =  form; 
int__in[0]  =  obj; 
int__in[l]  =  elks; 
crys_if  (56) ; 

*pnxt_obj  =  int_out[l]; 
return  int__out  [0]  ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

56  Opcode  fur  FORM.  BUTTON 

contrl+2 

contrlfl] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

2  #  Emtrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

form 

int„in 

int_in[0] 

obj 

int_in+2 

intjn[l] 

elks 

int_out 

int_out[0] 

Retum-Wert 

int_out+2 

int_out[l] 

pnxt_obj 

Parameter: 

form:  Anfangsadresse  des  Objektbaumes 
obj:  Objekt,  das  bearbeitet  werden  soil 
elk:  Anzahl  der  zu  simulierenden  Mausklicks 


652 


ATARI  Profibuch 


form_button(): 

pnxt_obj: 


0:  Es  wurde  zuletzt  ein  EXIT-  oder  TOUCHEXIT-Objekt  angeklickt 

>0:  Dialog  noch  nicht  abgeschlossen 

neues  aktuelles  Objekt  (bei  Doppelklick  auf  ein  TOUCHEXIT-Objekt  wird 
Bit  15  gesetzt)  oder 

0:  Das  nachste  Objekt  hat  HIDDEN-  oder  DIS  ABLED-Status  oder  ist 

nicht  EDITABLE. 


AES-Betriebssystemroutinen 


653 


GRAF -Funktionen 


GRAFRUBBOX  (AES  70) 


Stellt  auf  dem  Bildschirm  eine  “Gummiband-Box”  dar.  Dabei  steht  die  linke  obere  Ecke  fest, 
und  die  rechte  untere  Ecke  folgt  den  Mausbewegungen  des  Benutzers,  solange  die  Maustaste 
festgehalten  wird.  Daher  sollte  “graf_rubbox()”  auch  nur  bei  gedriickter  Maustaste  aufgerufen 
werden. 

Zuriickgeliefert  werden  Breite  und  Hohe  des  Rechtecks  in  dem  Moment,  wenn  die  Maustaste 
losgelassen  wird. 

Deklaration  in  C: 

WORD  graf_rubbox  (WORD  xorigin,  WORD  yorigin,  WORD  wmin,  WORD  hmin, 
WORD  *pwend,  WORD  *phend) 

{ 

int_in[0]  =  xorigin; 
int_in[l]  =  yorigin; 
int_in[2]  =  wmin; 
int_in[3]  =  hmin; 
crys_if  (70); 

*pwend  =  int_out[l]; 

*phend  =  int_out  [  2  ] ; 
return  int_out[0]; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

70  Opcode  fur  GRAF_RUBBERBOX 

contrl+2 

control] 

4  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

3  #  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

0  #  Eintrage  in  addr  Jn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

xorigin 

int_in+2 

int„in[l] 

yorigin 

intJn+4 

int_in[2] 

wmin 
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Adresse 

Feldelement 

Belegung 

int_in+6 

int_in[3] 

hmin 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

int_out+2 

int_out|l  1 

pwend 

int_out+4 

int_out[2] 

phend 

Parameter: 

xorigin, 

yorigin:  Koordinaten  der  linken  oberen  Ecke 

wmin,  hmin:  Kleinste  (Anfangs-)Ausdehnung  des  Rechtecks 

pwend,  phend:  Ausdehnung  des  Rechtecks  bei  Beendigung  der  Funktion 

Bemerkungen 

In  alteren  GEM-Dokumentationen  auch  haufig  als  “graf_rubberbox()”  bezeichnet! 
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GRAFDRAGBOX  (AES  71) 


LaBt  den  Benutzer  den  UmriB  eines  Rechtecks  (outline)  innerhalb  eines  anderen  Rechtecks 
verschieben. 


Deklaration  in  C: 

WORD  grafjdragbox  (WORD  w,  WORD  h,  WORD  sx,  WORD  sy,  WORD  xc, 

WORD  yc,  WORD  wc,  WORD  he,  WORD  *pdx,  WORD  *pdy) 

{ 

int_in[0]  =  w; 
int_in[l]  =  h; 
int_in[2]  =  sx; 
int_in(3]  =  sy; 

±nt_in[4]  =  xc; 
int_in[5]  =  yc; 
int_in[6]  =  wc; 
int_in[7]  =  he; 
crys_if  (71); 

*pdx  =  int_out[l]; 

*pdy  =  int_out[2]; 
return  int_out [ 0 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

7 1  Opcode  fur  GRAF_DRAGBOX 

contrl+2 

contrl[l] 

8  #  Eintrage  in  intjn 

contrl+4 

contrl  [2] 

3  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

intjn[0j 

w 

int_in+2 

int_in[l] 

h 

int_in+4 

int_in[2] 

sx 

int_in+6 

int„in[3] 

sy 

int_in+8 

int_in[4] 

xc 

int_in+10 

int_in[5] 

yc 
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Adresse 

Feldelement 

Belegung 

int_in+I2 

int_in[6] 

wc 

int_in+14 

int_in[7] 

he 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

int_out+2 

int_out[l] 

pdx 

int_out+4 

int_out[2] 

pdy 

Parameter: 

w,  h:  MaBe  des  zu  bewegenden  Rechtecks 

sx,  sy:  Anfangskoordinaten  des  Rechtecks 

xc,  yc,  wc,  he:  MaBe  des  “auBeren”  Rechtecks 

pdx,  pdy:  Koordinaten  des  verschobenen  Rechtecks  bei  Loslassen  der  Maustaste 
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GRAF_MBOX  (AES  72) 


Zeichnet  eine  sich  bewegende  Box  mit  konstanter  GioBe.  In  alteren  GEM-Dokumentationen 
wird  diese  Funktion  auch  haufig  als  “graf_moveboxO”  bezeichnet! 

Deklaration  in  C: 

WORD  grafjnbox  (WORD  w,  WORD  h,  WORD  srcx,  WORD  srcy,  WORD  dstx, 

WORD  dsty) 

{ 

int_in[0]  =  w; 
int_in[l]  =  h; 
int_in[2]  =  srcx; 
int_in[3]  =  srcy; 
int_in[4]  =  dstx; 
int_in[5]  =  dsty; 
return  crys_if  (72) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

72  Opcode  fUrGRAF_MBOX 

contrl+2 

contrl  [1] 

6  #  Eintrage  in  intjn 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

w 

int_in+2 

int„in[l] 

h 

int_in+4 

int_in[2] 

srcx 

int_in+6 

int_in[3] 

srcy 

int_in+8 

int_in[4] 

dstx 

intjn+10 

int_in[5] 

dsty 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter; 

w,  h;  MaBe  des  Rechtecks 

stx,  sty:  Anfangsposition 

dstx,  dsty:  Endposition 
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GRAFGROWBOX  (AES  73) 


Zeichnet  ein  sich  bewegendes  Rechteck,  das  sich  ausdehnt. 


Deklaration  in  C: 

WORD  graf_growbox  (WORD  stx,  WORD  sty,  WORD  stw,  WORD  sth, 

WORD  finx,  WORD  finy,  WORD  finw,  WORD  finh) 

{ 

int_in[0]  =  stx; 
int_in[l]  =  sty; 
int_in[2]  =  stw; 
int_in[3]  =  sth; 
int_in ( 4 ]  =  f inx ; 
int_in[5]  =  finy; 
int__in[6]  =  finw; 
int_in [ 7 ]  =  f inh ; 
return  crys_if  (73) ; 

) 


GEM-Arrays: 


Adresse 

Feldekment 

Belegung 

contrl 

contrlfOJ 

73  Opcode  fur  GRAF  GROWBOX 

contrl+2 

contrlfl] 

8  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int__in[0] 

stx 

intjn+2 

int_in[l] 

sty 

int_in+4 

int„in[2] 

stw 

int_in+6 

int_in[3] 

sth 

int_in+8 

int_in[4] 

finx 

int_in+10 

int_in[5] 

finy 

int_in+12 

int_in[6] 

finw 

int_in+14 

int_in[7] 

finh 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 
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Parameter: 

stx,  sty,  stw,  sth:  AnfangsmaBe  des  Rechtecks 

finx,  finy,  Finw,  fxnh:  EndmaBe  des  Rechtecks 

Bemerkungen 

Ab  PC- GEM  2.0  wird  der  Befehl  ignoriert. 
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GRAF_SHRINKBOX  (AES  74) 


Zeichnet  ein  sich  bewegendes  Rechteck,  das  schrumpft. 


Deklaration  in  C: 

WORD  graf__shrinkbox  (WORD  finx,  WORD  finy,  WORD  finw,  WORD  finh, 

WORD  stx,  WORD  sty,  WORD  stw,  WORD  sth) 

{ 

int_in[0]  =  finx; 
int_infl]  =  finy; 
int_in[2]  =  finw; 
int_in[3]  =  finh; 
int__in[4]  =  stx; 
int__in[5]  =  sty; 
int_in[6]  =  stw; 
int_in[7]  =  sth; 
return  crys_if  (74) ; 

} 


GEM-Arrays: 


Adresse 

Feld  element 

Belegung 

contrl 

contrl  [0] 

74  Opcode  fur  GRAF_SHRINKBOX 

contrl+2 

contrlfl] 

8  #  Eintrage  in  intjn 

contrl+4 

contrl[2] 

I  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr_in 

contrl+B 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

finx 

int_in+2 

int_in[l] 

fmy 

int_in+4 

int_in[2] 

finw 

int_in+6 

int_in[3] 

finh 

int_in+8 

int_in[4J 

stx 

int_in+10 

int_in[5] 

sty 

int_in+12 

int_in[6] 

stw 

int_in+14 

int_in[7] 

sth 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 
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Parameter: 

finx,  finy,  finw,  finh:  En  dm  a  fie  des  Rechtecks 

stx,  sty,  stw,  sth:  Anfangsmafie  des  Rechtecks 

Bemerkungen 

Wird  ab  PC-GEM  2.0  ignoriert. 
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GRAF_WATCHBOX  (AES  75) 


Der  Objektstatus  eines  Objekts  wird  in  Abhangigkeit  von  der  Position  des  Mauszeigers  gesetzt 
(je  nachdem,  ob  er  sich  innerhalb  Oder  auBerhalb  des  Objekts  befindet).  Die  Funktion  bricht 
bei  Loslassen  des  Mausknopfes  ab. 


Deklaration  in  C: 

WORD  graf_watchbox  (OBJECT  *tree,  WORD  obj,  WORD  instate, 
WORD  outstate) 

{ 

addr_in[0]  =  tree; 
int_in[l]  =  obj; 
int_in[2]  =  instate; 
int_in[3]  =  outstate; 
return  crys_if  (75) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

75  Opcode  fur  GRAF_WATCHBOX 

contrl+2 

contrlfl] 

4  #  Eintrage  in  int.jn 

contrI+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl +6 

contrl[3] 

I  #  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

reserviert 

int_in+2 

int_in[lj 

obj 

int_in+4 

int_in[2] 

instate 

int_in+6 

int__in[3] 

outstate 

addrjn 

addr_in[0] 

tree 

int„out 

int_out[0] 

Retum-Wert 

Parameter: 

obj:  Objektnummer  des  betreffenden  Objekts 
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instate: 


outstate: 


tree: 

graf_watchbox(): 


Status  des  Objekts,  wenn  sich  der  Mauszeiger  innerhalb  derBegrenzung 
befmdet.  Bitbelegung: 

NORMAL  (0x0000) 

SELECTED  (0x0001) 

CROSSED  (0x0002) 

CHECKED  (0x0004) 

DISABLED  (0x0008) 

OUTLINED  (0x0010) 

SHADOWED  (0x0020) 

Status  des  Objekts,  wenn  sich  der  Mauszeiger  auBerhalb  der  Begrenzung 
befindet 

Anfangsadresse  des  Objektbaums 
Beim  Loslassen  des  Knopfes  war  der  Mauszeiger 
0:  auBerhalb  des  Objekts 

1 :  innerhalb  des  Objekts. 
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GRAFSLIDEBOX  (AES  76) 


Dient  zur  Abfrage  von  “Schiebereglem”.  Dazu  verwendet  man  ein  Rechteck,  das  Child  eines 
anderen  Rechtecks  in  einem  Objektbaum  ist. 

Den  Umrifi  (outline)  dieses  Objekts  kann  man  dann  entweder  horizontal  oder  vertikal 
innerhalb  der  Grenzen  des  ubergeordneten  Rechtecks  bewegen. 

Aufruf  nur  bei  gedriickter  Maustaste,  da  beim  Loslassen  des  Knopfes  abgebrochen  wird. 


Deklaration  in  C: 

WORD  graf_slidebox  (OBJECT  *tree,  WORD  parent,  WORD  obj, 
WORD  invert) 

{ 

addr_in[0]  =  tree; 
int_in[0]  =  parent; 
int_in[l]  =  obj; 
int_in[2]  =  isvert; 
return  crys_if  (76) ; 


GEM-Arrays: 

Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

76  Opcode  fur  GRAF_SLIDEBOX 

contrl+2 

contrlfl] 

3  #  Eintrage  in  int_in 

contrl+4 

contrl[2J 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

parent 

int_in+2 

int_in[l] 

obj 

int_in+4 

int_in[2] 

isvert 

addr_in 

addr_in[0] 

tree 

intout 

int_out[0] 

Return-Wert 
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Parameter: 

parent: 

obj: 

vh: 

tree: 

graf_slidebox(): 


Objektnummer  des  iibergeordneten  Rechtecks 
Objektnummer  des  zu  verschiebenden  Rechtecks  (der  Schieber) 

0:  horizontal  verschieben 
1:  vertikal  verschieben 
Anfangsadresse  des  Objektbaums 

relative  Position  des  Schiebers  innerhalb  des  iibergeordneten  Objekts 
(0:  ganz  links  bzw.  oben,  1000:  ganz  rechts  bzw.  unten) 
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GRAF  HANDLE  (AES  77) 


Liefert  das  Handle  der  Bildschirm-Workstation,  auf  die  die  AES  ausgeben.  Weiterhin  erhalt 
man  die  Ausmafie  in  Pixeln  eines  Zeichens  im  Systemzeichensatz. 

Deklaration  in  C: 

WORD  graf_handle  (WORD  *pwchar,  WORD  *phchar,  WORD  *pwbox, 

WORD  *phbox) 

{ 

crys_if  (77); 

*pwchar  =  int_out [ 1 ] ; 

*phchar  =  int_out[2]; 

*pwbox  =  int_out[3]; 

*phbox  =  int__out  [  4  ] 
return  int_out [0] ; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

77  Opcode  fur  GRAF_  HANDLE 

contrl+2 

contrl[l] 

0  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

5  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

■  0  #  Eintrage  in  addr_out 

int_out 

int_out[0] 

handle 

int_out+2 

int_out[l] 

pwchar 

int_out+4 

int_out[2] 

phchar 

int_out+6 

int_out[3] 

pwbox 

int_out+8 

int_out[4] 

phbox 

Parameter: 

graf_handle():  Handle  der  von  den  AES  gedffnetcn  VDI- Workstation 

pwchar,  phchar;  Breite  und  Hohe  (in  Punkten)  eines  Zeichens  aus  dem  Systemzeichen¬ 
satz  (ftir  Meniis  und  Dialoge). 

pwbox,  phbox:  Made  eines  Quadrates,  in  das  ein  beliebiges  Zeichen  aus  dem  System¬ 

zeichensatz  komplett  hineinpassen  wiirde.  Diese  Information  wird  auch 
von  den  AES  ftir  die  Breiten  dereinzelnenFenster-Elemente  verwendet! 
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GRAFJVfOUSE  (AES  78) 


Wahlt  fur  den  Mauszeiger  entweder  eine  von  acht  vordefinierten  oder  eine  vom  Benutzer 
definierte  Form.  Alles  was  nicht  Pfeil  oder  “BUSYBEE”  ist,  sollte  man  nur  innerhalb  des 
Arbeitsbereichs  des  eigenen  (obersten)  Fensters  verwenden! 

Deklaration  in  C: 

WORD  grafjnouse  (WORD  m_number,  MFORM  *m_addr) 

{ 

int_in[0]  =  m_number; 
addr_in[0]  =  m_addr; 
return  crys_if  (78) ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

78  Opcode  fur  GRAF_MOUSE 

contrl+2 

contrl[l] 

1  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl  [3J 

1  #  Eintrage  in  addr  jn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

m_number 

addr_in 

addr_in[0] 

m_addr 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 


m_oumber: 


Nummer  der  Mausform: 


ARROW  (0): 
TEXTCRSR  (1): 
HOURGLASS  (2): 
BUSYBEE  (2): 


Pfeil 

Text-Cursor  (vertikaler  Strich):  Texteingabe 
oder 

Biene  (Bezeichnung  stammt  vom  PC-GEM,  bei  dem 
statt  dessen  eine  Sanduhr  gezeigt  wird):  Computer  ist 
beschaftigt  (und  fleiSig). 
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POINT_HAND(3):  zeigende  Hand:  Auswahl,  Dimensionierung 
FLATJHAND  (4):  flache  Hand  mit  ausgestreckten  Fingem:  Auswahl/ 
Positionierung 

THIN_CROSS  (5):  feines  Fadenkreuz:  Auswahl/Zeichnen 
THICK_CROSS  (6):  breites  Fadenkreuz 
OUTL_CROSS  (7):  Umrissenes  Fadenkreuz 
USER_DEF  (255):  in  faddr  adressierte  Mausform 
M_OFF  (256):  Mauszeiger  ausschalten  (Aufrufe  konnen  verschachtelt 

werden!) 

M_ON  (257):  Mauszeiger  einschalten 

m_addr:  Zeiger  auf  Mausform  folgender  Gestalt: 

typedef  struct 

{ 

WORD  mf_xhot; 

WORD  mf_yhot; 

WORD  mf_nplanes; 

WORD  mfjEg; 

WORD  mf_bg; 

WORD  mf_mask [16] ; 

WORD  mf _dat a  [  1 6  ] ; 

}  MFORM; 


/*  X-Pos.  Aktionspunkt  */ 

/*  Y-Pos.  Aktionspunkt  */ 

/*  Anzahl  planes  (=1)  */ 

/*  Maskenfarbe  (normal:  0)  */ 
/*  Zeigerfarbe  (normal:  1)  */ 
/*  Maskenform  */ 

/*  Zeiger form  */ 
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GRAF_MKSTATE  (AES  79) 

Liefert  Mausposition  sowie  Status  der  Maustasten  und  der  Tastatur. 

Deklaration  in  C: 

WORD  grafjnkstate  (WORD  *pmx,  WORD  *pmy,  WORD  ^prostate, 
WORD  *pkstate) 

{ 

crys__if  (79); 

*pmx  =  int__out  [1] ; 

*pmy  =  int_out [2] ; 

*pmstate  =  int_out[3j; 

*pkstate  =  int_out [  4  ] ; 
return  int_out[0]; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

79  Opcode  fur  GRAF_MKSTATE 

contrl+2 

contrl[l] 

0  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

5  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr_in 

contrl+8 

contrl[4J 

0  #  Eintrage  in  addr_out 

int_out 

int_out[0] 

Return- Wert  (reserviert,  immer  1) 

int_out+2 

int_out[l] 

pmx 

int_out+4 

int_out[2] 

pmy 

int_out+6 

int_out[3] 

pmstate 

int_out+8 

int_out[4] 

pkstate 

Parameter: 

pmx,  pmy:  aktuelle  Mausposition 

pmstate:  Status  der  Maustasten  (Bit  0:  linke  Taste  usw.) 

pkstate:  Tastaturstatus.  Bitbelegung: 

K^RSHIFT  (0x0001):  rechte  Shift-Taste 

K_LSHIFT  (0x0002):  linke  Shift-Taste 

K_CTRL  (0x0004):  Control-Taste 

K_ALT  (0x0008):  Alternate-Taste 


670 


ATARI  Profibuch 


SCRP-Funktionen 


SCRP_READ  (AES  80) 


Liest  den  Pfadnamen  fur  das  Directory  (scrap  directory),  in  dem  Daten  fur  die  Zwischenablage 
(clipboard)  abgespeichert  werden. 

Deklaration  in  C: 

WORD  scrp_read  (CHAR  *pscrap) 

{ 

addr_in[0]  =  pscrap; 
return  crys_if  (80); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

80 

Opcode  fiir  SCRP_READ 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  intin 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  addr  Jn 

contrl+8 

contrl(4J 

0 

#  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

pscrap 

int_out 

int_out[0] 

1  Retum-Wert 

Parameter: 

pscrap:  Puffer  fiir  den  Pfadnamen 

(Vorsicht!  Moglicherweise  groBe  Lange  bei  tief  verschachtelten  Ordnem!). 
scrp_read():  Atari-GEM:  0:  Fehler 

PC-GEM  2.0:  -1 :  Kein  Pfad  vorhanden 

>=0:  Bitvektor,  der  dariiber  Auskunft  gibt,  ob  Dateien  mit 
gewissen  Extensions  gefunden  worden  sind.  Bitbelegung: 
BitO:  SCRAP.CSV 
Bit  1:  SCRAP.TXT 
Bit  2:  SCRAP.GEM 
Bit  3:  SCRAP.IMG 
Bit  4:  SCRAP.DCA 
Bit  5:  SCRAP.USR 
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SCRPWRITE  (AES  81) 


Legt  den  Zugriffspfad  fiir  das  aktuelle  Scrap-Directory  fest. 


Deklaration  in  C: 

WORD  scrp_write  {CHAR  *pscrap) 
{ 

addr_in[0]  =  pscrap; 
return  crys_if  (81) ; 

} 


GEM*Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  fO] 

81 

Opcode  fur  SCRPJWRITE 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

pscrap 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

pscrap:  Name  des  neuen  Pfades 
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SCRPCLEAR  (AES  82)  -  nur  in  PC-GEM  ab  Version  2.0 


Loscht  alle  Dateien  im  aktuellen  Scrap-Directory. 

Deklaration  in  C: 

WORD  scrp_clear  (void) 

{ 

return  crys__if  (82)  ; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Beiegung 

contrl 

contrl  [0] 

82 

Opcode  fiir  SCRP_CLEAR 

contrl+2 

contrl  [1] 

0 

#  Eintrage  in  int_in 

contrI+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 
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FSEL-Funktionen 


FSEL JNPUT  (AES  90) 


Bringt  die  handelstibliche  Dateiauswahlbox  (den  File-Selector)  auf  den  Bildschirm. 

Alte  AES-Versionen  (vor  GEM  1.4)  konnen  maximal  100  Dateien  anzeigen  und  wamen 
gegebenenfalls  mit  einem  “Ping”,  wenn  Dateien  deshalb  nicht  gezeigt  werden  konnen. 
Daneben  gab  es  auch  noch  schwerwiegendere  Fehler,  namentlich  bei  der  Behandlung  von 
BIOS-Fehlem  (zum  Beispiel:  Diskette  nicht  eingelegt). 

Ab  GEM  1 .4  hat  Atari  den  File-Selector  iiberarbeitet  und  viele  (aber  leider  nicht  alle)  Fehler 
beseitigt.  Wichtigste  Neuerungen  sind  die  Buttons,  mit  denen  man  per  Mausklick  auf  andere 
Laufwerke  wechseln  kann  und  die  konfigurierbare  Titelzeile  (siehe  “fsel_exinput()”). 

Auf  dem  PC  ging  die  Entwicklung  in  eine  andere  Richtung.  Zunachst  kann  man  zwischen 
verschiedenen  logischen  Laufwerken  umschalten,  indent  man  nach  Erreichen  des  Wurzelver- 
zeichnisses  nochmals  die  Close-Box  anklickt  (man  erhalt  dann  eine  Liste  der  vorhandenen 
Laufwerke  -  siehe  dazu  auch  “appl_bvset()”).  AuGerdem  kann  zusatzlich  am  Ende  des  Pfad- 
namens  eine  Liste  von  -  durch  Kommata  getrennten  -  Suchmasken  angegeben  werden. 

Deklaration  in  C: 

WORD  fsel_input  (CHAR  *pipath,  CHAR  *pisel,  WORD  *pbutton) 

{ 

addr_in[0]  =  pipath; 
addr__in[l]  =  pisel; 
crys_if  (90); 

*pbutton  =  int_out [ 1 ] ; 
return  int_out[0]; 

> 

GEM-Arrays; 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

90 

Opcode  fur  FSEL  JNPUT 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  intjn 

contrI+4 

contrl[2] 

2 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

2 

#  Eintrage  in  addr  Jn 
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Adresse 

Feldelemente 

Belegung 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

addr_in 

addr  jn[0] 

pipath 

addr_in+4 

addr_in[l] 

pisel 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

int_out+2 

int_out[l] 

pbutton 

Parameter: 


pipath: 


pisel: 

pbutton: 

fsel_input(): 


Name  des  standardmaBigen  absoluten  Zugriffspfades  inkl.  angehangter  Such- 
maske.  Enthalt  nach  dem  Aufruf  den  vom  Benutzer  geanderten  Pfadnamen 
(also  genau  den,  der  auf  dem  Bildschirm  zu  sehen  ist). 

Vorgewahlter  Dateiname.  Enthalt  nach  dem  Aufruf  den  vom  Benutzer  ausge- 
wahlten  Dateinamen. 

0:  Es  wurde  “Abbruch”  gedruckt. 

1:  Es  wurde  “OK”  gedruckt. 

Sollte  man  auf  keinen  Fall  ignorieren,  weil  beispielsweise  bei  Speichermangel 
ein  Fehler  gemeldet  wird! 
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FSEL  EXINPUT  (AES  91)  -  erst  ab  GEM  1.4 


Entspricht  “fsel_input()”  mit  dem  Unterschied,  daft  zusatzlich  eineZeichenkette  als  Dialogbox- 
Titel  iibergeben  werden  kann. 


Deklaration  in  C: 

WORD  fsel_exinput  (CHAR  *pipath,  CHAR  *pisel,  WORD  *pbutton, 
CHAR  *plabel) 

{ 

addr_in[0]  =  pipath; 
addr_in[l]  =  pisel; 
addr_in[2]  =  plabel; 
crys_if  (91); 

*pbutton  =  int_out[l); 
return  int_out [ 0 ) ; 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

9 1  Opcode  fur  FSELJEXINPUT 

contrl+2 

control] 

0  #  Eintrage  in  int  Jn 

contrl+4 

contrl  [2] 

2  #  Eintrage  in  int„out 

contrl+6 

contrl[3] 

3  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

addrjn 

addr_in[0] 

pipath 

addr_in+4 

addr_in[l] 

pisel 

addr_in+8 

addr_in[2] 

plabel 

int_out 

int_out.[0] 

Retum-Wert  (0:  Fehler) 

int_out+2 

int„out[l] 

pbutton 

Parameter: 

pipath:  Name  des  standardmaBigen  absoluten  Zugriffspfades  inkl,  angehangter  Such- 

maske.  Enthalt  nach  dem  Aufruf  den  vom  Benutzer  geanderten  Pfadnamen 
(also  genau  den,  der  auf  dem  Bildschirm  zu  sehen  ist). 
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pisel: 

plabel: 

pbutton: 

fsel_exinput(): 


Bemerkungen 

Und  so  sollte  man  das  Vorbandensein  von  “fsel_exinput  ()"  testen  (die  AES-Versionen  2.x 
werden  aus  Riicksicht  auf  “ABC-GEM”  herausgefiltert): 

if  (( (global [0]  >=0x0140)  &&  (global [0]  <0x0200))  || 

(global [0]  >=  0x0300)) 

{ 


Vorgewahlter  Dateiname.  Enthalt  nach  dem  Aufruf  den  vom  Benutzer 
ausgewahlten  Dateinamen. 

Titelzeile 

0:  Es  wurde  “Abbruch”  gedriickt. 

1 :  Es  wurde  “OK”  gedriickt. 

Sollte  man  aufkeinenFallignorieren,weilbeispielsweisebeiSpeichermangel 
ein  Fehler  gemeldet  wird! 


/*  fsel_exinput  verfiigbar  */ 

} 

else 

{ 

/*  statt  dessen  fsel_input  benutzen  */ 
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WIND-Funktionen 


WIND_CREATE  (AES  100) 


Meldet  bei  den  AES  ein  neues  Fenster  an,  fur  das  eine  entsprechende  Fenster-Nummer 
(window  handle)  zuriickgeliefert  wird. 

Gleichzeitig  werden  Fenster-Attribute  und  maximale  Grofie  festgelegt. 


Deklaration  in  C: 

WORD  wind__create  (WORD  kind,  WORD  wx,  WORD  wy,  WORD  ww,  WORD  wh) 
{ 

int__in[0]  =  kind; 
int_in[l]  =  wx; 
int_in[2]  =  wy; 
int_in[3]  =  ww; 
int_in[4]  =  wh; 
return  crys_if  (100)  ; 

} 

GEM-Arrays; 


Adrcsse 

Feldelement 

Belegung 

contrl 

contrl[0] 

100  Opcode  fur  WIND_CREATE 

contrl+2 

contrl[l] 

5  #  Eintrage  in  intjn 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

0  #  Eintriige  in  addr Jin 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr„out 

int_in 

int_in[0] 

kind 

int_in+2 

int_in[l] 

wx 

int_in+4 

int_in[2] 

wy 

intJn+6 

int_in[3] 

ww 

int_in+8 

int_in[4] 

wh 

int_out 

int_out[0] 

Retum-Wert  (<0:  Fehler) 
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Parameter: 

kind:  Vorhandene  Fensterkomponenten.  Bitbelegung: 

NAME  (0x0001):  Titelbalken  mit  Name 

CLOSE  (0x0002):  SchlieBbox 

FULL  (0x0004):  Full-Box 

MOVE  (0x0008):  Bewegungsbox 

(Schattierung  im  Balken) 

INFO  (0x0010):  Infozeile 

SIZE  (0x0020):  Grofienverstellung 

UPARROW  (0x0040):  Pfeil  nach  oben 

DNARROW  (0x0080):  Pfeil  nach  unten 

VSLIDE  (0x0100):  Vertikaler  Schieber 

LFARROW  (0x0200):  Pfeil  nach  links 

RTARROW  (0x0400):  Pfeil  nach  rechts 

HSLIDE  (0x0800):  Horizontaler  Schieber 

HOTCLOSEBOX  (0x1000):  Close-Box  hat  Auto-Repeat 

(erst  abPC-GEM  2.0) 

wx,  wy,  ww,  wh:  Fensterkoordinaten  bei  groBter  Ausdehnung 

wind_create() :  Fenster-Kennung  (window  handle)  des  erzeugten  Fensters  (<0:  Fehler) 
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WINDOPEN  (AES  101) 


Ein  vorher  mit  “wind_create()”  erzeugtes  Fenster  wird  auf  dem  Bildschirra  dargestellt. 
Titelzeile,  Infozeile  und  Slider  mussen  vorher  mit  “wind_set()”  gesetzt  werden! 

Deklaration  in  C: 

WORD  wind_open  (WORD  handle,  WORD  wx,  WORD  wy,  WORD  ww,  WORD  wh) 

! 

int_in(0]  =  handle; 
int_in[l]  =  wx; 
int_in[2]  =  wy; 
int_in[3]  =  ww; 

±nt_in[4]  =  wh; 
return  crys_if  (101); 

} 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

101  Opcode  fur  WINDJ3PEN 

contrl+2 

contrl[l] 

5  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  EintrSge  in  addr_in 

contr]+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

handle 

int_in+2 

int_in[l] 

wx 

int_in+4 

intjn  [2] 

wy 

int_in+6 

int_in[3] 

ww 

int_in+8 

int_in[4] 

wh 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

handle:  Kennung  (handle)  des  zu  offnenden  Fensters 

wx,  wy,  ww,  wh:  AnfangsmaBe  des  Fensters 

Bemerkungen 

Das  Offnen  des  Fensters  fiihrt  automatisch  dazu,  daB  der  Screen  Manager  eine  “Redraw”- 
Mitteilung  iiber  die  Flache  des  Aibeitsbereichs  verschickt. 
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WINDCLOSE  (AES  102) 


1st  das  Gegenstiick  zu  “wind_open()”  und  schlieSt  das  betreffende  Fenster.  Endgultig  geloscht 
wird  es  mit  “wind_delete()”. 

Deklaration  in  C: 

WORD  wind_close  (WORD  handle) 

{ 

int_in[0]  =  handle; 
return  crys_if  (102) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

102 

Opcode  fur  WIND_CLOSE 

contrl+2 

contrll  1  j 

1 

#  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int__out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

int_in 

int_in[0] 

handle 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehier) 

Parameter; 

handle:  Kennung  des  zu  schlieBendcn  Fensters 
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WEND_DELETE  (AES  103) 


Loscht  ein  Fenster  komplett  und  gibt  dabei  den  dafiir  intern  benotigten  Speicherplatz  und  die 
Kennung  (handle)  wieder  frei. 

Deklaration  in  C: 

WORD  wind_delete  (WORD  handle) 

{ 

int_in[0]  =  handle ; 
return  crys_if  (103); 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

103 

Opcode  fiir  WIND_DELETE 

contrl+2 

control] 

1 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addr_in 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

intjn 

int_in[0] 

handle 

int_out 

int_out[0] 

Retum-Wert  (0;  Fehler) 

Parameter; 

handle;  Kennung  des  zu  loschenden  Fensters 
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WINDGET  (AES  104) 


Liefert  je  nach  Funktionsnummer  verschiedene  Informationen  iiber  ein  Fenster. 

Deklaration  in  C: 

WORD  wind_get  (WORD  w_handle,  WORD  w_field,  WORD  *pwl,  WORD  *pw2, 
WORD  *pw3,  WORD  *pw4) 

{ 

int_jln[0]  =  w_handle; 
int_in[l]  =  w__field; 
crys_if  (104)  ; 

*pwl  =  int_out [ 1 ] ; 

*pw2  =  int_out[2]; 

*pw3  =  int_out[3]; 

*pw4  =  int_out [ 4 ] ; 
return  int_out [ 0 ] ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

1 04  Opcode  fur  WIND_GET 

contrl+2 

contrlfl] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

5  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

w_handle 

int_in+2 

int_in[l] 

w_field 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

int_out+2 

int_out[l] 

pwl 

int_out+4 

int_out[2] 

pw2 

int_out+6 

int_out[3] 

pw3 

int_out+8 

int_out[4] 

pw4 

Parameter: 

wjiandle:  Kennung  des  betreffenden  Fensters 

w_field:  Gewiinschte  Information.  Die  Inhalte  von  pwl...  pw4  hangen  ab  von: 
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WF_WORKXYWH  (4): 

WF_CURRXYWH  (5): 

WF_PREVXYWH  (6): 

WF_FULLXYWH  (7): 

WFJHSLIDE  (8): 
WF_VSLEDE  (9): 
WF_TOP  (10): 
WFJFIRSTXYWH(ll): 

WF_NEXTXYWH  (12): 


Berechnet  Koordinaten  des  Arbeitsbereichs  des  Fensters. 

pwl:  X-Position 

pw2:  Y-Position 

pw3:  Breite 

pw4:  Hohe 

Berechnet  Koordinaten  des  gesamten  Fensters  einschlieBlich 

Rander  etc. 

pwl :  X-Position 

pw2:  Y-Position 

pw3:  Breite 

pw4:  Hohe 

Berechnet  GesaratgroBe  des  vorherigen  Fensters. 

pwl:  X-Position 

pw2:  Y-Position 

pw3:  Breite 

pw4:  Hohe 

Berechnet  die  GesamtgroBe  des  Fensters  in  seiner  groBtmogli- 

chen  Ausdehnung. 

pwl:  X-Position 

pw2:  Y-Position 

pw3:  Breite 

pw4:  Hohe 

Liefert  Position  des  horizontalen  Schiebers. 
pwl:  (0:  ganz  links,  1000:  ganz  rechts) 

Liefert  Position  des  vertikalen  Schiebers. 
pwl:  (0:  ganz  oben,  1000:  ganz  unten) 

Liefert  Kennung  des  obersten  Fensters. 
pwl:  handle 

Liefert  Koordinaten  des  ersten  Rechtecks  in  der  Rechteckliste 

des  Fensters. 

pwl:  X-Position 

p\v2:  Y-Position 

pw3;  Breite 

pw4:  Hohe 

Liefert  die  Koordinaten  des  nachsten  Rechtecks  in  der  Recht¬ 
eckliste  des  Fensters. 
pwl:  X-Position 

pw2:  Y-Position 

pw3:  Breite 

pw4:  Hohe 
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WF_HSLSIZE  (15):  Die  GroBe  des  horizontalen  Schiebers  relativ  zum  Balken  wird 

berechnet. 

pwl:  -1:  MinimalgroBe 

1-1000:  klein-gesamte  Breite 

WF_VSLSIZE  (16):  Die  GroBe  des  vertikalen  Schiebers  relativ  zum  Balken  wird 

berechnet. 

pwl:  - 1 :  MinimalgroBe 

1-1000:  .  klein-gesamte  Hohe 

WF_SCREEN  (17):  Adresse  und  Lange  des  “Quarter  Screen  Buffers”  fur  Drop- 

Down-Meniis  und  Alarmboxen  wird  berechnet.  Bei  TOS  1.02 
wird  fur  die  Lange  0  zuriickgeliefert  (obwohl  der  Puffer  8000 
Bytes  faBt). 

pw  1 :  High-Word  der  Adresse 

pw2:  Low-Word  der  Adresse 

pw3:  High-Word  der  Lange 

pw4:  Low-Word  der  Lange 

Bemerkungen 

Einmal  mehr  hat  Digital  Research  hier  die  eingefiihrten  Bezeichnungen  geandert  (nunmehr 
“WF_WXYWH  (4)”,  “WF_CXYWH  (5)”,  “WF_PXYWH  (6)”  und  “WF_FYXWH  (7)”). 

Eine  Beispielfunktion  fur  “WF_SCREEN”: 

void  getQSB  (void  **where,  LONG  * length) 

{ 

WORD  wl,  w2r  w 3,  w4; 

/*  Hinweis:  bei  alteren  TC-Versionen  ist  das  Binding  fur 
windjget  (...,  WF_SCREEN,  ...)  nicht  korrekt  und  liefert 
falsche  Resultate!  */ 

wind__get  (0,  WF_SCREEN,  &wl,  &w2,  &w3,  &w4) ; 

*where  =  (void  *) ( (DWORD)  wl  *  65536L  +  (DWORD)  w2) ; 

* length  =  (DWORD)  w3  *  65536L  +  (DWORD)  w4; 

/*  Sonderfall:  TOS  1.02  */ 

if  ( (* length  ==  0L)  &&  (global[0]  ==  0x0120)) 

*length  =  8000L; 

) 
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Und  der  Aufruf  im  Programm: 

void  * where; 

LONG  length; 

getQSB  (& where,  & length) ; 

printf  ("Adresse:  %p,  Lange:  %ld  Bytes \n",  where,  length); 
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WINDSET  (AES  105) 


Je  nach  Funktionsnummer  werden  verschiedene  Fenstereigenschaften  verandert. 

Deklaration  in  C: 

WORD  wind_set  (WORD  w_handle,  WORD  w_field,  WORD  wl,  WORD  w2, 
WORD  w3,  WORD  w4) 

{ 

int__in[0]  =  w_handle; 
int_in[l]  =  w_field; 
int_in[2]  =  wl; 
int_in[3]  =  w2; 
int_in[4]  =  w3; 
int_in[5]  =  w4; 
return  crys_if  (105) ; 

} 

GEM-Arrays: 


Adresse  ' 

Feldelement 

Belegung 

contrl 

contrl  [0] 

105  Opcode  fiirWIND_SET 

contrl+2 

contrlfl] 

6  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int„in[0] 

handle 

int_in+2 

int_in[l] 

field 

int_in+4 

int_in[2] 

wl 

int_in+6 

int_in[3] 

w2 

int„in+8 

int_in[4] 

w3 

int_in+10 

int„in[5] 

w4 

Jr 

int_out 

int_out[0) 

Return- Wert  (0:  Fehler) 

Parameter: 

wjiandle:  Kennung  des  Fensters 

w_field:  Funktionsnummer.  wl...w4  werden  in  Abhiingigkeit  davon  interpretiert: 
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WF  NAME  (2): 
WFJNFO  (3): 
WF_CURRXYWH  (5): 


WF_HSLIDE  (8): 

WF_VSLIDE  (9): 

WF_TOP  (10): 
WFJNEWDESK  (14): 


WF_HSLSIZE  (15): 
WF_VSLSIZE  (16): 


Legt  neuen  Fenstemamen  fest. 

wl  und  w2:  Zeiger  auf  Zeichenkette  (GEM  benutzt  nur  den 
Zeiger,  legt  also  keine  Kopie  an). 

Legt  neue  Info-Zeile  fest. 

wl  und  w2:  Zeiger  auf  Zeichenkette  (GEM  benutzt  nur  den 
Zeiger,  legt  also  keine  Kopie  an). 

Setzt  FenstergroBe  fest. 
wl:  X-Position 
w2:  Y-Position 
w3:  Breite 
w4:  Hohe 

Setzt  neue  Position  fur  den  horizontalen  Schieber 
wl:  (0:  ganz  links,  1000:  ganz  rechts) 

Setzt  neue  Position  fur  den  vertikalen  Schieber 
wl:  (0:  ganz  oben,  1000:  ganz  unten) 

Fenster  wird  zum  aktuellen  (obersten)  Fenster 

Setzt  neuen  Default-Objektbaum;  funktioniert  nur  mit  Fenster  0 

(Hintergrundfenster).  Ein  Nullzeiger  erlaubt  es,  wieder  den 

Standardhintergrund  zu  setzen  (kann  nach  der  Ausfiihrung  von 

GEM-Programmen  aus  eigenen  Programmen  heraus  wichtig 

sein). 

w  1 :  Adresse  des  Objektbaums  (High) 

w2:  Adresse  des  Objektbaums  (Low) 

w3:  Objektnummer  des  ersten  darzustellenden  Objekts 

Setzt  relative  GroBe  des  horizontalen  Schiebers 

wl:  -1  (MinimalgroBe) 

1-1000  (klein-volle  Breite) 

Setzt  relative  GroBe  des  vertikalen  Schiebers 
wl:  -1  (MinimalgroBe) 

1-1000  (klein-volle  Hohe) 


in  PC-GEM  2.0  neu  hinzugekommen: 

WF_TATTRB  (18):  Setzt  den  “Fenster-Attributvektor”  (von  Digital  Research  nicht 

weiter  dokumentiert). 
w  1 :  0:  Fenster  ist  oberstes  Fenster 

1 :  Fenster  ist  nicht  oberstes  Fenster 

WF_SIZTOP  (19):  Macht  das  angegebene  Fenster  zum  aktiven,  ohne  die  Reihenfol- 

ge  der  darunterliegenden  zu  andern.  Gleichzeitig  konnen  neue 
Position  und  GroBe  angegeben  werden: 
wl:  X-Position 
w2:  Y-Position 
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w3:  Breite 
w4:  Hohe 

hingegen  in  Atari-GEM  ab  Version  3.0: 

WF_COLOR  (18):  Farben  der  verschiedenen  Fensterelemente  festlegen: 

wl:  Fensterelement: 

W_BOX  (0):  Fensterhintergrund  (G_IBOX) 

W_TITLE  (1):  Titelbox,  enthalt  Namen,  VoIle-GroBe-Box  und  SchlieB- 

box  (G_BOX) 

W_CLOSER  (2):  SchlieBbox  (G_BOXCHAR) 

W_NAME  (3):  Namenszeile  (G_BOXTEXT) 

WJFULLER  (4):  Volie-GroBe-Box  (G_BOXCHAR) 

W_INFO  (5):  Infozeile  (G_BOXTEXT) 

W  DATA  (6):  Objekt,  das  die  restlichen  Fensterelemente  enthalt 

(G_IBOX) 

W_WORK  (7):  Arbeitsbereieh  des  Fensters,  ffeie  Flache  (G_IBOX) 

W_SIZER  (8):  GroBenveranderungsbox  (GJBOXCHAR) 

W_VBAR  (9):  enthalt  die  Elemente  des  vertikalen  Balkens  (G_BOX) 

W_UP  ARROW  (10):  Auf-Pfeil  (G_BOXCHAR) 

W_DNARROW  (11):  Ab-Pfeil  (GJBOXCHAR) 

W_VSLIDE  (12):  Hintergrund  fur  den  vertikalen  Slider  (G_BOX) 

W_VELEV  (13):  Vertikaler  Slider  (G_BOX) 

WJHBAR  (14):  enthalt  die  Elemente  des  horizontalen  Balkens  (G_BOX) 

W_LFARROW  (15):  Links-Pfeil  (G_BOXCHAR) 

W_RTARROW  (16):  Rechts-Pfeil  (G_BOXCHAR) 

W_HSLIDE  (17):  Hintergrund  fur  den  horizontalen  Slider  (G_BOX) 

WJHELEV  (18):  Horizontaler  Slider  (G_BOX) 

w2:  Farbe  fur  aktive  Fenster  (Farbwert  wie  etwa  das  untere 
Wort  des  “ob_spec”  bei  einem  G_BOX-Objekt)  Oder  -1 
(nicht  setzen) 

w3 :  Farbe  fur  inaktive  Fenster  (Farbwert  wie  etwa  das  untere 
Wort  des  “objspec”  bei  einem  G_BOX-Objekt)  oder  -1 
(nicht  setzen) 

WF_DCOLOR  (19):  Wie  “WF_COLOR”,  nur  werden  die  Standardfarben  fur  neu 

angelegte  Fenster  gesetzt  (diese  Aufgabe  wird  normalerweise 
von  XCONTROL  ubemommen). 
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I  WIND JFTND  (AES  106) 


Ermittelt  die  Kennung  des  an  einer  bestimmten  Koordinate  befindlichen  Fensters. 


Deklaration  in  C: 

WORD  wind_find  (WORD  mx,  WORD  my) 
( 

int_in[0]  =  mx; 
int_in[l]  =  my; 
return  crys_if  (106) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

1  Belegung 

contrl 

contrl[0] 

106  Opcode  fur  WIND_FIND 

contrl+2 

control] 

2  #  Eintrage  in  intjn 

contrl+4 

contrl  [2] 

l  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

mx 

int_in+2 

int_in[l] 

my 

int_out 

int_out[0] 

Retum-Wert 

Parameter: 

mx,  my:  Bildschirmkoordinaten 

wind_find():  Kennung  des  gefundenen  Fensters  (-1:  kein  Fenster) 
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WIND  UPDATE  (AES  107) 


Diese  Funktion  dient  dazu,  Bildschirmzugriffe  verschiedener  AES-Prozesse  zu  synchronisie- 
ren. 

BEG JJPDATE/END  UPDATE 

Normalerweise  ist  jeder  AES -ProzeB  fiir  die  Inhalte  der  Arbeitsbereiche  der  von  ihm 
geoffneten  Fenster  zustandig  -  der  Rest  des  Bildschirms  wird  entweder  vom  Screen  Manager 
oder  anderen  AES-Prozessen  (zum  Beispiel  Accessories)  verwaltet. 

Die  Lage  andert  sich  beispielsweise,  wenn  man  eine  Dialogbox  zeichnen  will  (generell:  wenn 
man  unter  Umgehung  der  AES-Fensterfunktionen  auf  den  Bildschirm  zugreifen  will,  also 
auch  beispielsweise  beim  Wiederherstellen  eines  Bildschirmausschnitts).  In  einem  solchen 
Moment  diirfen  sich  die  von  den  Fenstem  belegten  Bildschirmflachen  (mithin  die  Recht- 
ecklisten)  nicht  verandem  -  fiir  wie  lange,  halt  von  der  entsprechenden  Operation  ab. 

Mit  “wind_update  (BEG_UPDATE)”  kann  also  ein  Programm  anmelden,  daB  es  direkt  auf 
dem  Bildschirm  ausgeben  mochte,  ohne  dabei  von  anderen  AES-Prozessen  gestort  zu  werden. 
Die  AES  gehen  dann  so  vor:  Falls  schon  ein  anderer  ProzeB  “wind_update  (BEG_UPDATE)” 
ausgefiihrt  hat,  wird  das  betreffende  Programm  so  lange  blockiert,  bis  der  Bildschirm  wieder 
frei  ist,  Anderenfalls  erhalt  man  die  Kontrolle  zuriick  und  darf  bis  zum  “wind_update 
(END_UPDATE)”  mit  dem  Bildschirm  alles  tun,  was  man  mochte  -  Hauptsache,  am  Ende 
sind  die  Inhalte  “fremder”  Fenster  wieder  hergestellt. 

“wind_update()”  dient  mithin  als  Semaphore,  die  dafiir  sorgt,  daB  nur  einer  gleichzeitig  auf 
dem  Bildschirm  malt.  Das  AES-ProzeBswitching  wird  dabei  nicht  unterbunden  -  es  werden 
nur  solche  Prozesse  blockiert,  die  selbst  auch  auf  dem  Bildschirm  ausgeben  wollen  (und  dies 
korrekt  anmelden).  Die  Rechtecklisten  der  Fenster  sind  damit  eingefroren  (so  daB  man  mit 
“wind_get()”  in  aller  Ruhe  die  Liste  der  sichtbaren  Rechtecke  abrufen  kann,  ohne  daB  jemand 
anders  dazwischenfunkt).  Bei  den  Fensterfunktionen  weiB  GEM  natiirlich  selbst  Bescheid, 
daB  sie  zur  Veranderung  der  Rechtecklisten  fiihren  konnen,  und  behandelt  sie  analog.  Wann 
muB  man  also  “wind_update  (BEG_UPDATE)”  benutzen?  Immer  dann,  wenn  man  irgend- 
eine  Anderung  des  Bildschirminhalts  herbeifuhrt,  ohne  dabei  die  AES-Fensterfunktionen  zu 
benutzen. 

BEG  MCTRL/END  MCTRL 

Die  Verteilung  der  Mausereignisse  und  Tastaturereignisse  wird  folgendermaBen  vorgenom- 
men:  Mausereignisse  gehen  an  den  ProzeB,  dem  das  betroffene  Fenster  gehort-  vorausgesetzt, 
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ihm  gehort  auch  das  oberste  Fenster.  Ansonsten  vverden  sie  vom  Screen  Manager  behandelt 
(zum  Beispiel:  Klick  mit  linker  Maustaste  auf  nicht  aktives  Fenster  fiihrt  zu  WMJTOPPED- 
Mitteilung).  Tastaturereignisse  werden  immer  an  den  ProzeB,  dem  das  aktive  Fenster  gehort, 
gemeldet.  Dabei  wild  gegebenenfalls  Hintergrundfenster  0  beachtet  (falls  kein  anderes  Fen¬ 
ster  geoffnet  ist). 

Mit  “wind_.update  (BEG_MCTRL)”  kann  man  die  Mauskontrolle  selbst  iibemehmen.  Diese 
Funktion  wird  immer  dann  benotigt,  wenn  Tastatur-  oder  Mauseingaben  unabhangig  von  den 
geoffneten  Fenstem  bearbeitet  werden  sollen.  Ein  Beispiel  dafiir  sind  alle  Funktion  der  GRAF- 
Bibliothek,  insbesondere  “graf_slidebox()”  und  aueh  die  Dateiauswahlbox  (die  intern 
“graf_slidebox()”  aufruft). 


Deklaration  in  C: 

WORD  wind_update  (WORD  beg_update) 

{ 

int_in[0]  =  beg_update; 
return  crys_if  (107) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

107 

Opcode  fur  WINDJJPDATE 

contrl+2 

contrl  [1] 

1 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addrjn 

contrl+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

int_in 

int_in[0] 

beg_update 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

beg_update:  Funktionsnummer: 

END_UPDATE  (0):  Bildschirmaufbau  abgeschlossen. 

BEG_UPDATE  (1):  Bildschirmaufbau  beginnt; 

Rechtecldisten  werden  eingefroren. 

ENDJMCTRL  (2):  Applikation  gibt  Mauskontrolle  wieder  ab. 
BEG_MCTRL  (3):  Applikation  iibemimmt  totale  Kontrolle  iiber  die  Maus 
-  insbesondere  die  Drop-Down-Meniis  sind  gesperrt. 
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WINDCALC  (AES  108) 


Berechnet  entweder  aus  der  GroBe  des  Arbeitsbereiches  eines  Fensters  die  GesamtmaBe  Oder 
umgekehrt. 


Deklaration  in  C: 

WORD  wind_calc  (WORD  wctype,  WORD  kind,  WORD  x,  WORD  y,  WORD  w, 
WORD  h,  WORD  *px,  WORD  *py,  WORD  *pw,  WORD  *ph) 

{ 

int_in[0]  =  wctype; 
int_in[l]  =  kind; 
int_in[2]  =  x; 
int_in[3]  =  y; 
int_in[4]  =  w; 
int__in[5]  «  h; 
crys__if  (108)  ; 

*px  t=  int_out  [1]  ; 

*py  ■»  int_out  1 2  ]  ; 

*pw  =  int_out[3]; 

*ph  =  int_out[4]; 
return  int_out[0]; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

108  Opcode  fur  WIND_CALC 

contrl+2 

contrl[I] 

6  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

5  #  Eintrage  in  int_out 

contrl+6 

contrI[3] 

0  #  Eintrage  in  addr  Jn 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

wctype 

int_in+2 

int_in[l] 

kind 

int_in+4 

int_in[2] 

X 

int.in+6 

int_in[3] 

y 

int_in+8 

int_in[4] 

w 

int_in+10 

int_in[5] 

h 
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Adresse 

Feldelement 

Belegung 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

int_out+2 

int_outfl] 

px 

int._out+4 

int_out[2] 

py 

int_out+6 

int_out[3] 

pw 

int_out+8 

int_out[4] 

ph 

Parameter: 


wctype: 

kind: 


x,  y,w,  h: 

px,  py, 

pw,  ph: 


WC_BORDER  (0): 

errechne  GesamtmaBe 

WC_WORK  (1): 

errechne  Arbeitsbereich 

Komponenten  des  Fensters: 

NAME  (0x0001): 

Titelbalken  mit  Name 

CLOSE  (0x0002): 

SchlieBbox 

FULL  (0x0004): 

Full-Box 

MOVE  (0x0008): 

Bewegungsbox  (Schattierung  im  Balken) 

INFO  (0x0010): 

Info-Zeile 

SIZE  (0x0020): 

GroBen-Verstellung 

UP  ARROW  (0x0040): 

Pfeil  nach  oben 

DNARROW  (0x0080): 

Pfeil  nach  unten 

VSLIDE  (0x0100): 

vertikaler  Schieber 

LFARROW  (0x0200): 

Pfeil  nach  links 

RTARROW  (0x0400): 

Pfeil  nach  rechts 

HSLIDE  (0x0800): 

horizontaler  Schieber 

Bekannte  Koordinaten 

Errechnete  Koordinaten 

Bemerkungen 

Man  sollte  niemals  davon  ausgehen,  daB  Fensterelemente  eine  bestimmte  GroBe  oder  Position 
haben,  sondem  statt  dessen  immer  “wind_calc()”  benutzen  -  dazu  ist  es  schlieBlich  da.  Ein 
Beispiel:  Es  ist  ohne  weiteres  denkbar,da8  ein  altemativerBildschirmmanageralleFensterrander 
breiter  als  “normal”  darstellt. 
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WINDJNEW  (AES  109)  -  erst  ab  GEM  1.4 


SchlieBt  und  loscht  alle  Fenster  (auch  die  der  Accessories !)  und  setzt  die  mit  “wind_updateO” 
gesetzten  Blockierungen  zuriick. 


Deklaration  in  C: 

void  windjnew  (void) 
{ 

crys_if  (109)  ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

109 

Opcode  fur  WIND_NEW 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

0 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addrjn 

contrI+8 

contrI[4] 

0 

#  Eintrage  in  addr_out 
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RSRC-Funktionen 


RSRC_LOAD  (AES  110) 


Dient  zum  Laden  und  Initialisieren  einer  Resource-Datei.  Dabei  geschieht  folgendes: 

1 .  Die  Datei  wird  mittels  “shel_find(>”  gesucht.  Gegebenenfalls  wird  ein  Fehler  gemeldet. 

2.  Aus  dem  Dateikopf  wird  die  Lange  der  Datei  ermittelt  (siehe  Beschreibung  des  RSC- 
Formats). 

3.  Genausoviel  Speicher  wird  mit  “MallocO”  alloziert.  Falls  nicht  geniigend  Speicher  da 
ist,  wird  ein  Fehler  gemeldet. 

4.  Anfangsadresse  und  Lange  in  Bytes  werden  im  global-Feld  festgehalten  (um  dann  fur 
“rsrc_free()”  bereitzustehen;  dies  ist  von  Atari  nicht  offiziell  dokumentiert). 

5.  Die  Datei  wird  geoffnet,  in  voller  Lange  an  die  entsprechende  Adresse  geladen  und 
wieder  geschlossen. 

6.  Nun  werden  noch  einige  Initialisierungen  vorgenommen  (Setzen  der  intemen  Zeiger, 
Anpassung  der  Koordinaten  wie  bei  “rsrc_obfix()”,  Setzen  derTabelleder  Objektbaum- 
zeiger,  Setzen  von  global[5,6J). 

Was  an  dieser  Stelle  nicht  passiert:  die  Um  wandlung  von  Bitimages  und  Icons  vom  Standard- 

format  in  das  gerateabhangige  Format! 


Deklaration  in  C: 

WORD  rsrc_load  (const  CHAR  *rsname) 

{ 

addr_in[0]  =  rsnarae; 
return  crys_if  (110) ; 

> 


GEM- Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

1 10  Opcode  fur  RSRCJLOAD 

contrl+2 

contrl[l] 

0  #  Eintrage  in  int Jn 
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Adresse 

Feldelement 

Beiegung 

contrl+4 

contrl[2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1 

#  Eintrage  in  addr_in 

contrl+8 

contrI[4] 

0 

#  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

rsname 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

rsname:  Dateiname  der  Resource-Datei  (Datei  wird  iiber  den  Standardzugriffspfad  des 

AES  gesucht) 

Bemerkungen 

Ein  Fehler  kann  verschiedene  Ursachen  haben:  Speichermangel  Oder  Resource-Datei  nicht 
gefunden. 


AES-Betriebssystemroutinen 


697 


RSRC_FREE  (AES  111) 


Gibt  den  durch  “rsrc_load()”  reservierten  Speicherbereich  wieder  frei  (sollte  man  am  Ende 
eines  Programmes  auf  gar  keinen  Fall  vergessen). 


Deklaration  in  C: 

WORD  rsrc_free  (void) 

{ 

return  crys_if  (111); 

1 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

111 

Opcode  fur  RSRC_FREE 

contrl+2 

contrlf  1] 

0 

#  Eintrage  in  int Jn 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

0 

#  Eintrage  in  addr  Jn 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 
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RSRC  GADDR  (AES  112) 


Ermittelt  die  Anfangsadresse  einer  Resource-Struktur  im  Speicher  (nach  “rsrcJoadO”)- 


Deklaration  in  C: 

WORD  rsrc_gaddr  (WORD  rstype,  WORD  raid,  void  *paddr) 
{ 

int_in[0]  =  rstype; 
int_in[l]  =  rsid; 
control [4]  =  1; 
crys_if  (112); 
control [4]  =  0; 

*paddr  =  addr__out  [0]  ; 
return  int_out  f  0 ] ; 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

112  Opcode  fiir  RSRC_GADDR 

contrl+2 

contrljl] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

1  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

rstype 

int_in+2 

int_in[l] 

rsid 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 

addr_out 

addr_out[0] 

paddr 

Parameter; 

rsid;  Index  (i)  der  gesuchten  Struktur 
rstype;  Typ  der  gesuchten  Struktur: 

R_TREE  (0):  Zeiger  auf  Objektbaum  i 

R_OBJECT  (1):  Zeiger  auf  Objektstruktur  i 
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R_TEDINFO  (2): 

Zeiger  auf  Textobjekt  i 

RJCONBLK  (3): 

Zeiger  auf  Icon  i 

R_BITBLK  (4): 

Zeiger  auf  Bit-Block  i 

R_STRING  (5): 

Zeiger  auf  String  i 

R_IMAGEDATA  (6): 

Zeiger  auf  Bilddaten  Nr.  i 

R.OBSPEC  (7): 

Zeiger  auf  TEDINFO-Struktur 

R_TEPTEXT  (8): 

Zeiger  auf  Text 

RJTEPTMPLT  (9): 

Zeiger  auf  Textmaske 

R_TEP  VALID  (10): 

Zeiger  auf  Textschablone 

RJBPMASK(ll): 

Zeiger  auf  Icon-Maske 

RJBPDATA  (12): 

Zeiger  auf  Icon-Daten 

R_IBPTEXT  (13): 

Zeiger  auf  Icon-Text 

R_BIPDATA  (14): 

Zeiger  auf  Bitmuster-Daten 

R_FRSTR  (15): 

Adresse  eines  Zeigers  auf  freien  String 

RJFRIMG  (16): 

Adresse  eines  Zeigers  auf  freies  Image 

paddr:  Anfangsadresse  der  gesuchten  Struktur 


Bemerkungen 

Wenn  der  Textzeiger  innerhalb  einer  TEDINFO-Strnktur  gesucht  wird,  mu(3  selbstverstand- 
lich  nicht  die  Nummer  des  zugehorigen  Objekts,  sondem  die  Nummer  der  TEDINFO-Struktur 
angegeben  werden.  Ahnliches  gilt  fiir  die  meisten  anderen  Codes. 
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RSRCjSADDR  (AES  113) 


Speichert  die  Anfangsadresse  einer  Datenstruktur  im  Speicher. 


Deklaration  in  C: 

WORD  rsrc_saddr  (WORD  rstype,  WORD  rsid,  void  *lngval) 
{ 

int_in[0]  =  rstype; 
int_in[l]  =  rsid; 
addr_in[0]  =  lngval; 
return  crys_if  (113) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

113  Opcode  fur  RSRC_SADDR 

contrl+2 

contrl[l] 

2  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

l  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

rstype 

int_in+2 

int_in[l] 

rsid 

addr_in 

addr_in[0] 

lngval 

intout 

int_out[0] 

Return- Wert  (0:  Fehler) 

Parameter: 

rstype:  Typ  der  Datenstruktur: 

R_FRSTR  (15):  Adresse  eines  Zeigers  auf  freien  String 
R__FRIMG  (16):  Adresse  eines  Zeigers  auf  freies  Image 
rsid:  Position  (i)  in  der  Datenstruktur,  in  die  lngval  geschrieben  wird 

lngval:  die  abzuspeichemde  Adresse 
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RSRC_OBFIX  (AES  114) 


Wandelt  in  einem  Objekt  die  Koordinatendarstellung  von  Zeiehen-  in  Pixeldarstellung.  Dies 
ist  immer  dann  vonnoten,  wenn  man  Objekte  nicht  mit  “rsrc  Joad()”  ladt,  sondem  direkt  in 
das  Programm  eingliedert  oder  zur  Laufzeit  erzeugt. 

Dabei  wird  jeweils  das  untere  Byte  der  Koordinatenangabe  mit  der  GroBe  des  Sy  stemzeichen- 
satzes  multipliziert  und  darauf  das  (vorzeichenbehaftete)  obere  Byte  addiert.  Ausnahme :  Fiir 
eine  Breite  von  genau  80  Zeiehen  wird  die  Breite  des  Bildschirms  eingesetzt  (was  das 
Resource  Construction  Set  beim  Hintergrundobjekt  des  Meniibaums  nutzt). 

Deklaration  in  C: 

WORD  rsrc_obfix  (OBJECT  *tree,  WORD  obj) 

{ 

addr_i n [ 0 ]  =  t  ree ; 
int_in(0]  =  obj; 
return  crys_if  (114) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrlfO] 

114  Opcode  fur  RSRQOBFIX 

contrl+2 

contrl[l] 

1  1  #  Eintrage  in  intjn 

contrl+4 

contrlf2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr  Jn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

intjn 

int_in[0] 

obj 

addr_in 

addr_in[0] 

tree 

int_out 

int_out[0] 

Retum-Wert  (reserviert,  immer  1) 

Parameter: 

obj:  Objektnummer  des  zu  konvertierenden  Objekts 
tree:  Anfangsadresse  des  Objektbaums 
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SHEL-Funktionen 


SHEL_READ  (AES  120) 


Liefert  Namen  und  Kommandozeile,  mit  der  die  Application  aufgerufen  wurde.  Dies  klappt 
allerdings  nur,  wenn  der  Programmstart  mit  “shel„write()”  vorgenommen  wurde.  Also  im 
Zweifelsfall  besser  die  Werte  aus  der  Basepage  verwenden. 

Deklaration  in  C: 

WORD  shel_read  (CHAR  *pcmd,  CHAR  *ptail) 

{ 

addr_in[0]  =  pcmd; 
addr_in [ 1 ]  =  ptail; 
return  crys__if  (120) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

120  Opcode  fur  SHEL_READ 

contrl+2 

contrI[l] 

0  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

2  #  Eintrage  in  addr_in 

contrl+8 

.  contrl  [4] 

0  #  Eintrage  in  addr_out 

addrjn 

addr_in[0] 

pcmd 

addrJn+4 

addr_in[l] 

ptail 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

pcmd:  Programmname  mit  Pfad  (wie  beim  Aufruf  mit  “PexecQ”) 
ptail:  Kommandozeile  (wie  bei  “Pexec(>”  -  also  nullterminiert  und  mit  Langenangabe  im 
ersten  Byte) 

Bemerkungen 

Beide  Puffer  sollten  mindestens  128  Bytes  lang  sein! 
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SHELWRITE  (AES  121) 


Informiert  die  AES,  daB  eine  andere  Applikation  gestartet  werden  soil. 

Im  Gegensatz  zum  GEMDOS-Befehl  “Pexec()”  bleibt  dabei  das  laufende  Programm  nicht 
resident. 

Ein  Beispiel  fur  die  Verwendung  dieser  Funktion  ist  das  Starten  von  “OUTPUT. APP”  durch 
das  Prasentationsgrafikprogramm  “SciGraph”. 

Deklaration  in  C: 

WORD  shel_write  (WORD  doex,  WORD  isgr,  WORD  isover, 

CHAR  *pcmd,  CHAR  *ptail) 

{ 

int_in[0]  =  doex; 
int_in[l]  =  isgr; 
int_in[2]  =  isover; 
addr_in[0]  =  pcmd; 
addr_in[l]  =  ptail; 
return  crys_if  (121) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

121  Opcode  fur  SHEL_WRITE 

contrI+2 

contrl[l] 

3  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

2  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

doex 

int_in+2 

int„in[l] 

isgr 

int_in+4 

intjn[2] 

isover 

addr_in 

addr_in[0] 

pcmd 

addr_in+4 

addr_in[l] 

ptail 

int_out 

int_out[0] 

Return- Wert  (0:  Fehler) 
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Parameter: 


doex: 


isgr: 


isover: 


pcmd: 

ptail: 


0:  keine  weitere  Applikation  starten.  Vor  GEM  1.4  wurden  dabei  die  AES 
komplett  neu  inilialisiert  (inkl.  Laden  der  Accessories).  Ab  GEM  1 .4  wird  nor¬ 
mal  zum  Desktop  zuriickgekehrt. 

1 :  neues  Programm  laden 

0:  keine  Grafik-Applikation  (Cursor  wird  ein-,  Maus  wird  ausgeschaltet;  Bild- 
schirm  wird  geloscht) 

1 :  Grafik-Applikation 

in  Atari-GEM  unbenutzt  (sollte  auf  0  gesetzt  werden).  Unter  PC-GEM  laBt  sich 
damit  einstellen,  ob  das  Programm  als  Overlay  (0)  oder  erst  nach  Verlassen  des 
aktuellen  Programms  (1)  gestartet  werden  soil;  Modus  2  erlaubt  das  Nachstarten 
unter  Entfemung  von  GEM  aus  dem  Speicher. 

Adresse  eines  Strings  mit  dem  Namen  des  zu  startenden  Programms 
Adresse  eines  Strings  mit  der  Kommandozeile 

( Vorsicht:  genau  wie  bei  “Pexec()”  gibt  das  erste  Byte  die  Lange  der folgenden  Zei- 
chenkette  an.) 


Bemerkungen 

Beim  Start  von  Programmen  mittels  “shel_write()”  wird  auch  -  je  nach  Applikationstyp  -  der 
entsprechende  Critical-Error-Handler  (siehe  “etv_critic”)  initialisiert.  Wird  eine  TOS- 
Applikation  von  einem  GEM-Programm  mittels  “PexecO”  gestartet,  braucht  man  sich  also 
nicht  dariiber  zu  wundem,  dafi  zwar  Alertboxen  erscheinen,  aber  keine  Maus  auftaucht. 
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SHELGET  (AES  122) 


Dient  zum  Lesen  von  Zeichen  aus  dem  GEM-intemen  Environment-Speicher.  Das  Desktop 
benutzt  diesen  Speichcr  zur  Aufbewahrung  der  DESKTOP.INF-bzw.  NE  WDESK.INF-Datei 
(terminiert  durch  ASCII  26  (CTRL-Z)  oder  durch  Null).  Das  Format  dieser  Datei  istallerdings 
nicht  offiziell  dokumentiert  und  kann  sich  andem. 

Deklaration  in  C: 

WORD  shel__get  (CHAR  *addr,  WORD  len) 

{ 

addr_i n  [  0  ]  =  addr  ; 
int_in[0]  =  len;  ■ 
return  crys_if  (122) ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl  [0] 

122  Opcode  fur  SHEL.GET 

contrl+2 

contrl[l] 

1  #  Eintrage  in  intjn 

contrl+4 

contrl[2] 

I  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr_in 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

intjn[0] 

len 

addr_in 

addr_in[0] 

addr 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

len:  Anzahl  der  zu  lesenden  Bytes 
addr:  Anfangsadresse  des  Zielspeicbers 
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’  SHEL_PUT  (AES  123) 


Schreibt  eine  gegebene  Anzahl  von  Zeichen  in  die  GEM-intemen  Environment-Speicher.  In 
alteren  TOS-Versionen  ist  die  Lange  dieses  Puffers  auf  1024  Bytes  beschrankt,  ab  GEM  1 .4 
sollen  4096  Bytes  hineinpassen.  Da  das  Format  dieses  Puffers  sowieso  nicht  offiziell 
dokumentiert  ist,  sollte  man  sich  nicht  den  Kopf  dariiber  zerbrechen... 

Deklaration  in  C: 

WORD  shel__put  (char  *addr,  WORD  len) 

{ 

addr_in[0]  =  addr; 
int_in[0]  =  len; 
return  crys_if  (123) ) ; 

1 

GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

123  Opcode  fxirSHEL_PUT 

contrl+2 

contrl[l] 

1  #  Eintragc  in  int Jn 

contrl+4 

contrif2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl[3] 

1  #  Eintrage  in  addr_in 

contrl+8 

contrl  [4] 

0  #  Eintrage  in  addr.out 

int_in 

int_in[0] 

len 

addr.  .in 

addr_in[0] 

addr 

int_out 

int_out[0] 

Retum-Wert  (0:  Fehler) 

Parameter: 

len:  Anzahl  der  zu  schreibenden  Zeichen 
addr:  Anfangsadresse  des  Puffers  mit  den  Zeichen 
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SHEL  JFTND  (AES  124) 


Sucht  eine  Datei  im  aktuellen  Verzeichnis  und  im  Wurzelverzeichnis.  Zusatzlich  werden  alle 
Verzeichnisse  durchsucht,  die  in  der  AES-Environment-Variablen  “PATH=”  angegeben  sind, 
Im  Normalfall  handelt  es  sich  dabei  am  das  Wurzelverzeichnis  des  Bootlaufwerks  und  das 
aktuelle  Verzeichnis. 

Ab  GEM  1 .4  wird  auch  der  Pfad  untersucht,  in  dem  sich  das  gerade  laufende  Programm 
befindet  (und  der  vor  dem  Programmnamen  stehen  sollte,  den  man  mit  “shel_read()”  erfragen 
kann).  Diese  Funktion  wird  tibrigens  auch  von  der  AES-Funktion  “rsrc_load()”  verwendet,  um 
die  Resource-Datei  zu  finden. 

Deklaration  in  C: 

WORD  shel_find  (char  *ppath) 

{ 

addr_in[0]  =  ppath; 
return  crys_if  (124); 

} 

GEM-Arrays: 


Adresse 

1  Feldelement 

Belegung 

contrl 

contrl  [0] 

124 

Opcode  fiir  SF1EL_FIND 

contrl+2 

contrl[l] 

0 

#  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1 

#  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

1 

#  Eintrage  in  addr_in 

contrl+8 

contrl[4] 

0 

#  Eintrage  in  addr_out 

addrin 

addr_in[0] 

ppath 

int_out 

int_out[0]  ' 

Retum-Wert  (0:  Fehler) 

Parameter: 

ppath:  Adresse  eines  Strings  mit  dem  Namen  der  gesuchten  Datei.  Nach  Aufruf  enthalt  er  eine 
Dateispezifikation,  wie  sie  von  dem  aktuellen  Verzeichnis  aus  benutzt  werden  kann. 
Diese  Dateispezifikation  kann  natiirlich  auch  einen  vollstandigen  absoluten  Pfad 
enthalten,  daher  sollte  eine  geniigende  Lange  (mindestens  128  Zeichen!)  gewahlt  wer¬ 
den. 
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SHELENVRN  (AES  125) 


Was  sind  eigentlich  die  AES-Environment-Variablen,  und  wofiir  kann  man  sie  einsetzen? 

Die  Antwort  ist  wie  so  oft  ganz  einfach:  Es  sind  tatsachlich  nur  die  Environment- Variablen 
des  Programms,  das  die  AES  beim  Booten  des  Rechners  aufgerufen  hat. 

Genau  wie  bei  den  Environment-Variablen  eines  “normalen”  GEMDOS-Programms  handelt 
es  sich  um  eine  Liste  von  ASCII-Strings,  in  denen  die  verschiedenen  Variablennamen  und 
deren  Werte  festgehalten  sind. 

Wie  so  oft  bei  Environment-Strings  ist  die  sogenannte  “PATH”- Variable  die  wichtigste.  Sie 
gibt  einfach  eine  Liste  von  Verzeichnissen  an,  in  denen  nach  bestimmten  Dateien  gesucht 
werden  soil.  Als  Trennzeichen  dienen  Kommata  (ab  AES-Version  1.4)  und  Strichpunkte 
(schon  immer).  Auch  leere  Eintrage  sind  erlaubt  und  stehen  fiir  das  aktuelle  Verzeichnis 
(“;C:\”  steht  also  fiir  das  Wurzelverzeichnis  von  C:  und  das  aktuelle  Verzeichnis). 

Nun  kann  man  natiirlich  aufier  der  Pfadvariablen  noch  firei  nach  Gutdiinken  weitere  Variablen 
setzen.  Diese  Variablen  kann  man  dann  nicht  nur  mit  der  AES-Funktion  “shel_envmO” 
abfragen,  sondem  sie  werden  auch  vom  Desktop  an  alle  gestarteten  Programme  als  normale 
GEMDOS-Environment-Variablen  weitergereicht. 

Naheliegend  ist  es  beispielsweise,  den  Standardsuchpfad  um  einen  Ordner  zu  erweitem,  in 
dem  man  alle  Resource-Dateien  sammelt.  Damit  werden  die  Verzeichnisse  auf  der  Festplatte 
deutlich  iibersichtlicher.  Nachteil:  Leider  vergiflt  man  zu  oft  beim  Weitergeben  von  Program- 
men  den  Resource-Pile. 

Jetzt  ein  Beispiel  fiir  das  Hinzufiigen  neuer  Environment-Variablen;  Turbo-C  beispielsweise 
sucht  beim  Offnen  seiner  Help-Datei  nach  der  Environment-Variablen  “TC”.  Falls  vorhan- 
den,  wird  die  Help-Datei  im  darin  angegebenen  Ordner  gesucht.  Damit  ist  es  nicht  notwendig, 
die  Help-Datei  im  gleichen  Ordner  wie  Turbo-C  zu  installieren. 

Das  BIOS  installiert  normalerweise  als  Standardpfad  einfach  das  Wurzelverzeichnis  des 
Bootlaufwerks.  Dazu  verwendet  es  die  Sy  stemvariable  “_bootdev”  und  begeht  dabei  ungliick- 
licherweise  einen  seit  langem  bekannten  Fehler;  es  betrachtetdie  Systemvariable  als  Byte  statt 
als  Wort  und  greift  damit  auf  die  falsche  Speicherzelle  zu. 

Resultat:  Als  Standardpfad  wird  “A:\”  eingetragen  -  ungeachtet,  von  welchem  Laufwerk  man 
gebootet  hat.  Die  meisten  Harddisktreiber  von  Fremdherstellem  umschiffen  dieses  Problem 
auf  die  eine  Oder  andere  Weise. 
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Und  dann  ist  da  noch  ein  anderes  Problem:  Leider  setzt  das  BIOS  das  Environment  auf  eine 
andere  Art  und  Weise  als  der  ganze  Rest  der  Computerwelt.  Normalerweise  handelt  es  sich 
bei  den  Environmentstrings  um  nullterminierte  Zeichenketten  der  Form  “VARIABLE=WERT”. 
Das EndewirddemzufolgedurcheinedoppelteNullangegeben.  Anders beimBIOS,  das  leider 
hinter  der  Zeichenkette  “PATH=”  eine  Null  einfiigt. 

Von  Atari  dokumentierte  Abhilfe:  Wenn  der  fur  “PATH=”  zuriickgelieferte  Zeiger  auf  ein 
Nullbyte  zeigt,  sollte  man  ihn  um  eins  erhohen,  um  an  das  richtige  Ergebnis  zu  kommen. 


Deklaration  in  C: 

WORD  shel_envrn  (char  *ppath,  char  *psrch) 
{ 

addr_in[0]  =  ppath; 
addr_in[l]  =  psrch; 
return  crys_if  (125) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

125  Opcode  fiirSHEL_ENVRN 

contrl+2 

contrl[l] 

0  #  Eintrage  in  int_in 

contrl+4 

contrl  [2] 

1  #  Eintrage  in  int_out 

contrl+6 

contrl  [3] 

2  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

ppath 

addr_in+4 

addr_in[l] 

psrch 

int_out 

int_out[0] 

reserviert  (immer  1) 

Bemerkungen 

Um  das  AES-Environment  zu  andem,  hangt  man  sich  am  besten  in  den  Systemvektor 
“exec_os”,  iiber  den  GEM  gestartet  wird.  In  der  aufgerufenen  Routine  liegt  -  wie  bei  einem 
Programm  -  der  Basepage-Zeiger  auf  dem  Stack.  In  die  dort  angegebene  Basepage  setzt  man 
dann  einfach  den  Zeiger  auf  das  neue  Environment  ein  (vor  GEM  1 .4  wurden  freilich  nur  die 
ersten  50  Bytes  ubemommen!). 
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SHELRDEF  (AES  126)  nur  in  PC-GEM  ab  Version  2.0 


Hiermit  kann  man  abfragen,  welches  Programm  nach  Beendigung  des  aktuellen  gestartet  wird 
(sollte  im  allgemeinen  das  Desktop  sein). 

Deklaration  in  C: 

WORD  shel_rdef  (CHAR  *lpcmd,  CHAR  *lpdir) 

{ 

addr_in[0]  =  lpcmd; 
addr_in[l]  =  lpdir; 
return  crys__if  (126); 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

eontrl 

contrl[0] 

126  Opcode  fUr  SHELJRDEF 

contrl+2 

contrl[l] 

0  #  Eintrage  in  int_in 

contrl+4 

contrl[2] 

1  #  Eintrage  in  int_out 

contrl+6 

eontrl  [3] 

2  #  Eintrage  in  addrjn 

contrl+8 

contrl[4] 

0  #  Eintrage  in  addr_out 

addr_in 

addr_in[0] 

lpcmd 

addr_in+4 

addr_in[l] 

lpdir 

int_out 

int_out[0] 

Retum-Wert  (undefiniert) 
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|  SHEL_WDEF  (AES  127)  -  nur  in  PC-GEM  ab  Version  2.0 


Analog  zu  “shel_rdef()”  kann  man  mit  dieser  Funktion  die  “Default-Applikation”  festlegen. 


Deklaration  in  C: 

WORD  shel_wdef  (CHAR  *lpcmd,  CHAR  * lpdir) 
{ 

addrjn  [0]  =  lpcmd; 
addr_in[l]  =  lpdir; 


return  crys_if  (127); 

} 


GEM- Arrays: 


Adresse 

Feldelement 

contrl 

contrl  [0] 

contrl+2 

contrlfl] 

contrl+4 

contrl  [2] 

contrl+6 

contrl[3] 

contrl+8 

contrlf4] 

addr.in 

addrjn  [0] 

addr_in+4 

addrjn[l] 

int_out 

int_out[l] 

Belegung 


127  Opcode  fur  SHEL_WDEF 
0  #  Eintrage  in  int_in 

0  #  Eintrage  in  int_out 

2  #  Eintrage  in  addrjn 

0  #  Eintrage  in  addr_out 

lpcmd 

lpdir 

Retum-Wert  (undefiniert) 
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XGRF-Funktionen 


XGRF_STEPCALC  (AES  130)  -nur  in  PG-GEM  ab  Version  2.0 


Mit  dieser  Funktion  kann  man  sich  alle  Parameter  fiir  einen  “xgrf_2box()”-Auffuf  berechnen 
lassen. 

Aus  AnfangsgroBe,  EndgroBe  und  Endposition  des  Rechtecks  werden  Endposition,  Anzahl 
der  Schritte  und  GroBe  der  Schritte  bestimmt. 


Deklaration  in  C: 

WORD  xgrf_stepcalc  (WORD  orgw,  WORD  orgh,  WORD  xc,  WORD  yc,  WORD  w, 
WORD  h,  WORD  *pcx,  WORD  *pcy,  WORD  *pcnt, 

WORD  *pxstep,  WORD  *pystep) 

{ 

int_in[0]  =  orgw; 
int_in[l]  =  orgh; 
int  in [2]  =  xc; 
int_in[3]  =  yc; 
int_in[4]  =  w; 
int_in(5]  =  y; 
crys_if  (130) ; 

*pcx  =  int_out[l]; 

*pcy  =  int_out[2]; 

*pcnt  =  int_out[3]; 

*pxstep  ==  int_out[4]; 

*pystep  =  int__out[5]; 
return  int_out [0] ; 

) 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

130 

Opcode  fiir  XGRF_STEPCALC 

contrl+2 

contrl[l] 

6 

#  Eintrage  in  int_in 

contrl+4 

contrl[2] 

6 

#  Eintrage  in  int_out 

contrl+6 

contrl[3] 

0 

#  Eintrage  in  addr_in 

contrI+8 

contrl  [4] 

0 

#  Eintrage  in  addr_out 

AES-Betriebssystemroutinen 
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Adresse 

Feldelement 

Belegung 

intjn 

int_in[0] 

orgw 

int_in+2 

int_in[l] 

orgh 

int_in+4 

intjnf2] 

xc 

int.Jn+6 

int_in[3] 

yc 

intJn+8 

int_in[4] 

w 

int_in+10 

int_in[5] 

h 

int_out 

int„out[0] 

Retum-Wert  (0:  Fehler) 

int_out+2 

int_out[l] 

pcx 

int_out+4 

int_out[2] 

pcy 

int„out+6 

int_out[3] 

pent 

int_out+8 

int_out[4] 

pxstep 

int_out+10 

int_out[5] 

pystep 

Parameter: 


orgw: 
orgh: 
xc,  yc: 
w,  h: 
pcx,  pcy: 
pent: 
pxstep, 
pystep: 


anfangliche  Breite 
anfangliche  Hohe 
Endposition 
Endgrofie 

zentrierte  Position  nach  Ablauf  des  Vorgangs 
Anzahl  der  Einzelschritte 

Schrittweite  in  X-  und  Y-Richtung  pro  Einzelschritt 
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XGRF2BOX  (AES  131)  -  nur  in  PC-GEM  ab  Version  2.0 


Zeichnet  eine  Reihe  von  Rechtecken,  die  sich  iiber  den  Bildschirm  bewegen  (dies  ist  ein  Ersatz 
fur  die  in  PC-GEM  2.0  gestrichenen  Funktionen  der  FORM-  und  GRAF-Bibliotheken). 


Deklaration  in  C: 

WORD  xgrf_2box  (WORD  xc,  WORD  yc,  WORD  w,  WORD  h,  WORD  cornes, 
WORD  cnt,  WORD  xstep,  WORD  ystep,  WORD  doubled) 

{ 

int_in[0]  =  cnt; 
int_in[l]  =  xstep; 
int_in[2]  =  ystep; 
int_in [ 3 ]  =  doubled; 
int_in[4]  =  corners; 
int_in[5]  =  xc; 
int_in[6]  =  yc; 
int_in[7]  =  w; 
int_in[8]  =  h; 
return  crys_if  (131) ; 

} 


GEM-Arrays: 


Adresse 

Feldelement 

Belegung 

contrl 

contrl[0] 

1 3 1  Opcode  fiir  XGRF_2BOX 

contrl+2 

contrl[l] 

9  #  Eintragc  in  intjn 

contri+4 

contrl[2] 

1  #  Eintrage  in  int  .. out 

contrl+6 

contrl[3] 

0  #  Eintrage  in  addrjn 

contrl-t-8 

contrl  [4] 

0  #  Eintrage  in  addr_out 

int_in 

int_in[0] 

cnt 

int_in+2 

int„in[l] 

xstep 

int_in+4 

int . in  [2] 

ystep 

int_in+6 

int_in[3] 

doubled 

int_in+8 

int_in[4] 

comers 

int_in+10 

int_in[5] 

xc 

int_in+12 

int_in[6] 

yc 

int_in+I4 

intjn[7] 

w 
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Adresse 

Feldelement 

Belegung 

int_in+16 

int_in[8] 

h 

int_out 

int_out[0] 

Return-Wert 

Parameter: 


cnt: 

xstep,  ystep: 
doubled: 

comers: 

xc,  yc: 
w,  h: 


Anzahl  der  Einzelschritte 
Schrittweite  in  X-  und  Y-Richtung 
0:  normale  Schrittweite 
1 :  Schrittweite  verdoppeln 
0:  ganze  Rechtecke  zeichnen 
1 :  nur  die  Ecken  zeichnen 
Anfangsposition 
AnfangsgroGe 


717 


Kapitel  5:  XCONTROL 


Einleitung 

XControl  ist  das  Kontrollfeld,  das  dem  Atari  TT  und  dem  Mega  STE  seit  Ende  1 990  beigelegt 
wird.  Es  ist  modular  aufgebaut  und  kann  erweitert  werden.  Die  Module  sind  Dateien,  deren 
Namenserweiterung  “CPX”  (Control  Panel  extension)  heiBt.  XControl  ist  also  nichts  anderes 
als  ein  Steuerungsprogramm  fiir  solche  Module,  die  im  wesentlichen  Konfigurationsdialoge 
sein  sollten.  Fur  andere  Zwecke  sollte  man  XControl  nicht  miflbrauchen. 

Die  Kommunikation  zwischen  XControl  und  den  einzelnen  Modulen  erfolgt  iiber  zwei 
Strukturen.  In  der  einen  (XCPB)  macht  XControl  einige  Flags  und  eine  ganze  Reihe  von 
Hilfsfunktionen  zuganglich.  Jede  CPX  wiederum  liefert  eine  CPXINFO-Struktur  mit 
Funktionszeigem  zuriick. 

XControl  ladt  beim  Start  alle  verfiigbaren  CPX-Header.  Wahrend  des  Bootvorgangs  werden 
alle  CPX-Dateien  einmal  zum  Initialisieren  aufgerufen,  sofem  im  Header  ein  entsprechendes 
Flag  gesetzt  ist.  Bei  jeder  Aktivierung  wird  die  Initialisierungsroutine  des  CPX-Moduls 
aufgerufen,  wobei  dann  ein  Zeiger  auf  eine  CPXINFO-Struktur  zuriickzuliefem  ist. 

Fiir  jedes  einzelne  Modul  kann  spezifiziert  werden,  ob  es  resident  geladen  werden  soil  (diese 
Eigenschaft  kann  man  auch  mittels  der  mitgelieferten  Konfigurations-CPX  andem).  Solche 
Module  werden  gleich  beim  Laden  vollstandig  geladen  und  bleiben  dann  resident  -  wohl  ein 
Zugestandnis  fiir  die  Benutzer,  bei  denen  die  XControl-Module  auf  einer  Diskette  oder  einer 
langsamen  Festplatte  liegen.  Ebenso  ist  es  moglich,  CPX-Module  zu  schreiben,  die  nur  be- 
stimmte  Werte  setzen  (“set-only”).  Derartige  CPX-Module  geben  bei  der  Initialisierung  ein- 
fach  einen  Nullzeiger  zuriick.  Sie  werden  nur  beim  Booten  bzw.  beim  emeuten  Laden  der 
Module  durch  XControl  aufgerufen. 

XControl  verwendet  “evnt_multi()”  fiir  die  eigene  Verwaltung  und  die  der  CPX-Module. 
Wird  ein  CPX-Modul  vom  Anwender  ausgewahlt,  so  ladt  XControl  dieses  in  den  Speicher  und 
ruft  “cpxJnitQ”  auf.  AnschlieBend  wird  die  Funktion  “cpx_call()”  aufgerufen,  wobei  im  we¬ 
sentlichen  nun  das  CPX-Modul  die  Steuerung  iibemimmt.  Es  existieren  zwei  Arten  von  CPX- 
Modulen:  Form-CPX  und  Event-CPX. 

Form-CPX  sind  relativ  einfach  zu  programmieren,  bieten  jedoch  nur  eine  eingeschrankte 
Flexibilitat.  Event-CPX  bieten  mehr  Flexibilitat,  da  sie  die  AES-Events  direkt  verwerten.  Alle 
mit  XControl  1.0  ausgelieferten  CPX-Module  sind  Form-CPX-Dateien.  Dies  zeigt,  daB  es  in 
den  meisten  Fallen  ausreicht,  Form-CPX  zu  benutzen. 
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CPX-Format 

Bevor  wir  zur  Programmierung  der  CPX-Dateien  iibergehen,  wollen  wir  das  Dateiformat  und 
die  Terminologie  naher  betrachten. 

Der  Aufbau  der  CPX-Datei  ist  einem  nonnalen  Programm  sehr  ahnlich.  Sie  besteht  aus  einem 
512  Byte  groBen  Header  und  dem  tibrigen  Dateiinhalt,  bei  dem  es  sich  fast  um  eine  normale 
GEMDOS-Programmdatei  handelt. 


Header  (512  Byte) 


GEMDOS-Programmheader 


Text-Segment 


Data-Segment 


Relozierungsinformationen 


Der  Aufbau  des  Headers  selbst: 


typadef  struct 
{ 

UWORD  magic;  /*  =  100  */ 

struct 
{ 


unsigned  reserved 

;  13; 

/*  reserviert  */ 

unsigned  resident 

:  1; 

/*  RAM-resident  */ 

unsigned  bootinit 

:  1; 

/*  Boot-Initialisierung  */ 

unsigned  setonly 

:  1; 

/*  Set-Only  */ 

)  flags; 

LONG  cpx  id; 

/* 

eindeutige  CPX-ID  */ 

UWORD  cpxjversion; 

/* 

CPX-Versionsnurraner  */ 

char  i_text[14); 

/* 

1 context  */ 

UWORD  sm_icon [48]; . 

/* 

Bitmap  (32  x  24  Pixel)  */ 

UWORD  i_color; 

/* 

Iconfarbe  */ 
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char 

title_text [18 ] ; 

/*  Name  */ 

UWORD 

t_color; 

/*  Textfarbe  */ 

char 

buffer [64] ; 

/*  nicht  fliichtiger  Puffer  */ 

char 

reserved [306] ; 

/*  reserviert  */ 

}  CPXHEAD; 

Bemerkungen 

-  Die  erste  Funktion  im  Textsegment  muB  die  Initialisierungsroutine  fiir  die  CPX  sein 
(siehe  Definition  von  “cpxjnit()”). 

-  Zur  Konstruktion  solcher  Header  ist  fiir  eingetragene  Entwickler  bei  Atari  ein  spezielles 
Tool  erhaltlich. 

-  Header  und  gelinkte  Programmdatei  konnen  in  den  meisten  UNIX-ahnlichen  Shells  mit 
dem  Kommando  “cat”  zusammengefugt  werden. 

-  Bei  der  CPX-Entwicklung  ist  es  sehr  praktisch,  da  6  man  XControl  auch  als  Programm 
starten  kann  (einfach  von  “XCONTROL. ACC”  in  “XCONTROL. APP”  umbenennen). 
So  kommt  man  um  ein  permanentes  Neu-Booten  des  Rechners  herum. 

-  CPX-ID  und  -Versionsnummer  sorgen  dafiir,  daB  jede  CPX  nur  ein  einziges  Mai  -  und 
auch  nur  die  neueste  Version  -  erscheint. 

Die  offizielle  Terminologie  fiir  die  Dateinamen  ist: 


Namenserweiterung 

Dateityp 

*.CPX 

Standard-CPX-Datei,  fertig  zum  Gebrauch 

*.CP 

Standard-CPX-Datei  ohne  Header 

*_R.CPX 

residente  CPX-Datei 

*_S.CPX 

set-only  CPX-Datei 

*.HDR 

Header  fiir  CPX-Datei 

*.CPZ 

inaktive  CPX-Datei  (von  XControl  deaktiviert) 

Programmierrichtlmien 

In  diesem  Zusammenhang  auch  einige  Gmndregeln,  die  bei  der  Programmierung  von  CPX- 
Modulen  beachtet  werden  sollen: 
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-  Reservierter  Speicher  ist  moglichst  schnell  wieder  freizugeben. 

-  XControl-Funktionen  sind  immer  auszunutzen,  wenn  dies  inoglich  ist. 

-  Die  Benutzerschnittstelle  ist  einfach  und  in  Anlehnung  an  die  anderen  CPX-Module  zu 
gestalten. 

Grafische  Elemente  sind  Menukommandos  vorzuziehen. 

-  “OK”  und  “Abbruch”/“Cancel”  sind  -  sofem  notig  -  immer  zu  implementieren.  Hierbei 
heiBtes  “OK”  (nic/tt  “Ok”)  und“Abbruch”/‘Cancel”(nic/rt“ABBRUCH”/’,CANCEL”). 

-  Popup-Mentis  sind  als  Text  mit  schattiertem  Rechteck  darzustellen. 

-  AC_CLOSE  -  das  Verlassen  des  Hauptprogramms  -  wird  als  “Abbruch”  gewertet. 

-  WM_CLOSE  -  das  SchlieBen  des  XControl-Fensters  -  wird  als  “OK”  gewertet. 

-  “Save”/”Sichem”  ist  als  “OK”  ohne  Verlassen  des  Dialogs  zu  betrachten. 

-  Das  Wurzelobjekt  der  CPX  hat  immer  eine  GroBe  von  256  x  176  Pixeln. 

-  Interrupt-Vektoren  diirfen  nicht  verandert  werden. 

-  “Xform_do()”  darf  nicht  mit  Funktionen  fiir  Event-CPX  vermischt  werden. 

-  Reservierter  Speicher  darf  beim  Verlassen  der  CPX  nicht  vergessen  werden,  da  es  sonst 
zu  einer  Speicherfragmentierung  kommt. 

-  Bereits  von  anderen  CPX  verwandte  IDs  diirfen  nicht  mehr  benutzt  werden. 

-  Geoffnete  Dateien  miissen  auf  jeden  Fall  wieder  geschlossen  werden. 

-  Geoffnete  VDI-Workstations  sind  auf  jeden  Fall  wieder  zu  schlieBen  (spatestens  bei 
AC_CLOSE/WM_CLOSE!),  wenn  sie  nicht  mehr  benotigt  werden. 

Nun  zur  Programmierung  eines  CPX-Moduls  selbst.  Da  ein  CPX-Modul  -  mit  Ausnahme  von 
64  Byte  -  iiber  keinen  nicht-verganglichen  Speicher  verfiigt,  ist  nichts  erlaubt,  was  Speicher 
in  irgendeiner  Form  fest  reserviert.  Variableninhalte  gehen  mit  dem  Verlassen  des  CPX- 
Moduls  in  der  Regel  verloren!  Eine  Folge  dieser  Tatsache  ist  zum  Beispiel,  daB  Resourcen 
statisch  eingebunden  werden  miissen,  Speicheranforderungen  nur  kurzzeitig  erfolgen  diirfen 
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und  keine  virtuellen  VDI-Workstations  (wg.  der  intemen  Speicheranforderung)  dauerhaft 
angelegt  werden. 

Ein  Beispiel-CPX 

Nehraen  wir  als  Beispiel  ein  ganz  einfaches,  aber  lauffahiges  CPX-Modul: 

/*  sample. c  */ 

/*  Entwickelt  mit  Turbo  C.  */ 

#include  <aes.h>  /*  AES  */ 

# include  <stddef.h>  /*  Standard-Definitionen  */ 

♦include  <cpxdata.h>  /*  CPX-Datenstrukturen  */ 

/*  Prototypen  */ 

CPXINFO*  cdecl  cpx_init (XCPB  *Xcpb) ; 

WORD  cdecl  cpx_call (GRECT  *rect); 

/*  CPX-Strukturen  */ 

XCPB  *xcpb;  /*  XControl  Parameter  Block  */ 

CPXINFO  cpxinfo  =  /*  CPX  Information  Structure  */ 

{ 

cpx_call,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL 

}; 

/*  Resourcen/einfache  Dialogbox  */ 

♦define  BOK  2 

♦define  NUMjOBS  3 

OBJECT  tree [ ]  = 

{ 

( 

-1,  1,  BOK, 

G_BOX,  NONE,  NORMAL, 

(long)  QxOOllOlL, 

0x0000,  0x0000,  0x0020,  0x000b 

}, 

{ 

BOK,  -1,  -1, 

G_STRING,  NONE,  NORMAL, 

(long)  "Beispiel", 

0x000c,  0x0004,  0x0008,  0x0001 
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f 

0,  -1,  -1, 

GJ3UTT0N,  LASTOB  |  EXIT  |  DEFAULT  |  SELECTABLE, 
NORMAL, 

(long)  "OK", 

0x0002,  0x0009,  0x0007,  0x0001 

} 


/*  der  Initialisierungsaufruf  */ 

CPXINFO  *  cdecl  cpx_init  (XCPB  *Xcpb) 

{ 

WORD  i; 
xcpb  =  Xcpb; 

/*  Bootvorgang?  Dann  Ende  und  anz'eigen,  daB  die  CPX 
erscheinen  soil,  also  nicht  'set-only'  ist...  */ 
if  (xcpb->booting)  return  ( (CPXINFO  *)  1)  ; 

/*  Resourcen  fixiert?  */ 
if  ( !xcpb->SkipRshFix) 

for  (i  =0;  i  <  NUMjOBS;  i++) 

(*xcpb->rsh_obfix) (tree,  i) ; 
return  Scpxinfo; 

} 

/*  der  eigentliche  Aufruf  des  CPX-Moduls  * / 

WORD  cdecl  cpx_call  (GRECT  *rect) 

{ 

WORD  msg [ 8 ] ; 

/*  Dialogbox  anpassen  */ 
tree  [ROOT]  .ob_x  =  rect->g_x; 
tree [ROOT] .ob_y  =  rect->g_y; 

/*  Dialogbox  ausgeben  */ 
objc_draw  (tree,  ROOT,  MAXJ3EPTH, 

rect->g_x,  rect->g_y,  rect->g_w,  rect->g_h) ; 
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/*  Dialog  durchfuhren  */ 
(*xcpb->Xform_do) (tree,  0,  msg) ; 

/*  fertig!  */ 
return  0; 

} 

Femer  wird  ein  kleines  Assemblermodul  benotigt. 

;  cpxstart.s 


;  Startup-Datei  fur  CPX-Module 
/ 

. globl  cpxstart 

. g 1 obi  save_var s 

. globl  cpx_init 

•  text 
cpxstart : 

jmp  cpx_init 

.data 

;  Speicherbereich  fur  Default -Einstellungen 
;  {muB  ggf.  angepaflt  werden) 
save__vars : 

.  dc .  w  0 

.end 

Mit  der  folgenden  Projektdatei  wird  das  CPX-Modul  in  Turbo  C  iibersetzt: 

SAMPLE. CP 

CPXSTART.S 
SAMPLE.C 
TCSTDLIB . LIB 
TCGEMLIB . LIB 
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Definitionen  und  Strukturen 

Nun  haben  Sie  einen  Einblick  in  den  Aufbau  eines  CPX-Moduls  gewonnen.  Es  bleibt  noch, 
die  Strukturen  CPXINFO  und  XCPB  sowie  alle  dazugehorigen  Definitionen  zu  erklaren: 

/*  cpxdata.h  */ 
typedef  struct 
{ 

WORD  x; 

WORD  y; 

WORD  buttons; 

WORD  kstate; 

}  MEETS; 

typedef  struct 

{ 

WORD  handle;  /*  aus  graf_handle  () -Aufruf  von 

XControl.  Wichtig  fur  v_opnvwk() !  */ 
WORD  booting;  /*  ungl.  0:  Initialisierg. /Bootvorg.  */ 

WORD  reserved;  /*  reserviert  */ 

WORD  SkipRshFix; /*  ungleich:  Resourcekoordinaten  bereits 

transformiert  */ 

void  *reservel;  /*  reserviert  */ 

void  *reserve2;  /*  reserviert  */ 

void  cdecl  (*rsh_fix) (WORD  num_objs,  WORD  num_frstr, 

WORD  num_frimg,  WORD  num_tree, 

OBJECT  *rs_object,  TEDINFO  *rs_tedinfo, 
char  *rs_strings [] ,  ICONBLK  *rs__iconblk, 
BITBLK  *rs_bitblk,  long  *rs_frstr, 
long  *rs_frimg,  long  *rs_tr index, 
struct  foobar  *rs__imdope)  ; 

void  cdecl  (*rsh_obfix) (OBJECT  *tree,  WORD  curob) ; 

WORD  cdecl  (*Popup) (char  *items[],  WORD  num_items, 

WORD  default_item,  WORD  font_size, 

GRECT  ^button,  GRECT  *world) ; 
void  cdecl  (*Sl_size) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  num_items,  WORD  visible, 

WORD  direction,  WORD  rrdn_size)  ; 
void  cdecl  (*Sl_x) (OBJECT  *tree,  WORD  base,  WORD  slider, 
WORD  value,  WORD  numjnin,  WORD  num_max, 
void  (*foo) (void) ) ; 


XCONTROL 


725 


void  cdecl 


void  cdecl 


void  cdecl 


void  cdecl 


WORD  cdecl 

GRECT  *  cdecl 
GRECT  *  cdecl 
void  cdecl 

WORD  cdecl 
WORD  cdecl 
void  *  cdecl 
WORD  cdecl 
WORD 


void  cdecl 
}  XCPB; 

typedef  struct 

{ 

WORD  cdecl 
void  cdecl 
void  cdecl 
void  cdecl 
void  cdecl 
void  cdecl 
void  cdecl 
void  cdecl 


(*Sl_y) (OBJECT  *tree,  WORD  base,  WORD  slider, 
WORD  value,  WORD  num_min,  WORD  numjmax, 
void  <*foo) (void) ) ; 

(*Sl_arrow) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  obj,  WORD  inc,  WORD  rain, 
WORD  max,  WORD  *numvar,  WORD  direction, 
void  (*foo) (void) ) ; 

(*Sl_dragx) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  min,  WORD  max, 

WORD  *numvar,  void  (*foo) (void)); 

(*Sl_dragy) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  min,  WORD  max, 

WORD  *numvar,  void  (*£oo) (void) ) ; 

(*Xforra__do) (OBJECT  *tree,  WORD  start_field, 
WORD  *puntmsg) ; 

(*GetFirstRect) (GRECT  *prect) ; 

(*GetNextRect) (void) ; 

(*Set_Evnt_Mask) (WORD  mask,  MOBLK  *ml, 

MOBLK  *m2,  long  time) ; 

(*XGen_Alert) (WORD  id) ; 

(*CPX_Save) (void  *ptr,  long  num) ; 

(*Get_Buffer) (void) ; 

(^getcookie) (long  cookie,  long  *p_value) ; 
Country_Code; 

/*  Landerkennung,  analog  zu  der  im 
OSHEADER  -  allerdings  in  fester 
Abhangigkeit  von  der  XControl -Vers ion  */ 
(*MFsave) (WORD  saveit,  MFORM  *mf) ; 


(*cpx_call) (GRECT  *work) ; 

(*cpx_draw) (GRECT  *clip) ; 

(*cpx_wmove) (GRECT  *work) ; 

(*cpx_timer) (WORD  *event); 

(*cpx_key) (WORD  kstate,  WORD  key,  WORD  *event) ; 
(*cpx_button) (MRETS  *mrets,  WORD  *event) ; 
(*cpx_ml) (MRETS  *mrets,  WORD  *event) ; 

(*cpx_m2) (MRETS  *mrets,  WORD  *event) ; 
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WORD  cdecl 

void  cdecl 
}  CPXINFO; 


(*cpx_hook) (WORD  event,  WORD  *msg,  MRETS 
*mrets,WORD  *key,  WORD  *nclicks) ; 
(*cpx_close) (WORD  flag) ; 


Idefine  VERTICAL  0 

# define  HORIZONTAL  1 

Idefine  SAVE_DEF AULTS  0 
#define  MEM_ERR  1 

#define  FILE_ERR  2 

#define  FILE_NOT_FOUND  3 

Idefine  MFSAVE  1 

#define  MFRESTORE  0 


/*  zusatzliche  Definition  fur  Xform_do()  */ 
#define  CT  KEY  53 
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Von  der  CPX  bereitgestellte  Funktionen 


cpxinit  (Intitialisierung) 


Diese  Funktion  muS  am  Beginn  des  Textsegments  derCPX-Datei  stehen  (nun  ja,  zumindest 
ein  Sprungbefehl  zu  ihrem  Anfang)  und  wird  wahrend  der  XControl-Initialisierung  sowie 
beim  Aktivieren  der  CPX  aufgerufen. 

Als  Parameter  erhalt  sie  einen  Zeiger  auf  die  oben  definierte  XCPB-Struktur.  Als  Resultat  Iie- 
fert  man  einen  Zeiger  auf  die  eigene  CPXINFO-Struktur  oder  einen  Nullzeiger  zuriick. 


Deklaration  in  C: 

CPXINFO  *  cdecl  cpx_init  (XCPB  *xcpb) ; 

Eingabe-Parameter: 

xcpb:  Zeiger  auf  die  XCPB-Struktur  von  XControI 


Ausgabe-Parameter: 

NULL:  Es  handelt  sich  um  eine  “set-only”  CPX. 

sonst:  Zeiger  auf  die  CPXINFO-Struktur  der  CPX  (oder  wahrend  des  Bootens: 

irgendein  Wert  ungleich  Null,  um  anzuzeigen,  daB  XControI  die  CPX  in  die 
Liste  der  aktivierbaren  CPXe  aufnehmen  soli). 
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Funktionen  aus  CPXINFO 


cpx_eall  (Aktivierungsroutine) 


Quasi  das  Hauptprogramm  des  CPX-Moduls.  “cpx_call()”  wird  nach  “cpx_init()”  aufgerufen, 
wenn  der  Anwender  das  entsprechende  Modul  ausgewahlt  hat.  Als  Ubergabeparameter  erhalt 
man  die  Koordinaten  der  Arbeitsflache  im  XControl-Fenster.  Somit  lafit  sich  zum  Beispiel  die 
Dialogbox  passend  plazieren. 


Deklaration  in  C: 

WORD  cdecl  (*cpx_call) (GRECT  *work) ; 


Eingabe-Parameter: 

work:  Rechteck  mit  den  Koordinaten  des  XControl-Fensters 


Ausgabe-Parameter: 

0:  Ende  der  Bearbeitung 

sonst:  CPX  soil  weiterbearbeitet  werden 


XCONTROL 


729 


Event-Handling-Routinen  aus  CPXINFO  (nur  fur  Event-CPX) 
cpxdraw  (Redraw-Ereignis)  ~j 

Diese  Routine  wird  aufgerufen,  wenn  ein  CPX-Modul  aktiv  ist  und  XControl  ein  Redraw 
benotigt.  Die  notige  Rechteddiste  ist  mit  “GetFirstRect()”  und  “GetNextRectO”  abzurufen. 

Deklaration  in  C: 

void  cdecl  (*cpx_draw) (GRECT  *clip) ; 

Eingabe-Parameter: 

dip:  neu  zu  zeichnender  Bereich,  der  auch  als  Ubergabeparameter  fur  “GetFirstRect()” 
benotigt  wird. 


cpx  wmove  (Fensterverschiebung) 

“cpx_wmove()”  wird  aufgerufen,  wenn  der  Anwender  das  XControl-Fenster  bewegt. 

Deklaration  in  C: 

void  cdecl  (*cpx_wmove) (GRECT  *work) ; 

Eingabe-Parameter: 

work:  neue  Fenster-Koordinaten 
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cpxtimer  (Timer-Event) 

.  ! 

Die  Funktion  wird  aufgerufen,  wenn  ein  Timer-Event  aufgetreten  ist.  Timer-Events  werden 
von  Form-CPX  nicht  unterstiitzt. 

Deklaration  in  C: 

void  cdecl  (*cpx_timer) (WORD  *event) ; 

Ausgabe-Parameter: 

event:  auf  1  setzen,  wenn  die  CPX  verlassen  werden  soli;  ansonsten  ignorieren 


cpxjkey  (Keyboard-Event) 

“cpx_key()”  wird  aufgerufen,  wenn  ein  Keyboard-Event  aufgetreten  ist. 

Deklaration  in  C: 

void  cdecl  (*cpx_key) (WORD  kstate,  WORD  key,  WORD  *event) ; 

Eingabe-Parameter: 

kstate:  Status  der  Umschalttasten  (Alternate,  Control,  Shift  etc.) 

key:  enthalt  im  Highbyte  den  Scancode  und  im  Lowbyte  den  ASCII-Code  (sofem 

vorhanden)  der  gedriickten  Taste 

Ausgabe-Parameter: 

event:  auf  1  setzen,  wenn  die  CPX  verlassen  werden  soil;  ansonsten  ignorieren 
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cpxjbutton  (Maustasten-Event) 

Die  Funktion  wird  bei  einem  aufgetretenen  Maustasten-Event  aufgerufen. 

Deklaration  in  C: 

void  cdecl  (*cpx_button) (MRETS  *mrets,  WORD  nclicks,  WORD  *event) ; 

Eingabe-Parameter: 

mrets:  Parameter  der  Maus,  die  zu  diesem  Event  gehoren 

nclicks:  Anzahl  der  Mausklicks 

Ausgabe-Parameter: 

event:  auf  1  setzen,  wenn  die  CPX  verlassen  werden  soil;  ansonsten  ignorieren 


cpxjml,  cpx_m2  (Mausrechteck-Event) 

“cpx_ml()”  bzw.  “cpx_m2()”  werden  dann  aufgerufen,  wenn  der  Mauszeiger  bestimmte 
Rechtecke  betritt  oder  verlafit. 

Deklaration  in  C: 

void  cdecl  (*cpx__ml) (MRETS  *mrets,  WORD  *event); 
void  cdecl  (*cpx_rn2) (MRETS  *mrets,  WORD  *event) ; 

Eingabe-Parameter: 

mrets:  Parameter  der  Maus,  die  zu  diesem  Event  gehoren 

Ausgabe-Parameter : 

event:  auf  1  setzen,  wenn  die  CPX  verlassen  werden  soil;  ansonsten  ignorieren 
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cpxhook  (Preemption  Hook) 


Die  Funktion  wird  sofort  nach  “evnt_multi()”  aufgerufen,  also  noch  be  vor  XControl  das  Event 
verarbeitet. 

Deklaration  in  C: 

WORD  cdecl  (*cpx_hook)  (WORD  event,  WORD  *msg,  MRETS  *mrets, 

WORD  *key,  WORD  *nclicks) ; 


Eingabe-Parameter: 

event:  aufgetretene  Events 

msg:  Ereignispuffer 

mrets:  Mausparameter 

key:  Tastendrack 

nclicks:  Anzahl  der  Mausklicks 


Ausgabe-Parameter: 

0:  Eventverarbeitung  fortsetzen 

sonst:  Eventverarbeitung  abbrechen 


■  - - -  !  - - - - ■ 

cpxelose  (Close-Event) 

- 1 


“cpx_close()”  wirdbei  jeder  AC_CLOSE-  undjeder  WM_CLOSE-Message  aufgerufen.  Die 
CPX  muB  dann  sofort  alien  reservierten  Speicher  (“MallocO”,  "v_opnvwk()”,  etc.)  freigeben. 
Die  Funktion  muB  bei  jeder  Event-CPX  implementiert  sein.  ACJXOSE  ist  als  Klick  auf  “Ab- 
bruch”  oder  “Cancel”  zu  werten,  WM_CLOSE  als  “OK”  (Bemerkung:  CPX-Module  sollten 
so  selten  wie  moglich  Speicher  reservieren). 

Deklaration  in  C: 

void  cdecl  (*cpx_close) (WORD  flag) ; 

Eingabe-Parameter: 

flag:  0:  AC_CLOSE-Mitteilung 

sonst:  WM_CLOSE-Mitteilung 
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Von  XControl  bereitgestellte  Funktionen 


“  : - - - : - - - ; - ; - 

rshjfix  (Objektbaum-Umwandlung) 


Wandelt  einen  Objektbaum  auf  Basis  von  8x16  Pixel  groBen  Zeichen  -  also  pixelgenau  und 
nicht  auf  Basis  des  aktuellen  Systemzeichensatzes  -  um.  Die  CPX  hat  somit  unter  alien  Auf- 
losungen  die  gleiche  Pixelgrofie.  Bei  der  Arbeit  mit  einem  RCS  sollte  man  daher  ebenfalls 
einen  Grafikmodus  mit  8x16  Pixel  groBen  Zeichen  wahlen. 

Die  Koordinatenumwandlung  darf  natiirlich  nur  ein  einziges  Mai  stattfinden  -  XControl  stellt 
dazu  in  der  XCPB-Struktur  das  Flag  “SkipRshFix”  zur  Verfiigung. 


Deklaration  in  C: 

void  cdecl  (*rsh__fix)  (WORD  num_objs,  WORD  num_frstr,  WORDnum_frimg, 
WORD  num_tree,  OBJECT  *rs_objsct,  TEDINFO  *rs__tedinfo, 
char  *rs_string [ ] ,  ICONBLK  *rs_iconblk, 

BITBLK  *rs_bitblk,  long  *rs_frstr,  long  *rs_frimg, 
long  *rs_trindex,  struct  foobar  *rs_imdope) ; 

Eingabe-Parameter: 

analog  zu  den  C-Resourcen,  die  vom  Atari-RCS  angelegt  werden 


rshobfix  (Objekt-Umwandlung) 


Entspricht  der  Funktion  “rsrc_obfix()”,  nur  daB  die  CPX-spezifische  Umrechnungsregel  von 
Zeichen-  in  Pixelkoordinaten  benutzt  wird. 


Deklaration  in  C: 

void  cdecl  (*rsh  obfix) (OBJECT  *tree,  WORD  curob) ; 


Eingabe-Parameter: 

tree:  Zeiger  Objektbaum 

curob:  zu  konvertierendes  Objekt 
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Popup  (Popup-Menu j 


Diese  Funktion  ermoglicht  die  komplette  Verwaltung  eines  Popup-Menus.  Bei  zu  vielen  Ein- 
tragen  (ab  fiinf)  wird  automatisch  gescrollt.  Die  Abarbeitung  des  Popup  biockiert  alle  anderen 
Aktionen. 


Declaration  in  C: 

WORD  cdecl  (*Popup)  (char  *iteras[],  WORD  num_items,  WORD  default_item, 
WORD  font  size,  GRECT  *button,  GRECT  *world) ; 


Eingabe-Parameter: 


items:  Array  mit  Zeichenketten  fur  die  einzelnen  Eintrage.  Jeder  einzelne  Eintrag  muB 

die  gleiche  Lange  haben  sowie  vome  mindestens  zwei  und  am  Ende  mindestens 
ein  Leerzeichen  aufweisen. 
num_items:  Anzahl  der  Eintrage 

default_item:  Default-Eintrag  (Zahlung  beginnt  bei  0)  oder  -1 

font_size:  ZeichengroBe;  8x16-  oder  8x8-Font:  Als  Parameter  sind  die  gleichen  Werte  wie 

in  der  TEDINFO-Struktur  -  also  3  (groB)  bzw.  5  (kiein)  -  zu  verwenden.  Laut 
Atari  wird  zur  Zeit  nur  der  groBe  Zeichensatz  verwendet. 
button:  Rechteck  des  Buttons,  zu  dem  das  Popup-Menus  gchort 

world:  Rechteck  des  Hintergrund-Objektbaums  (in  der  Regel  der  Objektbaum  der 


CPX) 


Ausgabe-Parameter: 
gewahlter  Eintrag  (ab  0)  oder  -1 
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SIsize  (Slidergrofie) 

.  .  - - ■ - 1 

“Sl_size()”  stellt  die  GroBe  des  Sliders  ein,  damit  die  Relation  der  dargestellten  Datenmenge 
zur  vorhandenen  gewahrt  bleibt. 

Deklaration  in  C: 

void  cdecl  (*Sl_size) (OBJECT  *tree,  WORD  base,  WORD  slider, 

WORD  num_items,  WORD  visible,  WORD  direction, 
WORD  min  size) ; 


Eingabe-Parameter : 


tree: 

base: 

slider: 

numjtems: 

visible: 

direction: 

min_size: 


Zeiger  auf  Objektbaum 

Basisobjekt  (Hintergrundobjekt  fur  Slider) 

Slider;  Objekt,  welches  innerhalb  des  Basisobjekts  bewegt  wird  (Child  des 
Basisobjekts) 

Anzahl  der  tatsachlich  vorhandenen  Elemente 

Anzahl  der  sichtbaren  Elemente 

Richtung  (VERTICAL  (0)  Oder  HORIZONTAL  (1)) 

MinimalgroBe  des  Sliders  in  Pixeln 
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Sl_x,  Sl_y  (Positionierung  eines  Sliders) 


Die  beiden  Funktionen  positionieren  den  Slider  innerhalb  eines  Basisobjekts  in  horizontaler 
bzw.  vertikaler  Richtung. 


Deklaration  in  C: 

void  cdecl  (*Sl_x) (OBJECT  *tree,  WORD  base,  WORD  slider, 
WORD  value, WORD  num_min,  WORD  max, 
void  (*foo) (void) ) ; 

void  cdecl  (*Sl_y) (OBJECT  *tree,  WORD  base,  WORD  slider, 
WORD  value,  WORD  nurnjnin,  WORD  max, 
void  (*foo) (void) ) ; 


Eingabe-Parameter: 

tree:  Zeiger  auf  Objektbaum 
base:  Basisobjekt 

slider:  Slider  (Child  des  Basisobjekts) 
value:  neuer  Wert,  den  der  Slider  reprasentieren  soil 
min:  Minimalwert,  den  value  annehmen  darf 
max:  Maximal wert,  den  value  annehmen  darf 

foo:  Adresse  einer  Funktion  (oder  NULL) ,  die  gleichzeitig  mit  der  Slider-Neupositionierung 

aufgerufen  wird;  so  lassen  sich  Sliderbewegungen  ausnutzen,  um  auch  die  angezeigten 
Werte  zu  emeuem. 
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Sl_arrow  (Sliderarrow) 


Sobald  einer  der  zu  dem  Slider  gehorigen  Pfeile  angeklickt  wird,  ist  diese  Funktion  aufzurufen. 
Sie  wird  auch  dazu  benutzt,  um  einen  Klick  auf  das  Basisobjekt  des  Sliders  auszuwerten. 


Deklaration  in  C: 

void  cdecl  (*Sl_a.rrow)  (OBJECT  *tree,  WORD  base,  WORD  slider, 

WORD  ob j , WORD  inc,  WORD  min,  WORD  max, 
WORD  *value,  WORD  direction, 
void  (*foo) (void) ) ; 


Eingabe-Parameter: 


tree: 

base: 

slider: 

obj: 

inc: 


min: 

max: 

value: 

direction: 

foo: 


Zeiger  auf  Objektbaum 
Basisobjekt 

Slider  (Child  des  Basisobjekts) 

Pfeil,  der  angeklickt  wurde 

Inkrementierung  (Anzahl  der  Einheiten,  die  addiert  oder  subtrahiert  werden 

sollen);  sollte  fur  angeklicktes  Basisobjekt  (seitenweises  Blattem)  und  Arrow- 

button  (zeilenweises  Blattem)  unterschiedlich  sein 

Minimalwert,  der  angenommen  werden  kann 

Maximalwert,  der  angenommen  werden  kann 

Adressen  fur  aktuellen  Wert 

VERTICAL  (0)  oder  HORIZONTAL  (1) 

Adresse  einer  Funktion  analog  zu  “Sl_x()”  und  “Sl_yO” 


738 


ATARI  Profibuch 


SI_dragx,  Sldragy  (Sliderdrag-Bewegung) 


Beim  Draggen  des  S  liders  wird  selbiger  angeklickt  und  bei  fes  tgehaltener  Maustaste  innerhalb 

eines  Basisobjekts  bewegt.  Die  beiden  Funktionen  verwalten  diese  Bewegung. 

Deklaration  in  C: 

void  cdecl  (*Sl_dragx) (OBJECT  *tree,  WORD  base,  WORD  slider, 

WORD  min, WORD  max,  WORD  * value, 
void  (*foo) (void) ) ; 

void  cdecl  (*Sljdragy) (OBJECT  *tree,  WORD  base,  WORD  slider, 

WORD  min, WORD  max,  WORD  * value, 
void  (*foo) (void) ) ; 


Eingabe-Parameter: 

tree:  Zeiger  auf  Objektbaum 

base:  Basisobjekt 

slider:  Slider  (Child  des  Basisobjekts) 

min:  Minimalwert,  der  angenommen  werden  kann 

max:  Maximalwert,  der  . angenommen  werden  kann 

value:  Adresse  fiir  aktuellen  Wert 

foo:  Adresse  einer  Funktion  analog  zu  “Sl_x()”  und  “SI _ >'()” 
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Xformdo  (Formular-Verwaltung) 


Die  Formular-Verwaltung  erfolgt  analog  zu  der  bekannten  AES-Funktion  “form_do()”,  ist 
jedoch  etwas  komplexer.  Sie  iibemimmt  in  geringem  Umfang  auch  das  Bearbeiten  von  AES- 
Mitteilungen. 


Deklaration  in  C: 

WORD  cdecl  (*Xform_do) (OBJECT  *tree,  WORD  startob,  WORD  *puntrasg) ; 


Eingabe-Parameter: 

tree:  Objektbaum  (wie  bei  “form_do()”) 

startob:  Start-Objekt  (wie  bei  “form_do()”) 

puntmsg:  Mitteilungs-Puffer  (ahnlich  “evnt_mesag()”/“evnt_multi()”) 


Ausgabe-Parameter: 

-1 :  puntmsg  enthalt  eine  Nachricht,  die  auszuwerten  ist: 

WM_REDRAW  (20):  Die  CPX  muB  solche  Objekte  selbst  neuzeichnen,  die  nicht 
zum  Objektbaum  gehoren.  Die  Rechteckliste  ist  iiber 
“GetFirstRectO”  und  “GetNextRectO”  abzufragen. 

AC_CLOSE  (41), 

WM„CLOSE  (22):  Die  CPX  wurde  beendet.  Reservierter  Speicher  ist  sofort 

freizugeben. 

AC.CLOSE  ist  als  “  Abbruch”  und  WMJXOSE  als  “OK”  zu 
werten! 

CT_KEY  (53):  Eine  spezielle  Nachricht,  die  die  Auswertung  von  Ta- 

stendriicken  erlaubt,  sofem  diese  keine  Auswirkungen  auf 
Editfelder  haben  konnen  -  also  Funktionstasten,  HELP  und 
UNDO.  puntmsg[3]  enthdl  t  Scancode  (High-byte)  und  ASCII- 
Code  (Lowbyte)  der  gedriickten  Taste. 

sonst:  Nummer  des  angeklickten  Objekts  (im  oberen  Bit  die  Kennzeichnung  fur  einen  Dop- 

pelklick) 
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GetFirstRect,  GetNextRect  (Rechteckliste) 


Die  Rechteckliste,  die  zum  Neuzeichnen  von  Fensterbereichen  nach  einer  WMJREDRA  W- 
Message  notig  ist,  wird  mit  den  beiden  Funktion.  “GetFirstRectO”  und  “GetNextRectO” 
abgefragt.  Den  Objektbaum  verwaltet  jedoch  XControl  selbst! 


Deklaration  in  C: 

GRECT  *  cdecl  (*GetFirstRect) (GRECT  *prect) ; 
GRECT  *  cdecl  (* GetNextRect) (void) ; 

Eingabe-Paranieter: 

prect:  Zu  aktualisierender  Bereich 

Ausgabe-Parameter: 

NULL:  keine  weiteren  Ausschnitte  vorhanden 

sonst:  wiederherzustellender  Ausschnitt 


Set_Evnt_Mask  (Eventmaske  setzen) 

Bei  Event-CPX  bestimmt  “Set_Evnt_Mask()”,  auf  welche  Events  die  CPX  reagieren  soil. 

Deklaration  in  C: 

void  cdecl  (*Set_Evnt_Mask) (WORD  mask,  MOBLK  *ml,  MOBLK  *m2, 

long  time) ; 


Eingabe-Paranieter: 

mask:  erlaubte  Events  (analog  zu  “evnt_multi()”) 

ml ,  m2:  jeweils  Mausrechteck  und  -richtung 

time:  Zeit  in  Millisekunden  fur  Timerevent 
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XGen_Alert  (Alarmbox) 


Eine  einfache  Form  einer  Alarmbox  bietet  “XGen_Alert()”.  Die  Funktion  bietet  Alarmboxen 
jedoch  nur  fiir  wenige  Fehlermeldungen  an,  weitere  Alarmboxen  miissen  selbst  definiert 
werden.  “form_alert()”  bietet  sich  hier  jedoch  nicht  an,  da  es  die  Alarmbox  bezuglich  der 
vollen  Bildschirmflache  und  nicht  bezuglich  des  XControl-Fensters  zentriert. 


Deklaration  in  C: 

WORD  cdecl  (*XGen  Alert) (WORD  id) ; 


Eingabe-Parameter: 

id:  0:  SAVE_DEF AULTS  (“Voreinstellungen  sichem?”) 

1:  MEM_ERR  (“Fehler  bei  Speicheranforderung!”) 

2:  FILE_ERR  (“Fehler  beim  SchreibenTLesen  von  Dateien!”) 
3:  FILE_NOT_FOUND  (“Datei  nicht  gefunden!”) 


Ausgabe-Parameter: 

0:  “Abbruch”  bzw.  “Cancel”  wurde  angeklickt. 

sonst:  “OK”  wurde  angeklickt  (wenn  eine  Alarmbox  nur  einen  Knopf  hat,  ist  es  der  OK- 
Button!). 
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CPXSave  (Defaults  sichern) 


Defaulteinstellungen  konnen  mit  “CPX_Save()”  gesichert  werden.  Dies  wird  beispielsweise 
dann  benotigt,  wenn  bestimmte  Einstellungen  beim  Bootvorgang  voreingestellt  werden 
sollen.  Um  die  Einstellungen  zu  speichem,  sucht  XControl  eine  CPX  mit  passendem  Namen. 
Wird  keine  Datei  mit  passendem  Namen  gefunden,  dann  sucht  XControl  nach  iibereinstim- 
mender  ID  und  Versionsnummer.  1st  die  CPX  anhand  der  ID  und  der  Versionsnummer 
gefunden,  so  wird  die  CPX  aktiviert,  ansonsten  meldet  XControl  -  wie  auch  im  Falle  einer 
schreibgeschiitzten  Diskette  —  einen  Fehler. 

XControl  speichert  die  Einstellungen  im  DATA-Segment  der  CPX.  Entwickler  miissen  selbst 
fur  ausreichend  freien  Speicherplatz  im  DATA-Segment  sorgen.  Dies  geschieht  iiber  das 
Datenfeld  SAVE_VARS  in  CPXSTART.S. 


Deklaration  in  C: 

WORD  cdecl  (*CPX_Save) (void  *ptr,  long  num) ; 


Eingabe-Parameter: 

ptr;  Adresse  der  zu  speichemden  Daten 

num:  Anzahl  Byte  der  in  das  DATA-Segment  zu  speichemden  Daten 


Ausgabe-Parameter: 

0:  Es  ist  ein  Fehler  aufgetreten. 

sonst:  Alles  in  Ordnung. 
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Get JBuffer  (Zwischenspeicher  ermitteln) 


Einen  Zeiger  auf  einen  64  Byte  grofien,  residenten  Speicherbereich  liefert  die  Funktion 
“GetJBuffer”.  Hierkann  eine  CPX  die  Inhalte  von  Write-Only-Registem  sichem,  sofem  TOS 
keine  Funktion  zur  Abfrage  bietet  (Beispiel:  Fensterfarben).  In  diesem  Zusammenhang  sei 
noch  einmal  darauf  hingewiesen,  daB  jeder  andere  Speicher  einer  CPX  fliichtig  ist! 

Deklaration  in  C: 

void  cdecl  (*Get  Buffer)  (void) ; 


Ausgabe-Parameter: 

Zeiger  auf  residenten  Speicherbereich 


getcookie  (Cookievariablen  abfragen) 

“getcookie”  priift,  ob  ein  bestimmter  Cookie  vorhanden  ist  und  liefert  gegebenenfalls  deren 
Wert. 

Deklaration  in  C: 

WORD  cdecl  (*getcookie) (long  cookie,  long  *p_value) ; 


Eingabe-Parameter: 

cookie:  Cookievariable 

p_value:  Adressen  einer  Variablen,  die  den  Wert  beinhalten  soil,  oder  NULL,  falls  der  Wert 
uninteressant  ist 


Ausgabe-Parameter: 

0:  Cookie  nicht  gefunden 

sonst:  Cookie  gefunden 
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Die  Mausform  kann  gesichert  (und  wiederhergestellt)  werden,  womit  der  Mauszeiger 
temporar  verandert  werden  kann.  Dies  ist  beispielsweise  dann  notig,  wenn  wahrend  einer  Sli- 
derbewegung  die  “flache  Hand”  eingeschaltet  wird.  Es  kann  nicht  davon  ausgegangen  wer¬ 
den,  da6  der  Mauszeiger  vorher  eine  bestimmte  Form  hatte! 


Deklaration  in  C: 

void  cdecl  (*MFsave)  (WORD  saveit,  MFORM  *mf )  ; 


Eingabe-Parameter: 

saveit:  1:  MFSAVE  (Mausform  sichem) 

0:  MFRESTORE  (Mausform  wiederherstellen) 
mf:  Speicherbereich  zur  Sicherung  der  Mausform 
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Kapitel  6:  Richtlinien  zur  Benutzerfiihrung 
und  Programmierung 

Grundsatzliches  zu  grafischen  Benutzeroberflachen 

Benutzeroberflache 

(user  surface,  user  interface)  Presentation  ejner  Software  gegentiber  dem  Anwender  durch 
Anzeigen  von  Arbeits-  und  Bedienungseleraenten  auf  dem  Bildschinm  und  Unterstiitzung  von 
Eingabehilfen  wie  Tastatur,  Grafiktablett  oder  Maus. 


Benutzerfreundlichkeit 

Eigenschaft  eines  Computersystems  und  der  dazugehorigen  Software.  Die  Benutzerfreund¬ 
lichkeit  der  Hardware  (z.  B.  Ein-/Ausgabegerate  wie  Tastatur,  Bildschirm,  Drucker)  hangt 
hauptsachlich  von  der  ergonomischen  Gestaltung  und  einer  guten  Dokumentation  ab.  Die  Be¬ 
nutzerfreundlichkeit  der  Software  wird  gemessen  an  der  Art  und  Qualitat  der  Bedienerfiih- 
rung. 


Bedienerfiihrung 

Bezeichnung  fiir  die  Einrichtung  einer  Software  zur  Unterstiitzung  des  An  wenders,  z.  B.  durch 
Auswahlmeniis,  Hilfsprogramme,  Sicherheitsabfragen  oder  auf  dem  Bildschirm  angezeigte 
Bedienungshinweise.  Die  Bedienerfiihrung  soli  auch  Fehlbedienungen  und  damit  zusammen- 
hangende  Datenverluste  verhindem. 

Am  Anfang  der  Computer-Geschichte  standen  kommandoorientierte  Benutzeroberflachen, 
die  mit  Benutzer freundlichkeit  eigentlich  nichts  zu  tun  hatten.  Der  Bedienung  des  Computers 
ging  ein  kleines  Studium  der  Befehle  und  Kommandos  voraus.  Beherrschte  man  diese  dann 
soweit,  daft  Programme  gestartet  werden  konnten,  so  schloB  sich  das  nachste  Studium  an. 
Jedes  Programm  hatte  seine  eigene  -  teils  recht  konfuse  -  Oberflache,  jeder  Programmierer 
programmierte  einfach  drauflos.  Die  Bedienerfiihrung  der  meisten  Programme  war  keines- 
wegs  einheitlich  und  leicht  erlembar. 

Der  Sinn  einer  einheitlichen  -  wenn  auch  nicht  immer  optimalen — Benutzeroberflache  wurde 
und  wird  von  einigen  noch  immer  nicht  recht  eingesehen.  Wer  sich  allerdings  schon  intensiver 
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mit  einer  einheitlichen,  grafischen  Benutzeroberflache  wie  GEM  auseinandergesetzt  hat, 
konnte  schnell  feststellen,  daB  derartige  Oberflachen  ihre  Berechtigung  haben  und  die 
Benutzerfreundlichkeit  wesentlich  erhohen.  Auch  das  WYSIWYG-Prinzip  -  What  You  See 
Is  What  You  Get  -  entspringt  den  Ideen  einer  grafischen  Oberfiache. 

Der  Gestaltung  und  Realisierung  einer  durchdachten  grafischen  Oberfiache,  die  sich  fiir  alle 
Anwendungen  einsetzen  laBt,  geht  eine  Untersuchung  voraus,  wie  sich  Menschen  am 
Computer  verhalten. 

Einer  dieser  gewichtigen  Punkte  ist  das  Muskelgedachtnis.  Wer  mit  einer  Schreibmaschine 
umgehen  kann,  wird  alsbald  feststellen,  daB  die  Fertigkeit,  Texte  zu  tippen,  immer  mehr 
zunimmt.  Die  Finger  “erinnem”  sich  an  die  Lage  der  Tasten.  Je  groBer  dieses  Erinnerungs- 
vcrmcigen  ist,  um  so  schneller  kommt  der  Text  auf  das  Papier. 


Das  Gesetz,  welches  dahinter  steht,  ist  das  sogenannte  Gesetz  von  Fitt: 


t  =  i '  log  ( 
mit  t; 
i: 
d: 

s: 

log: 


d  /  s  +  0,5  ) 

Zeit,  die  man  benotigt,  um  sich  zu  einem  Objekt  zu  bewegen 
Proportionalitatskonstante  (100  Millisekunden  pro  Bit) 
Abstand  des  Objekts  vom  gegenwartigen  Standort 
GroBe  des  Objekts 
Logarithmus  zur  Basis  2 


Die  Proportionalitatskonstante  resultiert  aus  einer  Art  inneren  Uhr  im  Menschen.  In  bezug  auf 
grafische  Benutzeroberflachen  bedeutet  dies:  Wege  zwischen  zwei  Objekten  moglichst  kurz 
halten,  gleichartige  Objekte  immer  an  gleichen  Platzen  unterbringen,  denn  wenn  man  schon 
weiB,  wo  ein  anderes  Objekt  zu  finden  ist,  dann  ist  der  Weg  dorthin  auch  kiirzer  (Vermeidung 
von  Umwegen!). 

Auch  die  GroBe  der  Objekte  veiringert  die  Zugriffszeit  auf  dasselbe  Objekt.  Daraus  resultiert, 
dafi  z.  B.  Buttons  in  Dialogboxen  recht  groB  ausfallen,  wobei  aber  auf  jeden  Fall  zu  beachten 
ist,  daB  man  dabei  nicht  das  MaB  der  Dinge  verliert.  Zu  groB  ist  namlich  nur  unschon.  Im  Ge- 
genteil:  Ein  groBflachiges  Rechteck  wird  unter  Umstanden  gar  nicht  mehr  als  Button  erkannt! 

Das  Muskelgedachtnis  hilft,  ein  Objekt  schnell  zu  finden,  die  Zugriffszeit  kann  dadurch  kiirzer 
werden.  Die  Zeit,  die  das  Muskelgedachtnis  selbst  benotigt,  laBt  sich  als  das  (Potenz-)Gesetz 
der  Praktikabilitat  ausdriicken: 


t(n)  =  t(l)  ■  n  ■* 

mit  t(n):  Zeit  fiir  den  n-ten  Versuch 

a:  approximative  Konstante  (ungefahr  0,4) 
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Sind  gleichaitige  Objekte  immer  an  der  gleichen  Stelle,  so  benotigt  man  fiir  den  ersten  Zugriff 
die  Zeit  t(l ).  Mit  jedem  neuen  Versuch,  die  gleiche  Funktion  auszuiiben,  sinkt  die  Zugriffszeit. 
Bei  nicht-standardisierten  Oberflachen  hingegen  verbleibt  man  ewig  bei  der  Zeit  t(  1 ).  Und  das 
ist  kein  Gewinn! 

Das  Muskelgedachtnis  hilft,  die  rein  manuelle  Zugriffszeit  zu  vermindem.  Die  Reaktionszeit 
bedingt  jedoch  das  Auge!  Experimente  haben  gezeigt,  dab  die  normale  Wahmehmungszeit 
oder  besser  Unterscheidungszeit  bei  mindestens  50  bis  200  Millisekunden  liegt.  Bilder  in 
zeitlichen  Abstanden  von  weniger  als  50  Millisekunden  werden  nicht  mehr  bewuBt,  bei  mehr 
als  200  Millisekunden  jedoch  garantiert  als  Einzelbilder  wahrgenommen.  Denken  Sie  hierbei 
an  die  niedrige  Darstellungsfrequenz  eines  Femsehers:  Abstande  zwischen  zwei  Bildem 
liegen  etwa  bei  40  Millisekunden,  also  dicht  an  der  Grenze! 

Die  Wahmehmungsfahigkeit  des  Auges  bedingt,  daB  auf  dem  Bildschirm  zwei  Ereignisse,  die 
trennbar  sein  miissen,  erst  in  einem  bestimmten  zeitlichen  Abstand  erfolgen  konnen.  Man  muB 
wahmehmen,  daB  sich  der  Mauszeiger  auf  einem  Objekt  befindet!  Diese  zeitliche  Verzoge- 
rung  bei  den  Wahmehmungen  kann  durch  bestimmte  Ereignisse  verkiirzt  werden.  Das  Auf- 
flackem  eines  invertierten  Bildes  wird  schneller  bemerkt.  Eine  Dialogbox  mit  hoher  Farbinten- 
sitat  (schwarz  auf  weiB)  wirkt  fiir  den  Menschen  vor  dem  Computer  wie  ein  visueller  Schock. 
Daraus  folgt  eine  erhebl  ich  schnellere  W ahmehmung.  Denken  Sie  an  die  Icons  bei  Alarmboxen 
oder  die  Invertierung  der  Meniieintrage  bei  Beriihrung  mit  dem  Mauszeiger  oder  an  die 
schwarz  auf  weiB  darstellten  Icons,  wenn  sie  angewahlt  wurden! 

Der  Mensch  verfiigt  iiber  ein  Kurzzeitgedachtnis,  das  jedoch  nur  eine  beschrankte  Infor- 
mationsmenge  verarbeiten  kann.  Die  Anzahl  der  Informationen  beschrankt  sich  meist  auf  die 
“magische”  Zahl  Sieben.  Die  Summe  der  wahmehmbaren  Informationen  liegt  etwa  um  zwei 
iiber  bzw.  unter  diesem  magischen  Wert  (nach  Miller).  Aus  dieser  Zahl  folgt,  wie  ein  Menu 
gestaltet  sein  muB:  maximal  sieben  Drop-Down-Menus  (zuziiglich  dem  Informationsmenii 
mit  den  Accessories).  In  jedem  Drop-Down-Menu  sollten  sich  wenige  Gruppen  von  jeweils 
maximal  sieben  Eintragen  befinden.  Zusatzlich  zu  dieser  durch  die  Anzahl  der  auftretenden 
Wahlmoglichkeiten  bedingten  Gestaltungsform  ist  ein  Menti,  bei  dem  die  einzelnen  Untermeniis 
bei  der  Beriihrung  der  Meniizeile  mit  dem  Mauszeiger  herunterfallen  (Drop-Down),  einfacher 
zu  bedienen  und  zu  erkennen  als  ein  Menu,  bei  dem  erst  mit  der  Maus  auf  einen  Eintrag  geklickt 
und  somit  das  Untermenii  (bei  gedriickter  Maustaste)  heruntergezogen  werden  muB  (Pull- 
Down). 

Auch  Farben  sollten  im  Userinterface  -  wenn  iiberhaupt  -  nur  sehr  sparsam  eingesetzt  werden . 
Einmal  daher,  weil  die  Programme  sowieso  ohne  Verlust  der  Bedienbarkeit  auch  auf 
monochromen  Bildschirmen  funktionieren  miissen.  Andererseits  sind  Farben  nur  bedingt  zur 
Ubermittlung  zusiitzlicher  Informationen  geeignet,  da  ein  bedeutender  Teil  der  Bevolkerung 
unter  Farbenblindheit  bzw.  einer  Farbsehschwache  leidet  und  die  Erkennung  und  Bewertung 
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von  Farben  hochgradig  subjektiv  ist.  Farben  sollten  also  ausschlieBlich  dann  eingesetzt 
werden,  wenn  sie  zur  Klarheit  der  Darstellung  beitragen! 

Der  Faktor  “denken”  spielt  somit  auch  eine  groBe  Rolle.  Ein  Mensch  vor  dem  Computer  sollte 
nichtdauemdnachdenken  miissen!  Bedienungselemente  miissen  intuitiv  bedienbar  sein!  Die 
Uberlegung,  wie  eine  Funktion  nun  zu  bedienen  war  oder  wo  eine  bestimmte  Einstellung 
vorgenommen  werden  kann,  verbraucht  kostbare  Zeit.  DaB  diese  Zeit  nicht  immer  entfallen 
kann,  diirfte  klar  sein.  Eine  Anwendung  sollte  aber  den  Menschen  darin  unterstiitzen, 
moglichst  wenig  Bedienungselemente  erlemen  zu  miissen.  Ein  Ziel  muB  sich  in  maximal 
sieben  Schritten  (hier  ist  die  magische  Zahl  wieder!)  erreichen  lassen. 

Nehmen  wir  ein  Beispiel:  Sie  schreiben  einen  Brief  und  entdecken  einen  falschen  Buchstaben. 
Was  ist  zu  tun?  Buchstaben  finden,  Hand  zur  Maus  bewegen,  Mauszeiger  auf  Buchstaben 
bewegen,  einmal  klicken,  Hand  zur  Tastatur  bewegen,  Buchstaben  loschen,  neuen  Buchsta¬ 
ben  eingeben.  Ein  Benutzer  muB  aber  nicht  nur  den  Bewegungsablauf  kennen,  der  hilft,  einen 
Buchstaben  zu  loschen.  Vielmehr  muB  dabei  in  Erinnerung  bleiben,  an  welcher  Stelle  am 
Dokument  gerade  geschrieben  wurde,  was  gerade  geschrieben  werden  sollte,  wo  der  fehler- 
hafte  Buchstabe  erblickt  wurde  und  wie  der  neue  Buchstabe  aussieht.  Je  groBer  die  Anzahl  der 
zu  merkenden  Dinge  wird,  desto  eher  besteht  die  Gefahr,  durcheinanderzugeraten.  AuBerdem 
dauert  ein  Vorgang  um  so  langer,  je  mehr  Dinge  in  Erinnerung  behalten  werden  miissen  und 
je  mehr  Auswahlmoglichkeiten  bestehen! 

Denken  Sie  beim  Entwurf  einer  GEM- Anwendung  an  die  unterschiedlichsten  Benutzer.  Am 
besten  ist  es,  wiihrend  der  Entwicklungsphase  unterschiedlich  erfahrene  Tester  heranzuziehen. 
Es  hat  sich  schon  immer  als  vorteilhaft  erwiesen,  absoluten  Laien  aber  auch  Experten  ein  Pro- 
gramm  in  die  Hand  zu  geben !  Ein  Programm  muB  sich  von  einem  Sekretar  wie  von  einer  Pro- 
fessorin  problemlos  bedienen  lassen! 

Die  Gestaltung  der  Benutzeroberflache 

Einleitung 

GEM  stellt  eine  Schnittstelle  zwischen  einer  Applikation  und  dem  An  wender.  Eine  Schnittstelle 
hat  einen  einheitlichen  Aufbau,  damit  es  zwischen  den  beiden  Partnem  nicht  zu  Verstandnis- 
schwierigkeiten  kommt.  Stellen  Sie  sich  mal  vor,  die  RS232-Schnittstelle  verhielte  sich  auf 
jedem  Rechner  anders!  Ebenso  muB  diese  “Software”-Schnittstelle  auch  auf  unterschiedlicher 
Hardware  gleich  sein.  Eine  saubere  GEM-Anwendung  sieht  auf  DOS-Rechnem  genauso  aus 
wie  auf  einem  Atari  TT.  Neben  der  Einhaltung  “auBerer”  Konventionen  sind  auch  “innere” 
zu  beachten.  Damit  ist  gemeint,  daB  eine  Anwendung  nicht  nur  mit  einem  bestimmten  Monitor 
oder  einer  bestimmten  Speicherkonfiguration  funktionstiichtig  ist.  Programme,  diehardwarenah 
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geschrieben  vvurden,  sollten  zumindest  darauf  achten,  daB  sie  mit  anderen  Konfigurationen 
nicht  abstiirzen  und  daB  die  “auBere”  Schnittstelle  eingehalten  wird. 


Mentis 

Die  Gestaltung  des  Menus  ist  eine  der  wichtigsten  Komponenten  eines  GEM-Programms, 
denn  die  Meniileiste  sieht  man  zuerst.  Man  kann  sagen,  daB  die  Meniileiste  die  Visitenkarte 
des  Programms  ist.  Auch  wenn  ein  Menu  (und  das  ganze  Programm)  den  Konventionen  ent- 
spricht,  so  muB  das  nicht  heiBen,  daB  es  damit  langweilig  werden  muB.  Auch  so  gibt  es  genug 
Freiraume  fur  pfiffige  und  durchdachte  Funktionen, 

Das  “Muskelgedachtnis”  spielt  eine  groBe  Rolle  bei  der  Gestaltung  des  Mentis.  Wer  ein  GEM- 
Programm  verlassen  will,  der  sucht  ein  Dateimenii  und  darin  den  untersten  Eintrag.  Eine 
Information  zum  Programm  vermutet  man  in  dem  Menu,  in  dem  auch  die  Accessories 
angewahlt  werden. 

Ein  Menu  besteht  aus  der  Meniileiste  mit  diversen  Titeleintragen  fur  die  jeweiligen  Drop- 
Down-Menus  (“Drop-Down”  wie  “herunterfallen”  im  Gegensatz  zu  “Pull-Down”  wie  “herun- 
terziehen”).  Jedes  einzelne  Drop-Down-Menii  enthalt  in  jeder  Zeile  einen  Eintrag. 

In  der  Meniizeile  befinden  sich  immer  die  Eintrage  “Datei”  und  der  Programmname  -  wie  bei 
den  PC-Versionen  (“DESK”  darf  sich  nur  das  Desktop  nennen!),  Der  Eintrag  mit  dem  Pro- 
grammnamen  (in  GroBbuchstaben)  steht  bei  Atari-GEM  ganz  links,  bei  PC-GEM  rechts  in  der 
Meniileiste.  Man  weiB  also  immer  sofort,  zu  welchem  Programm  die  Meniileiste  gehort  (unter 
einem  Multitasking-GEM  sehr  wichtig!). 

Abgesehen  von  diesem  Titel  ist  das  “Datei”-Menii  ganz  links  zu  finden.  “Datei”  und  die 
anderen  Titel  sind  immer  mit  einem  GroBbuchstaben  am  Anfang  gehalten  (Ausnahme:  Abkiir- 
zungen).  Jeder  Titel  besteht  aus  nur  einem  Wort  und  besitzt  als  Abgrenzung  zu  den  anderen 
Titeln  je  ein  Leerzeichen  rechts  und  links. 

Da  es  aber  nicht  nur  ein  Datei-  und  Informationsmenii  gibt,  haben  sich  weitere  Standardtitel 
eingebiirgert.  Ein  “Edit”-  bzw.  “Bearbeiten”-Menii  befindet  sich  -  sofem  vorhanden  -  rechts 
vom  “Datei”-Menii.  Ein  “Hilfe”-Menii  ist  ganz  rechts  einzuordnen  und  ein  “Parameter”-  oder 
“Optionen”-Menii  links  neben  dem  “Hilfe”-Menii.  Somit  sind  schon  insgesamt  fiinf  Titel 
vorbelegt.  Die  restlichen  Titel  (maximal  acht)  konnen  annahemd  frei  gesetzt  werden.  Auf 
verbreitete,  gute  Vorbilder  sollte  dabei  nach  Moglichkeit  Riicksicht  genommen  werden. 

Gerade  bei  den  Meniititeln  machen  sich  viele  Unsauberkeiten  breit.  Manch  ein  Menu  hat  schon 
mehr  als  zehn  Titel,  oder  die  Anzahl  der  Leerzeichen  rechts  und  links  von  einem  Titel  weicht 
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stark  von  den  Konventionen  ab.  Dabei  verlangem  unnotig  viele  viele  Leerzeichen  die  Wege, 
die  mit  dem  Mauszeiger  zuriickgelegt  werden  mtissen.  Auch  die  Schreibweise  der  Titel  ist 
nicht  immer  schon  (nur  GroBbuchstaben  oder  “Desk”  anstelle  des  Programmnamens). 

Die  Drop-Down-Menus  bestehen  aus  einzelnen  Eintragen  (jeweils  einer  pro  Zeile),  wobei 
ganz  rechts  ein  Tastaturkurzel  zu  finden  ist.  Diesem  Tastaturkiirzel  kann  neben  einem  alpha- 
numerischen  Zeichen  (Buchstaben,  Ziffem)  fiir  eine  Taste,  die  stellvertretend  fiir  den  Eintrag 
steht,  ein  besonderes  Zeichen  (links  von  dem  Buchstaben)  zugeordnet  werden.  Dieses  Zeichen 
ist  ein  Pfeil  nach  oben  (ASCII  1)  fiir  eine  der  Shift-Tasten,  eine  Raute  (ASCII  7)  fiir  die 
Alternate-Taste  oder  ein  “A”  (ASCII  94)  fiir  die  Control-Taste. 

Um  die  Funktion  zu  erreichen,  die  hinter  dem  Meniieintrag  steht,  ist  dann  die  jeweilige  Sonder- 
taste  in  Verbindung  mit  der  angegebenen  Taste  zu  driicken. 

Die  Tastenkurzel  werden  mit  mindestens  einem  Leerzeichen  vom  restlichen  Eintrag  abge- 
setzt.  Der  eigentliche  Eintrag  beginnt  immer  zwei  Zeichen  vom  linken  und  eines  vom  rechten 
Rand  entfemt,  um  Platz  genug  fiir  ein  Hakchen  zu  haben.  Dabei  ist  es  nicht  relevant,  ob  dort 
iiberhaupt  ein  Hakchen  plaziert  werden  soil. 

Das  Hakchen  stehtfiir  eine  aktivierte Funktion.  Solche  Meniieintragemit  “Umschaltcharakter” 
sollten  sparsam  eingesetzt  werden.  Bei  vielen  Einstellungen  ist  es  ratsam,  diese  in  einer 
Dialogbox  zusammenzufassen. 

Drei  Punkte  rechts  vom  Text  eines  Eintrags  sind  immer  dannhinzuzufiigen,  wenn  nach  einem 
Klick  auf  den  Eintrag  oder  nach  dem  Driicken  der  zugehorigen  T astenkombination  ein  Dialog 
folgt.  Eintrage,  die  nicht  selektiert  werden  diirfen,  werden  vom  Programm  automatisch  auf 
hell  -  DISABLED  -  gesetzt.  Dies  geschieht  auch  wahrend  des  Programmablaufs. 

Es  hat  ja  auch  wenig  Sinn,  “sichem”  anklicken  zu  diirfen,  wenn  nichts  zu  sichem  ist.  Sobald 
eine  Wahl  des  Eintrags  wieder  sinnvoll  ist,  wird  der  Status  DISABLED  zuriickgenommen. 

Eine  letzte  Form  der  Eintrage  sind  Separatoren.  Ein  Separator  ist  eine  durchgehende  Linie 
(eine  Reihe  einfacher  Bindestriche),  die  vom  linken  bis  zum  rechten  Rand  geht.  Hier  werden 
ausnahrnsweise  keine  Leerzeichen  am  linken  und  rechten  Rand  freigelassen.  Separatoren 
dienen  zur  Unterteilung  von  Eintragen  in  einem  Drop-Down-Menu.  Sie  fassen  mehrere 
EintrSge  optisch  zu  einer  Funktionsgruppe  zusammen. 

Jedes  Drop-Down-Menii  hat  seine  typischen  Eintrage.  So  hat  das  Menu  mit  dem  Programm- 
namen  den  Info-Eintrag. 

Daneben  findet  man  in  diesem  Menu  die  Eintrage  fiir  die  verschiedenen  Accessories. 
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Das  “Datei”-Menu  beinhaltet  als  untersten  Eintrag  (“Ende”)  immer  die  Moglichkeit,  das 
Programm  zu  verlassen.  Eine  Sicherheitsabfrage  vor  dem  Verlassen  eines  Programms  ist  nur 
dann  sinnvoll,  wenn  irgendwelche  Anderungen  an  einer  Datei  noch  nicht  gesichert  wurden! 

Die  anderen  Eintrage  befassen  sich  tatsachlich  mit  Dateien  und  lauten  von  oben  nach  unten 
“neu  anlegen”,  “offnen”,  “schlieBen”,  “sichern”,  “sichem  unter”,  “abbrechen”  und  “an 
Ausgabe”.  Hierbei  bedeutet  “neu  anlegen”,  daB  ein  Arbeitsbereich  fur  eine  neue  Arbeit  unter 
dem  Namen  ‘NAMENLOS  ’  angelegt  wird.  Beim  Abspeichem  ist  dann  ein  Name  zu  vergeben, 
da  eine  Datei  ohne  Namen  logischerweise  auf  dem  Massenspeicher  nicht  existieren  kann. 
“Sichem”  Oder  auch  “abbrechen”  sind  nach  Anwahl  dieses  Eintrags  sinnigerweise  gesperrt. 

Bei  “Offnen”  wird  eine  bereits  bestehende  Datei  iiber  eine  Dateiauswahlbox  ausgesucht  und 
geladen,  bei  “schlieBen”  wird  die  aktuell  bearbeitete  Datei  geschlossen,  ohne  gesichert  zu 
werden.  Jedoch  sollte  unbedingt  eine  Sicherheitsabfrage  erfolgen,  urn  Fehlbedienungen  aus- 
zuschlieBen. 

Das  Abspeichem  einer  Datei  wird  iiber  “sichem”  oder  “sichem  unter”  ermoglicht,  wobei  bei 
der  zweiten  Variante  iiber  eine  Dateiauswahlbox  ein  neuer  Dateiname  gewahlt  werden  kann. 
“Sichem”  kann  nur  dann  gewahlt  werden,  wenn  das  oberste  Fenster  ein  nicht-namenloses 
Dokument  enthalt.  Ist  eine  vorher  namenlose  Arbeit  iiber  “sichem  unter”  abgespeichert 
worden,  dann  ist  sie  fortan  nicht  mehr  ohne  Namen,  und  die  Eintrage  “sichem”  und  “abbre¬ 
chen”  konnen  freigegeben  werden. 

Die  Option  “sichem  unter”  lafit  sich  auch  hervorragend  dazu  einsetzen,  einen  selektierten 
Block  abzuspeichem.  Ist  ein  Block  gekennzeichnet,  so  fragt  die  Anwendung  nach,  ob  der 
gesamte  Text  oder  nur  der  Block  gesichert  werden  soil. 

“Letzte  Fassung”  setzt  alle  seit  dem  Offnen  der  Datei  gemachten  Anderungen  wieder  zuriick, 
gegebenfalls  durch  einfaches  Neuladen  der  Datei.  Klickt  man  auf  “an  Ausgabe”,  so  startet  das 
GEM-Ausgabeprogramm,  um  beispielsweise  den  Ausdruck  einer  Meta-Datei  zu  bewerk- 
stelligen.  Alierdings  kann  auch  die  Ausgabe  direkt  erfolgen. 

Eintrage  wie  “ausschneiden”,  “kopieren”,  “einfilgen”  oder  “Undo”  befinden  sich  im  Bearbei- 
ten-  bzw.  Edit-Menii. 

Unter  “Undo”  versteht  man  eine  Funktion,  die  die  letzte  Aktion  wieder  riickgangig  macht. 
“ausschneiden”  und  “kopieren”  (engl.  “cut”  und  “copy”)  bewirken,  daB  ein  gekennzeichneter 
Block  in  einen  intemen  Speicher  (oder  ins  Clipboard;  iiber  Parameter  einstellbar)  kopiert  wird. 
“ausschneiden”  beinhaltet  zusatzlich  das  Loschen  des  Blocks,  “einfugen”  bringt  den  gespei- 
cherten  Block  wieder  zuriick  in  den  Arbeitsbereich.  Die  drei  Grundfunktionen  ermoglichen 
das  Loschen  eines  Blocks  (in  den  Puffer  kopieren)  und  auch  das  Verschieben  (ausschneiden 
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und  an  anderer  Stelle  wieder  einfiigen),  womit  zahlreiche  Funktionen  uberfliissig  werden 
konnen.  Es  bleibt  den  Programmierem  iiberlassen,  weitere  sinnvolle  Funktionen  zu  erganzen. 

Das  “Parameter”-  Oder  “Optionen”-Menii  enthalt  Eintragc,  die  zu  weiteren  Funktionen  der 
Applikation  fiihren.  Die  Funktionen  erlauben  es  jedem  Anwender,  die  Applikation  den  eige- 
nen  Bediirfnissen  anzupassen  und  diese  Einstellungen  in  einer  Datei  (mit  der  Namenserwei- 
terung  “INF”)  zu  sichem. 

Eine  Hilfe  zu  einer  Applikation  kann  einerseits  iiber  die  Taste  “Help”  und  andererseits  iiber 
das  “Hilfe”-Menii  abgerufen  werden.  Hier  werden  zumeist  weitere  Dialoge  mit  diversen 
Hilfstexten  angezeigt.  Die  kleinen  Alertboxen  sollten  nicht  benutzt  werden,  da  sie  zu  wenig 
Informationsmbglichkeiten  bieten.  Auch  Eintragc  wie  “A  =  Control”  diirfen  nicht  aufgefuhrt 
werden,  da  sie  einerseits  einen  Eintrag  unnotig  belegen  und  andererseits  irrefiihrend  sind: 
obwohl  selektierbar,  wiirde  mit  ihnen  keine  Funktion  ausgelost  werden. 

Nun  zu  denProportionendes  Mentis.  Wie  schoneingangserwahnt,  sollten  maximal  acht  Drop- 
Down-Menus  vorhanden  sein.  Die  Titel  iiberschreiten  in  der  Regel  eine  Breite  von  etwa  12 
bis  1 6  Buchstaben  nicht.  In  jedem  Drop-Do  wn-Meniifindensichhochstens  lObis  12Eintrage 
inklusive  der  Separatoren.  Ein  Eintrag  ist  (mit  den  zwei  Leerzeichen  zu  Beginn  und  dem 
Tastenkiirzel  und  einem  Leerzeichen  am  Ende)  maximal  20  bis  25  Zeichen  breit. 
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Abb.  6.1:  Vorschldge  fur  vorbildliche  Menus 


Richtlinien  zur  Benutzerfiihrung  und  Programmierung 


753 


Dialoge 

Bei  der  Gestaltung  der  Dialogboxen  ist  auf  innere  und  auBere  Konsistenz  zu  achten.  Man 
orientiert  sich  an  vorbildlichen  Dialogboxen  anderer  Programme  (auBere  Konsistenz)  und 
achtet  darauf,  daB  innerhalb  einer  Anwendung  die  Dialogboxen  eine  einheitliche  Gestaltung 
haben  (innere  Konsistenz).  Zur  inneren  Konsistenz  gehort  zudem  noch,  daB  jede  Aktion  vor- 
hersehbar  ist  und  nicht  etwas  vollig  Unerwartetes  passiert. 

Die  Lage  der  Exit-Buttons  ist  durch  die  auBere  Konsistenz  bereits  nahezu  vorgegeben,  da  die 
Dateiauswahlbox  die  Exit-Buttons  rechts  unten  und  die  Alertboxen  die  Buttons  rechts  (PC- 
GEM)  oder  unten  ( Atari-GEM)  haben.  Eine  Plazierung  am  oberen  Oder  linken  Rand  sollte  also 
vermieden  werden.  Nach  Moglichkeit  sollten  die  Buttons  in  einer  Reihe  neben-  oder 
iibereinander  angeordnet  werden. 

Die  GroBen  der  Buttons  folgen  der  einfachen  Regel  “nicht  zu  groB  und  nicht  zu  klein”:  in  der 
Hohe  die  eineinhalbfache  Zeichenhohe  und  die  Breite  des  breitesten  Buttontexts  in  der  Dialog- 
box  nicht  wesentlich  iiberschreiten.  Der  breiteste  Button  ist  so  breit  wie  der  Text,  der  in  dem 
Button  steht,  zuziiglich  einem  Leerzeichen  am  rechten  und  linken  Rand,  also  maximal  Text- 
breite  plus  zwei  (Ausnahme:  ein  “pathologischer”  Fall  wie  “OK”). 

Als  Standard-Exit-Buttons  sind  nahezu  immer  die  Buttons  “OK”  und  “Abbruch”  zu  finden,wobei 
“OK”  eine  Einstellung  oder  die  Kenntnisnahme  von  einer  Meldung  bestatigt  und  “Abbruch” 
die  in  diesem  Dialogschritt  gemachten  Anderungen  ignoriert.  Statt  des  “OK”-Buttons  findet 
man  auch  vielfach  Buttons,  die  mit  einer  bestimmten  Aktion  wie  zum  Beispiel  “kopieren” 
gekennzeichnet  sind.  Damit  die  innere  Konsistenz  gewahrt  bleibt,  werden  “OK”  und  “Ab¬ 
bruch”  immer  an  den  gleichen  Stellen  plaziert.  Weitere  Standard-Buttons  existieren  nicht. 
Aber  auch  unabhangig  von  der  Lage  diverser  Objekte  innerhalb  einer  Dialogbox  existieren 
Regeln  fur  die  Anwendung  eben  dieser  Objekte,  damit  die  Bedienung  einheitlich  ist  und  sich 
jeder  Anwender  sofort  zurechtfindet. 

GEM  erlaubtes,  Objekttypen  wie  Boxen  (Rechtecke),  Texte  (veranderbar  und  nicht  verander- 
bar),  Bilder  (Images  und  Icons)  sowie  Misehformen  daraus  (Texte  in  Rechtecken:  Boxtext, 
Button,  Boxchar, ...)  zu  verwenden.  Sollte  dies  noch  immer  nicht  reichen,  so  wird  die  Typen- 
vielfalt  mit  benutzerdefinierten  Objekten  erganzt.  Alle  diese  Typen  konnen  mit  diversen 
Eigenschaften  wie  “wahlbar”  oder  “Ausgang”  und  Status  wie  “abgehakt”  oder  “gesperrt”  ver- 
sehen  werden. 

Ausgang-Buttons  (Flag  EXIT)  befmden  sich  immer  dort,  wo  auch  “OK”  und  “Abbruch”  zu 
finden  sind,  Diese  Buttons  sind  mit  dem  Flag  EXIT  zu  versehen.  Bei  anderen  sollte  das  EXIT- 
Flag  nur  dann  gesetzt  werden,  wenn  damit  der  Dialog  nicht  beendet  wird.  Das  Flag  DEFAULT 
(altemativ  mit  der  Taste  “Return”  zu  bedienen)  darf  nur  dann  gesetzt  werden,  wenn  damit 
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keine  irreversible  Funktion  -  wie  das  Formatieren  einer  Diskette  -  aktiviert  wird.  Bei  nicht 
umkehrbaren  Aktionen  sollten  generell  (iiber  eine  Option  absehaltbare)  Sicherheitsabfragen 
erscheinen, 

Gespeut  (Status  DISABLED)  sind  alle  Objekte,  die  bei  dem  betreffenden  Dialogschritt  nicht 
gewahlt  werden  diirfen.  Versteckt  (Flag  HIDETREE)  werden  die  Objekte,  die  zu  einem  gewis- 
sen  Zeitpunkt  nicht  notig  sind  und  nur  storend  wirken  wiirden.  Beispielsweise  ist  ein  Hinweis 
auf  eine  Abbruchmoglichkeit  eines  Kopiervorgangs  dann  nicht  notig,  wenn  gar  kein  Kopier- 
vorgang  im  Gange  ist.  Der  Status  SELECTED  signalisiert,  daB  eine  bestimmte  Wahl  getroffen 
wurde  oder  eine  Aktion  aktiv  ist.  Daher  darf  dieser  Status  nicht  an  anderer  Stelle  (beispiels¬ 
weise  fiir  Dialogtitel)  verwendet  werden. 

Texte  dienen  auf  der  einen  Seite  der  Information,  und  auf  der  anderen  Seite  ermoglichen  sie 
eine  Aus  wahl  -  z.  B .  bei  den  Dateinamen  in  der  Dateiauswahlbox.  Stehen  diese  Informations- 
texte  als  Beschreibung  in  einem  Dialog  wie  “GroBe:”,  “Datum:”,  dann  stehen  die  Doppelpunk- 
te  untereinander,  und  die  Texte  sind  beziiglich  dieser  durch  die  Doppelpunkte  vorgegebenen 
Linie  rechtsbiindig  ausgerichtet.  Bei  linksbiindigen  Texten  kann  es  zu  zu  groBen  Abstanden 
kommen,  wodurch  der  Zusammenhang  verlorengeht. 

Bilder  -  Sie  kennen  den  Spruch  “ein  Bild  sagt  mehr  als  1000  Worte”?  -  werden  als  Hinweis- 
erklarung  Oder  Abkiirzung  benutzt,  miissen  aber  verstandlich  bleiben.  Ihr  Einsatz  kann  bei 
ungeschickter  Wahl  der  Symbole  leicht  zu  Verwirrung  fiihren  -  wer  verbindet  schon  einen 
Zauberhut  mit  einer  Loschfunktion? 

Ein  besonderes  Kapitel  sind  Objekte  mit  den  Flags  SELECTABLE  und  RBUTTON  (Radio- 
knopf).  Diese  Flags  lassen  sich  prinzipiell  fiir  jedes  Objekt  benutzen.  Schwierig  wird  es,  wenn 
zu  unterscheiden  ist,  ob  ein  Objekt  nun  wahlbar  ist  oder  nicht.  Dies  muB  aus  der  Gestaltung 
der  Dialogbox  klar  hervorgehen! 

Einfache,  langere  Texte  oder  Bilder  werden  nicht  als  Radioknopfe  installiert.  Diese  Moglich- 
keit  bleibt  einfachen  Rechtecken,  Zeichen  in  Rechtecken  oder  kurzen  Texten  wie  “ja”  oder 
“nein”  vorbehalten.  Ein  Rechteck  ist  ein  gutes  Signal  dafiir,  daB  ein  wahlbares  Feld  oder  ein 
Radioknopf  vorliegt,  wobei  hier  bei  der  Gestaltung  der  Dialogbox  darauf  geachtet  werden 
muB,  daB  derartige  Objekte  nicht  mit  Exit-Buttons  verwechselt  werden  konnen.  Der  wohl 
beste  Weg  fiir  Radioknopfe  ist,  zusammengehorige  in  einem  groBen  Rechteck  unter-  oder 
nebeneinander  zusammenzufassen  oder  spezielle  Felder  (wie  bei  Formularen)  vor  Texten 
dafiir  vorzusehen.  Einfach  wahlbare  Objekte  lassen  sich  prima  darstellen,  wenn  vor  einem 
Text  ein  kleines  Rechteck  zu  sehen  ist,  welches  “angekreuzt”  werden  kann.  Allerdings  ist  dies 
nur  iiber  selbst  definierte  Objekte  moglich. 

So  vielfaltig  die  Status  sein  mogen,  sie  sind  sparsam  -  weniger  ist  mehr!  -  zu  verwenden. 
Auch  von  der  Verwendung  verschiedener  Fiillmuster  sollte  man  Abstand  nehmen,  denn 
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gerade  die  kontrastreichen  Muster  lenken  Anwender  nur  von  den  eigentlichen  Funktionen  und 
Einstellungen  ab.  Neben  der  Moglichkeit,  Objekte  in  einfacher  Form  zu  gruppieren,  gibt  es 
eine  weitere,  um  komplexe  Objekte  aufzubauen. 

Als  Beispiel  seien  hier  Listbox  (wie  in  der  GEM-Dateiauswahlbox)  und  Popup-Menus  (wie 
in  XControl)  genannt. 

Letztlich  die  Farben:  Sie  lockem  die  Dialogbox  auf,  lenken  jedoch  stark  ab,  wenn  eine  Dialog- 
box  zu  bunt  gestaltet  ist.  Fiir  Texte  wird  in  der  Regel  schwarz  gewahlt,  Wamungen  licften  sich 
rot  darstellen.  Insgesamt  sollten  Farben  sehr  sparsam  verwandt  werden! 


Werkzeugleiste 

Reichen  Menus  und  Dialoge  fiir  die  Zugriffsmoglichkeiten  auf  die  Funktionen  eines  Pro- 
gramms  nicht  aus,  so  erganzen  zusatzliche  Fenstermeniis  oder  Popup-Menus  die  Anwendung. 
Die  zusatzlichen  Kontrollelemente  finden  in  der  Regel  im  rechten  Randbereich  eines  Fensters 
ihren  Platz. 
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Abb.  6.3:  Ein  Fenster  mit  Werkzeugleiste 


Es  hat  sich  eingebiirgert,  diese  Menus  mit  Bildsymbolen  zu  gestalten.  Je  nach  Anwendung 
verbergen  sich  hinterden  Icons  weitere  Popup-Menus  (“RCS”)  Oder  “Schaiter”  zwischen  ver- 
schiedenen  Betriebsmodi  (“SciGraph”). 


Maus  und  Mauszeiger 

Sie  werden  sich  sicherlich  fragen,  weshalb  man  sich  mit  so  unscheinbaren  GEM-EIementen 
wie  dem  Mauszeiger  befassen  kann.  Aber  auch  der  Mauszeiger  hat  je  nach  Form  feste  Bedeu- 
tungen. 

Ein  Einfachklick  dientder  Auswahl  bestimmter  Elemente  (Radioknopfe,  Icons)  Oder  dem  Zei- 
gen  auf  diese,  ein  Doppelklick  leitet  eine  spezielle  Funktion  ein  (Offnen  eines  Fensters  nach 
einem  Doppelklick  auf  ein  Icon).  Nach  einem  Einfachklick  kann  in  der  Regel  eine  weitere 
Aktion  ausgelost  werden,  wie  zum  Beispiel  das  Andem  der  Farbe  eines  Grafikobjekts.  Prinzi- 
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piell  ist  neben  dem  Einfach-  und  Doppelklick  auch  ein  Drei-  oder  Vierfachklick  moglich.  Da 
die  Ausfiihrung  eines  Drei-  oder  Vierfachklicks  den  meisten  Anwendem  erhebliche  Schwie- 
rigkeiten  bereiten  dtirfte,  ist  diese  Form  des  Mausklicks  wenn  iiberhaupt  nur  optional  zu 
verwenden. 

Aus  der  Einfachklickmoglichkeitergibt  sich  ein  weiteres  Bedienungselement.  LaBtman  nam- 
lich  die  Maustaste  nicht  sofort  los,  sondem  halt  sie  gedriickt,  so  konnen  ausgewahlte  Objekte 
verschoben  oder  eine  Gruppe  von  Objekten  angewahlt  werden. 

Diese  Moglichkeit  wird  beispielsweise  vom  Desktop  ausgenutzt,  um  mehrere  Dateien  selek- 
tieren  zu  kdnnen  oder  Laufwerkssymbole  zu  verschieben.  Aber  auch  Grafikprogramme  nut- 
zen  den  Klick  mit  Festhalten,  beispielsweise,  um  Linien  zu  ziehen. 

In  Verbindung  mit  den  Tasten  “Alternate”,  “Control”  oder  “Shift”  ergeben  sich  weitere  Mog- 
lichkeiten  der  Mausbenutzung,  wobei  diese  Bedienungselemente  nicht  a  priori  klar  sind.  tib- 
lich  ist,  dali  in  Verbindung  mit  einer  Shift-Taste  weitere  Objekte  (auch  unter  Verwendung  der 
Rubberbox)  ausgewahlt  werden  konnen  (“Erweitem  der  Auswahl”).  Die  Form  bzw,  Darstel- 
lungsart  des  Mauszeigers  ist  je  nach  Funktion,  die  gerade  ausgeiibt  werden  soli,  unterschied- 
lich: 


Darstellungsart 

Funktion 

Pfeil: 

allgemeine  Bedienung  (Regelfall) 

Balken: 

Texteingabe 

Biene  bzw.  Sanduhr: 

der  Rechner  ist  beschaftigt,  z.  B.  mit  Speichem  einer  Datei 

Zeigefinger: 

Auswahl  oder  Dimensionierung 

flache  Hand: 

Verschieben  von  Objekten,  Positionierung 

Fadenkreuz,  diinn: 

Zeichnen  oder  Auswahl 

Fadenkreuz,  dick: 

keine  feste  Bedeutung 

Fadenkreuz,  UmriB: 

keine  feste  Bedeutung 

unsichtbar: 

bei  Zeichenoperationen,  wenn  der  Mauszeiger  stort,  oder  bei 
Rasterkopie 

sichtbar: 

eigentlich  immer,  wenn  er  nicht  gerade  zum  Zeichnen 
abgeschaltet  ist 

Unabhangig  von  der  Moglichkeit,  den  Mauszeiger  an-  und  abschalten  zu  kdnnen,  sollte  der 
Mauszeiger  immer  sichtbar  sein. 

Auch  bei  langwierigen  Operationen  wie  dem  Kopieren  von  Disketten  bleibt  der  Mauszeiger 
-  als  Biene  bzw.  Sanduhr  -  sichtbar! 


758 


ATARI  Profibuch 


Tastaturbelegung 

Die  Finger  “gewohnen”  sich  nur  langsam  an  die  Lage  der  einzelnen  Tasten  auf  der  Tastatur 
-  wer  haufig  zwischen  Rechnem  mit  deutscher  und  amerikanischer  Tastaturbelegung  wech- 
seln  muB,  kennt  das  Problem.  Gleiches  gilt  natiirlich  fiir  Befehlstasten-Kombinationen,  mit 
denen  Standardfunktionen  aufgerufen  werden.  Daher  ist  eine  Normierung  zumindest  der 
wichtigsten  Shortcuts  unbedingtnotig.  Die  aufgelisteten  Tastenkombinationen  sollen  verdeut- 
lichen,  was  sich  bisher  eingebiirgert  hat  und  somit  als  Quasistandard  anzusehen  ist. 

Genormt  laut  BeschluB  der  Entwicklerkonferenz  vom  August  1989: 


Tastenbelegung 

Funktion 

Ctrl-C 

kopieren  (“copy”) 

Ctrl-F 

suchen  (“find”) 

Ctrl-O 

offnen  (“open”) 

Ctrl-Q 

Programm  beenden  (“quit”) 

Ctrl-V 

einfiigen  (“paste”) 

Ctrl-X 

ausschneiden  (“cut”) 

Shift-“Pfeil  oben” 

eine  Seite  zuriickblattcm 

Shift-“Pfeil  unten” 

eine  Seite  vorwartsblattern 

Shift-“Pfeil  links” 

Einfiigemarke  zum  Zeilenbeginn 

Shift-“Pfeil  rechts” 

Einfilgemarke  zum  Zeilenende 

Ctrl-“Pfeil  links” 

urn  ein  Wort  zuriick 

Ctrl-“Pfeil  rechts” 

um  ein  Wort  vorwarts 

Home 

Dokumentanfang 

Shift-Home  (Clr) 

Dokumentende 

Weitere  ilbliche  Tastenkombinationen: 


Tastenbelegung 

Funktion 

Ctrl-A 

alles  auswahlen 

Ctrl-G 

nachste  Fundstelle 

Ctrl-M 

Sichem  unter... 

Ctrl-N 

Neues  Dokument 

Ctrl-P 

Drucken 

Ctrl-S 

Sichem 

Ctrl-R 

Ersetzen 

Ctrl-U 

Oberstes  Fenster  schlieBen 
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Tastenbelegung 

Funktion 

Ctrl-W 

zum  nachsten  Fenster  blattem 

Ctrl-Y 

aktuelle  Zeile  ausschneiden 

Ctrl-Z 

Shell  starten 

Wer  schon  einmal  an  einerenglischen  Tastatur  gesessen  hat,  der  kennt  die  Probleme,  die  sich 
aus  der  Vertauschung  der  Tasten  Y  und  Z  ergeben.  Aber  nicht  nur  bei  den  iiblichen  Buch- 
staben-Tasten  spielt  die  Gewohnheit  eine  groBe  Rolle:  Auch  bei  Tastenkombinationen  fur 
Befehle  spielt  die  Gewohnung  eine  sehr  grofie  Rolle.  Urn  Problemen  mit  unterschiedlichen 
Scancodes  aus  dem  Wege  zu  gehen,  empfiehlt  es  sich,  nach  Moglichkeit  immer  den  ASCII- 
Code  des  Zeichens  zu  benutzen.  Fur  Tastenkombinationen  mit  “Alternate”  kann  man  die 
XBIOS-Funktion  “KeytblO”  zu  Rate  ziehen.  Eine  kleine  Routine  nach  einer  Vorlage  von  Ken 
Badertscher  zur  unabhangigen  Auswertung  der  Tastatur: 

/*  Bits  zur  Kennzeichnung  der  Shift-Status  */ 


#define  KsCAPS  0x10 
#define  KsALT  0x08 
#define  KsCONTROL  0x04 
#define  Ks SHIFT  0x03 
#define  KsLSHIFT  0x02 
#define  KsRSHIFT  0x01 


/* 

*  Masken  fur  die  Status-Bits,  die  im  oberen  Byte  des  von  MapKey 

*  zuruckgegebenen  Words  plaziert  sind 
*/ 


#define  KbSCAN 

0x8000 

fdefine  KbNUM 

0x4000 

#define  KbALT 

0x0800 

# define  KbCONTROL 

0x0400 

#define  KbSHIFT 

0x0300 

tdefine  KbLSHIFT 

0x0200 

# define  KbRSHIFT 

0x0100 

/*  Scan-Codes  fur  die 

Tasten,  deren  ASCII-Code  0  ist  * / 

/* 

*  ISO  Taste  (erscheint,  wenn  ein  Nicht -US -Keyboard  mit  US  TOS 

*  benutzt  wird) 

*/ 

fdefine  KbISO  0x37 
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/*  Funktionstasten  */ 

#define  KbFl 

0x3b 

tdefine  KbF2 

0x3c 

tdefine  KbF3 

0x3d 

#define  KbF4 

0x3e 

#define  KbF5 

0x3f 

tdefine  KbF6 

0x40 

idefine  KbF7 

0x41 

tdefine  KbF8 

0x42 

tdefine  KbF9 

0x43 

tdefine  KbFIO 

0x44 

/*  Shift -Funktionstasten  */ 

tdefine  KbFll 

0x54 

tdefine  KbF12 

0x55 

tdefine  KbF13 

0x56 

tdefine  KbFl 4 

0x57 

tdefine  KbF15 

0x58 

tdefine  KbF16 

0x59 

tdefine  KbF17 

0x5a 

tdefine  KbFl 8 

0x5b 

tdefine  KbFl 9 

0x5c 

tdefine  KbF20 

0x5d 

/*  Cursor-Bereich  */ 

tdefine  KbUNDO 

0x61 

tdefine  KbHELP 

0x62 

tdefine  KbINSERT 

0x52 

tdefine  KbHOME 

0x47 

tdefine  KbUP 

0x48 

tdefine  KbDOWN 

0x50 

tdefine  KbLEFT 

0x4b 

tdefine  KbRIGHT 

0x4  d 

/*  Alternate-numerische 

Taste  */ 

tdefine  KbAltl 

0x78 

tdefine  KbAlt2 

0x79 

tdefine  KbAlt3 

0x7a 

tdefine  KbAlt4 

0x7b 

tdefine  KbAlt5 

0x7  c 

tdefine  KbAlt6 

0x7  d 

tdefine  KbAlt? 

0x7e 
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♦define  KbAlt8  0x7 f 

♦define  KbAlt9  0x80 

♦define  KbAltO  0x81 

typedef  struct 

{ 

char  *unshift; 
char  * shift; 
char  *caps; 

}  KEY'TABLE; 

KEYTABLE  *kt; 

/*  Andert  eine  VDI-Taste  (Riickgabewert  von  evnt_keybd ( ) ) 
zu  einem  Word-groBen,  codierten  Zeichen: 

Highbyte  Lowbyte 

-  ACLR  sind  Shift-Status-Bits 

SxxxACLR  CHARCODE  =  ASCII  (S  =  0)-  Oder  Scan  (S  =  I) -Code 

Mit  dieser  Funktion  wird  das  diffizile  Problem  der  internatio- 
nalen  Tastaturen  und  der  Umwandlung  der  landerspezifischen  VDI- 
Tasten  in  unabhangige  ASCII-  oder  Scan-Codes  gelost..  */ 

WORD  MapKey  (WORD  key) 

{ 

WORD  key state,  scancode,  ret; 

/*  Ermittlung  der  Tastaturtabellen,  falls  noch  nicht 
geschehen  */ 
if  (!kt) 

kt  =  (KEYTABLE  *)Keytbl  ((VOID*)  -1L,  (VOID*)  -1L, 

(VOID*)  -1L); 

/*  Feststellung  des  Scan-Codes  und  der  Shift-Status 

(ohne  die  Shift-Status  von  evnt__multi  oder  grafjnkstate)  */ 
scancode  =  (key  »  8)  &  OxFF; 
keystate  =  (WORD)  Kbshift  (-1) ; 

/*  Prufung  des  ASCII-Codes  mit  der  geeigneten  Tabelle  */ 

/*  Anpassung  der  Alternate-numerischen  Tasten  */ 
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if  ( (key state  &  KsALT)  &&  (scancode  >=  0x78) 

&&  (scancode  <=  0x83)) 
scancode  -=  0x76; 
if  (keystate  &  KsCAPS) 

{ 

ret  =  kt->caps [scancode] ; 

} 

else 

{ 

if  (keystate  &  KsSHIFT)  /*  Shift-Funktionstasten  haben 

korrespondierende  Scan-Codes  */ 
ret  =  kt->shift [( (scancode  >=  KbFll)  && 

(scancode  <=  KbF20) ) ?  scancode  -  0x19; scancode] ; 

else 

ret  =  kt->unshift [scancode] ; 

} 


/*  Ruckgabe  der  Scancodes,  zu  denen  es  keinen  ASCI I -Code  gibt, 
und  Kennzeichnung  der  numerischen  Tastatur  */ 
if  ( ! ret ) 

ret  =  scancode  |  KbSCAN; 

else  if  ( (scancode  ==  0x4a)  | |  (scancode  ==  0x4e)  | | 

( (scancode  >=  0x63)  &&  (scancode  <=  0x72) ) ) 
ret  |=  KbNUM; 

return  (ret  I  (keystate  «  8) ) ; 

} 


Selektion 

Wie  man  Objekte  auswahlt,  macht  das  Desktop  bereits  vor:  einzelne  Objekte  durch  einfaches 
Anklicken,  mehrere  Objekte  durch  Shift-Kliek  oder  die  Rubberbox.  Eine  spezielle  Methode 
zum  Auswahlen  ist  das  “Echtzeit”-Selektieren. 

Viele  Programme,  wie  “Wordplus”,  “Edison”  oder  “Turbo  C”  verfolgen  dieses  Verfahren. 
Kempunkt  ist,  daB  der  aktuell  ausgewahlte  Block  bereits  wahrend  der  Mausbewegung  inver- 
tiert  wird  (um  so  besser,  wenn  beim  Erreichen  des  Fensterrandes  auch  automatisch  gescrollt 
wird).  Weitere  Varianten  erlauben  das  wortweiseMarkieren  (Markiervorgang  mit  einem  Dop- 
pelklick  beginnen)  und  vieles  mehr. 
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Bei  Programmer!,  die  diese  ini  “Inside  Macintosh”  beschriebene  Methode  konsequent  nutzen, 
gibt  es  immer  nur  einen  Block  oder  eine  Einfugemarke  -  nie  aber  beides  gleichzeitig.  Das  ist 
kein  Fehler,  sondem  ist  im  Konzept  dieses  Mechanismus  begriindet:  Alles  dreht  sich  um  die 
aktuelle  “Selektion”  (damit  ist  der  gerade  markierte  Block  gemeint).  Der  Cursor  (besser:  die 
Einfugemarke)  ist  nur  ein  Sonderfall  eines  Blocks  (namlich  einer  mit  der  Lange  Null). 

Audi  beim  Einfiigen  gibt  es  keine  Unterscheidung  zwischen  Blocken  und  einzelnen  Zeichen 
(ein  Zeichen  ist  eben  ein  Block  der  Lange  Eins).  Der  einzufiigende  Block  wird  immer  anstelle 
des  gerade  selektierten  Blocks  eingesetzt.  AnschlieBend  erscheint  die  Einfugemarke  (also  der 
“leere”  Block)  rechts  des  eingefiigten  Blocks.  Das  gesamte  Macintosh-Blockkonzept  beruht 
somit  auf  dem  Einfiigen  und  Entfemen  von  Blocken:  Gute  Ideen  erkennt  man  daran,  daB  sie 
einfach  sind! 

Einige  “Blocke”,  die  man  einfiigt,  haben  natiirlich  besondere  Funktionen.  “Backspace”  und 
“Delete”  lbschen  den  selektierten  Block.  Falls  nichts  selektiert  ist,  wird  vorher  entweder  das 
Zeichen  rechts  oder  links  der  Einfugemarke  selektiert.  Ahnlich  intuitiv  sind  auch  andere 
Funktionen  wie  das  Finden  von  Textstellen  (der  gefundene  Text  wird  zum  aktuell  selektierten 
Block  und  kann  damit  direkt  iiberschrieben  werden)  oder  das  Loschen  von  Zeilen  (aktuelle 
Zeile  als  Block  markieren  und  dann  ausschneiden).  Und  in  diesem  Zusammenhang  werden 
auch  die  einzelnen  Meniipunkte  des  “Edit”~Meniis  leicht  verstandlich.  “Ausschneiden”  ent- 
femt  den  aktuellen  Block  und  kopieit  ihn  in  die  “Zwischenablage”,  einen  intemen  Puffer. 
“Kopieren”  kopiert  den  selektierten  Block  in  die  “Zwischenablage”,  ohne  ihn  zu  loschen. 
“Einfiigen”  fiigt  denmomentanen  Inhalt  der  Zwischenablage  in  das  Dokument  ein.  “Loschen” 
loscht  den  aktuellen  Block,  “Alles  auswahlen”  selektiert  alle  Objekte  im  Dokument.  “Undo” 
schlieBlich  macht  die  letzte  Blockoperation  riickgangig. 

Die  Zwischenablage  enthalt  immer  nur  den  zuletzt  hineinkopierten  Block.  Viele  Programme 
erlauben  es,  beim  Ausschneiden  und  Kopieren  durch  Festhalten  der  Shift-Taste  den  Block  an 
den  Inhalt  der  Zwischenablage  anzuhangen,  statt  ihn  zu  ersetzen.  Ob  die  Zwischenablage  nun 
als  programmintemer  Puffer  oder  direkt  liber  das  GEM-Klemmbrett  (siehe  Beschreibung  der 
Scrap-Funktionen)  verwirklicht  wird,  ist  zunachst  egal.  Falls  nicht  sowieso  das  GEM- 
Klemmbrett  (also  der  Weg  iiber  Dateien  im  Scrap-Verzeichnis)  benutzt  wird  -  die  heutigen 
schnellen  Festplatten  machen  das  ja  ohne  weiteres  moglich  -  sollte  man  diesen  Weg  zumin- 
dest  als  Option  anbieten.  “SciGraph”  beispielsweise  bietet  fur  diese  Umschaltung  den  Menii- 
punkt  “Klemmbrett  benutzen”  an. 


Feedback 

Feedback  bedeutet:  dem  Anwender  Informationen  iiber  die  ablaufenden  Arbeitsschritte 
geben.  Ein  derartiges  Feedback  laBt  sich  auf  vielerlei  Art  und  Weise  erreichen.  Dazu  gehort, 
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daB  Menutitel  wahrend  der  gesamten  Ausfiihrung  einer  Funktion,  die  einem  Eintrag  in  diesem 
Menu  zuzuordnen  ist,  invers  dargestellt  bleiben.  Auch  die  wachsenden  und  schrumpfenden 
Rechtecke  vor  bzw.  nach  einem  Dialog  stellen  eine  Methode  des  Feedback  dar  und  sind  beson- 
ders  dann  ntitzlich,  wenn  per  Tastaturshortcut  auf  ein  selektiertes  Objekt  zugegriffen  wird. 

Die  Form  des  Mauszeigers  signalisiert,  was  gerade  zu  erledigen  ist.  Dauert  die  Ausfiihrung 
einer  Funktion  langer  an,  so  hat  der  Mauszeiger  die  Form  einer  Biene.  Befindet  sich  der 
Mauszeiger  iiber  einem  Texteingabefeld,  so  wird  er  als  gesplitteter  Balken  dargestellt. 

Bei  langeren  Vorgangen  wie  dem  Kopieren  von  Dateien  oder  dem  Formatieren  von  Disketten 
signalisiert  eine  Dialogbox,  welche  Datei  gerade  kopiert  wird  oder  wie  weit  der  Formatier- 
vorgang  fortgeschritten  ist.  Diese  Anzeige  ist  nach  Moglichkeit  grafisch  zu  gestalten. 


AHgemeine  Regeln 

Die  Bedeutung  und  Anwendung  wichtigerGEM-Komponenten  wurde  bereits  angesprochen. 
Nicht  nur  der  korrekte  Einsatz  der  Komponenten,  sondem  auch  das  Zusammenspiel  ist  eine 
Herausforderung  an  den  Programmierer.  GEM  wurde  unter  anderem  deshalb  geschaffen,  um 
den  Menschen,  der  an  der  Maschine  sitzt,  nicht  von  der  eigentlichen  Aufgabe  abzulenken.  Wer 
einen  Brief  schreibt,  will  nicht  erst  zahlreiche  Kommandos  erlemen. 

Auch  die  Kommandoebene,  die  ein  Erlemen  der  Kommandos  erfordert,  soli  einleuchtend 
gestaltet  sein.  Es  ist  eben  einfacher,  ein  Dateisymbol  auf  ein  Laufwerk  zu  ziehen,  um  eine 
Datei  zu  kopieren,  als  “COPY  A:\DATEI.XYZ  B :  \ORDNER\”  einzugeben. 

GEM  bietet  die  Moglichkeit,  mit  Bildem  in  Form  von  Icons  die  Arbeit  zu  erleichtem.  Zudem 
ermoglichen  die  vielseitigen  Ausgabefunktionen,  das  WYSIWYG-Prinzip  (What  You  See  Is 
What  You  Get)  einzuhalten,  Bei  einer  Textverarbeitung  lassen  sich  z.  B.  Buchstaben,  die  auf 
dem  Papier  fett  dargestellt  werden,  auch  schon  auf  dem  Bildschirm  in  fetter  Schrift  darstellen. 
GEM-Programme  miissen  immer  so  geartet  sein,  daB  einem  An  wender  sofortklar  ist,  was  etwa 
nach  einem  Klick  auf  einen  Meniipunkt  geschieht. 

Auch  irreversible  Eingriffe  diirfen  erst  gar  nicht  entstehen  oder  benotigen  zumindest  eine 
Sicherheitsabfrage. 

Jede  Komponente  des  GEM  (Mentis,  Dialoge,  Fenster)  hat  seine  feste  Bedeutung.  Programme 
lassen  sich  leichter  bedienen,  wenn  es  bei  der  Gestaltung  der  Oberflache  nicht  zu  Widersprii- 
chen  kommt.  Die  korrekte  Ausnutzung  dieser  Komponenten  gehort  zu  jedem  GEM-Pro- 
gramm.  Selbstgestrickte  Mentis,  Dialoge  und  Fenster,  die  auf  den  ersten  Blick  schon  oder 
“modem”  erscheinen  mogen,  erschweren  den  Menschen  vor  der  Maschine  Computer  nur  die 
Arbeit  und  schrecken  auf  Dauer  ab. 
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Programmtechnisches 


Einleitung 

Um  es  vorwegzunehmen:  In  diesem  Kapitel  soil  kein  vollstandiges  GEM-Programm  mit 
Menii-,  Dialog-  und  Fensterverwaltung  entwickelt  werden.  Ein  derartiges  Beispielprogramm 
wiirde  zu  lang  und  konnte  nicht  allgemein  genug  gehalten  werden.  Das  Hauptaugenmerk  liegt 
vielmehr  auf  einigen  Anregungen  und  Tips,  die  bei  der  Programmierung  unter  GEM  Beach- 
tung  finden  sollten. 


Ein  Rahmen  programm 

Programmierung  unter  GEM  setzt  die  Kenntnis  der  Funktiorien  und  Strukturen  voraus, 
Feinheiten  wie  die  Parameter  der  einzelnen  Funktionen  sind  jedoch  nicht  unbedingt  notig.  Nur 
wer  die  Funktionen  kennt  und  weiB,  wie  und  wann  sie  eingesetzt  werden,  kann  sichere  GEM- 
Programme  schreiben.  Bevor  Sie  also  zur  Programmierung  schreiten,  lesen  Sie  die  Kapitel  mit 
den  AES-Funktionen  einmal  -  zumindest  diagonal  -  und  informieren  Sie  sich,  was  das  VDI 
alles  zu  bieten  hat.  Schenken  Sie  beim  VDI  den  Auskunftsfunktionen  besonderes  Augenmerk ! 

Die  Basis  fur  alle  GEM-Programme  ist  die  An-  und  Abmeldung  beim  AES.  Hierzu  finden  die 
Funktionen  “appl  Jnit()”  und  “appLexitO”  Verwendung.  Die  folgenden  Programme  in C  und 
Modula-2  zeigen,  wie  der  Minimalrahmen  fur  ein  Programm  auszusehen  hat: 

1.  C-Programm: 

fincTude  <aes.h> 
tinclude  <portab.h> 

WORD  apl__id; 

void  main  (void) 

{ 

if  ( (apl_id  =  appl_init () )  >=  0) 

{ 

/*  hier  kommt  das  eigentliche  Programm. . .  */ 
appl_exit ( )  ; 

1 

} 
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2.  Modula-2 -Programm: 

MODULE  Programm; 

FROM  AES  IMPORT  Appllnit,  ApplExit; 

VAR  Aplld  :  INTEGER; 

BEGIN 

Aplld  :=  Appllnit  () ; 

IF  Aplld  >=  0 
THEN 

(*  hier  kommt  das  eigentliche  Programm. . .  *) 

ApplExit { ) 

END 

END  Programm. 

Diesen  Minimalrahmen  erganzt  bei  einem  Accessory  ein  Aufruf  der  Funktion  “menu_register()” 
(fur  den  Eintrag  im  ersten  Drop-Down-Menii).  In  diesem  Zusammenhang  sei  darauf  verwie- 
sen,  daB  man  mit  keiner  GEM-Funktion  abfragen  kann,  ob  eine  ausfiihrbare  Datei  als  Accesso¬ 
ry  Oder  Programm  gestartet  wurde.  Funktionen  wie  “AccessoryO”  bei  Megamax  Modula-2 
Oder  Variablen  wie  “„app”  bei  Turbo  C  gehoren  nicht  zum  GEM,  aber  es  ist  von  Atari  doku- 
mentiert,  wie  man  solche  Informationen  ermittelt  (siehe  AES-Einleitung). 

Da  Accessories  GEM-typisch  ereignisorientiert  sind,  erzwingt  dies  eine  Verwendung  von 
“evnt_mesag()”  oder  “evnt_multi()”.  Der  Aufruf  der  Funktion  “appl_exit()”  entfallt,  da 
Accessories  unter  keinen  Umstanden  verlassen  werden  diirfen.  Daher  endet  der  Programm- 
ablauf  im  Fehlerfall  in  einer  Endlosschleife,  in  der  “evnt_mesag()”  aufgemfen  wird. 

Der  Rahmen  nimmt  somit  folgende  Gestalt  an: 

1.  C-Programm: 

finclude  <aes.h> 

#include  <portab.h> 

char  acc_name[]  =  "  Accessory...";  /*  Immer  zwei  Leerzeichen  am 

Anfang!  */ 


WORD  apl  id,  menu  id; 
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void  main  (void) 

{ 

WORD  msg_buf  f er ( 8 ] ; 

if  ( (apl_id  =  appl_init{))  >=  0) 

{ 

if  ( (menu_id  =  menu__register  (apl_id,  accjname)  >=  0) 

{ 

for  (;;)  /*  Endlosschleife  */ 

{ 

evnt_mesag  (msg_buffer) ; 
switch  (msg_buffer [0] ) 

{ 

case  AC_OPEN : 

if  (msg_buffer [4]  ~~  menu_id) 

{ 

/*  Accessory  wurde  geoffnet...  */ 

} 

break; 

case  AC_CLOSE: 

if  (msg_buffer [3]  ==  menu_id) 

{ 

/*  Accessory  wurde  geschlossen. . . */ 

} 

break; 


} 

} 

} 

for  ( ; ; )  evnt_mesag  (msg_buf fer) ; 

} 

2.  Modula-2 -Programm: 

MODULE  Accessory; 

FRCM  AES  IMPORT  Appllnit,  MenuRegister,  EvntTimer,  EvntMesag, 
KAcOpen,  KAcClose; 

FROM  Strings  IMPORT  Assign,  String; 

CONST  AccName  =  ''  Accessory. . 

VAR  Aplld, 
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Menu ID  :  INTEGER; 

AccNameGlobal  :  String; 

MsgBuffer  :  ARRAY  [0..7]  OF  INTEGER; 


BEGIN 

Aplld  ;=  ApplInitO; 

IF  Aplld  >=  0 
THEN 

Assign  (AccNarae,  AccNameGlobal) ; 

Menuld  :=  MenuRegister (Aplld,  AccNameGlobal); 

IF  Menuld  >==  0 
THEN 

WHILE  TRUE 
DO 

EvntMesag (MsgBuffer) ; 

CASE  MsgBuffer [0]  OF 
KAcOpen  : 

IF  MsgBuffer [4]  =  Menuld 
THEN 

(*  das  Accessory  wurde  angewahlt...  *) 

END  | 

KAcClose  : 

IF  MsgBuffer [3]  =  Menuld 
THEN 

(*  das  Accessory  wurde  geschlossen. . .  *) 

END 

END 

END 

END 

END; 

WHILE  TRUE 
DO 

EvntMesag (MsgBuffer) 

END 

END  Accessory. 

Fortan  werden  in  erster  Linie  nur  noch  C-Beispiele  benutzt,  da  die  Ableitung  von  Modula-2- 
oder  Pascal-Programmen  klar  sein  diirfte. 

Die  Namensbildung  wird  an  anderer  Stelle  angesprochen,  eine  Kurzbeschreibung  der  C- 
Syntax  befindet  sich  im  Anhang, 
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Im  Hinblick  auf  die  Benutzung  der  VDI-Funktionen  —  sei  es  fur  Grafikausgabe  in  Fenstern, 
sei  es  fur  Objekte  vom  Typ  G_USERDEF  -  ist  das  Offnen  einer  virtuellen  VDI-Workstation 
wichtig.  Die  Anmeldung  erfolgt,  indem  das  Handle  der  physikalischen  Workstation  via 
“grafJiandleO”  abgefragt,  ein  Array  mit  passenden  Werten  gefullt  und  die  Funktion 
“v_opnvwk()”  aufgerufen  wird.  Eine  Fehlerabfrage  geschieht  durch  Uberpriifung  des  neuen 
Handles,  das  im  Fehlerfall  den  Wert  Null  hat. 

Hier  das  Offnen  einer  virtuellen  Workstation  auf  einem  Bildschirm,  mit  alien  Grafiktypen  und 
Rasterkoordinaten: 

vjhandle  =  grafjhandle  ( &gr_hwchar,  &gr_hhchar,  &gr_hwbox, 

&gr_hhbox) ; 

for  (i  =  0;  i  <  10;  work_in[i++]  =  1); 
work_in[10]  =  2; 

v_opnvwk  (work_in,  &v_handle,  work_out) ; 
if  (vjhandle  !=  0) 

{ 

} 

Geschlossen  wird  diese  virtuelle  Workstation  mit: 
v_clsvwk  (v_handle) ; 

Nach  dem  Anmelden  beim  AES  und  dem  Offnen  der  virtuellen  Workstation  fur  die 
Grafikausgaben  (falls  notig),  steht  nun  der  Programmierung  nichts  mehr  im  Wege.  Als 
nachstes  soli  die  Frage  nach  dem  eigentlichen  Programmablauf  gestellt  werden. 


Programmsteuerung  tiber  Ereignisse 

Im  Gegensatz  zu  der  mehr  traditionellen  Programmierung  mit  Warte-  und  Abfrageschleife, 
Ganzseitenmeniis  und  vollstandiger  Kontrolle  desBildschirms  und  deranderen  Ausgabegerate 
durch  das  Programm  wendet  man  sich  bei  der  Programmierung  unter  GEM  einer  Orientierung 
auf  Ereignisse  zu .  Diese  Art  der  Programmierung  findet  sich  auch  bei  den  andeTen,  modemen 
Sy stemen  wie  etwa  dem  Presentation  Manager  unter  OS/2  oder  dem  X- Window-System  unter 
Unix. 

Ein  ereignisorientiertes  Programm  schlummert  so  lange,  bis  es  angestofien  wird.  Ein  solcher 
AnstoB  -  ein  Ereignis  -  erfolgt  je  nach  den  Wiinschen  der  Programmierer.  GEM-Programme 
konnen  auf  Ereignisse  unterschiedlichster  Art  reagieren: 
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-  Tastatur-Ereignisse 
Mausknopf-Ereignisse 

-  Maus-Ereignisse 

-  Mitteilungs-Ereignisse 

-  Zeit-Ereignisse 

Die  einzelnen  Ereignisse  werden  je  nach  ihrer  Verwendung  getrennt  oder  gesammelt 
abgefragt.  Ein  Zeit-Ereignis  etwabeilangeren  Operationen  wird  mit“evnt„timer()”Tegelma8ig 
abgerufen,  um  anderen  Applikationen  etwas  Zeit  zu  geben.  Ein  Accessory  kann  sich  auf  das 
Warten  auf  eine  Nachricht  beschranken,  statt  mit  einem  “evnt_multi()”  auch  noch  (unnotige) 
Zeit-Ereignisse  zu  empfangen. 

Sobald  die  Programme  komplexer  gestaltet  sind,  kommt  nur  noch  der  Aufruf  von  “evnt_multi()’  ’ 
in  Frage,  denn  hier  muB  ein  Programm  auf  Ereignisse  unterschiedlichster  Art  reagieren.  Da 
wird  mit  der  Maus  auf  ein  Objekt  geklickt  (Mausknopf-Ereignis),  ein  Meniieintrag  gewahlt 
(Mitteilungs-Ereignis),  ein  Zeichen  fiber  Tastatur  eingegeben  (Tastatur-Ereignis)  oder  auch 
ein  Fenster  verschoben  (Mitteilungs-Ereignis).  Die  moglichen  Ereignisse  sind  in  der  AES- 
Einleitung  dokumentiert. 

Um  den  prinzipiellen  Aufbau  einer  Ereignisabfrage  zu  verstehen,  ist  es  wichtig,  den  Unter- 
schied  zu  der  traditionellen  Programmierung  zu  verstehen.  Beachten  Sie  dabei  aber  unbedingt, 
daB  ein  Programm  erst  auf  ein  Ereignis  reagiert  und  nicht  etwa  in  einer  Schleife  fortlaufend 
die  Tastatur  abfragt,  ob  eine  Taste  gedruckt  wurde! 

vorher:  nachher: 


LOOP 

BusyRead(c) ; 
CASE  c  OF 

Space  :  EXIT| 

END 

END 


LOOP 

EvntKeybd(c)  ; 
CASE  c  OF 

Space  :  EXITI 

END 

END 


Der  wesentliche  Unterschied  der  kurzen  Modula-2-Routinen  zwischen  “vorher”  und  “nach¬ 
her”  besteht  darin,  daB  die  Schleife  bei  “vorher”  ununterbrochen  durchlaufen  wird,  bei 
“nachher”  jedoch  pro  gedriickte  Taste  nur  einmal!  Auch  ist  nur  bei  dem  Aufruf  von 
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“evnt _keybd()”  ein  Weiterarbeiten  anderer,  parallel  laufender  GEM-Applikationen  mogllch. 
Der  Unterschied  der  beiden  Tastaturabfragen  mag  auf  den  ersten  Blick  nicht  offensichtlich 
sein,  doch  stellen  Sie  sich  einmal  vor,  es  ist  auch  noch  in  regelmaBigen  Zeitabstanden  eine  be- 
stimmte  Funktion  aufzurufen.  1m  ersten  Fall  miiBte  dann  neben  einer  eventuell  gedriickten  Ta¬ 
ste  auch  noch  die  Uhrzeit  abgefragt  werden,  im  zweiten  ist  es  aber  nur  erforderlich,  “evnt_mul- 
ti()”  anstelle  von  “evntjceybd()”  zu  verwenden. 

Hier  ein  kleines  Beispiel  zur  Ereignisabfrage: 

for  (;;)  /*  Endlosschleife  */ 

( 

evnt  =  evnt jnulti  (MUJKEYB  |  MU_BUTTON  |  MU_M1 1  MD_M2  |  MU_MESAG  I 
MUJTIMER, 

ev_rnbclicks,  evjnbmask,  evjmbstate, 
evjnmlflags,  evjnmlx,  evjumly,  evjnmlwidth, 
evjnmlheight , 

ev_mm2flags,  evjnm2x,  evjnm2y,  evjnm2w±dth, 
e v  jnm2hei ght , 
evjnmgpbuff , 

ey_mt locount ,  evjnthi count , 

evjrmox,  evjnmoy,  eyjamobutton,  evjnmokstate, 

evjnkreturn, 

evjnbreturn) ; 

if  (evnt  &  MOJCEYBD) 

hdle_keybd  (evjnkreturn) ;  /*  gedriickte  Taste  */ 

if  (evnt  &  MU_BOTTON) 

hdle_button  (evjnmox,  evjnmoy,  /*  Position  des 

Mauszeigers  */ 

evjnmobutton,  /*  Status  der  Maustasten  */ 

evjnmokstate,  /*  Status  der  Uinschalttasten  */ 

evjnbreturn) ;  /*  Anzahl  der  Mausklicks  */ 

if  (evnt  &  MU_M1) 

hdle_ml  (evjnmox,  evjmmoy, 
evjnmobutton , 
evjnmokstate)  ; 

if  (evnt  &  MU_M2) 

hdle__m2  (evjmmox,  evjnmoy,  /*  Position  des  Mauszeigers*/ 


/*  Position  des  Mauszeigers*/ 
/*  Status  der  Maustasten  */ 

/*  Status  der  Sondertasten  */ 
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evjnmobutton , 
ev_mmokstate) ; 

if  (evnt  &  MU_MESAG) 

hdle_mesag  (ev_mmgpbuf ) ;  /*  Adresse  des  Messagepuffers  */ 

if  (evnt  &  MU_TIMER) 
hdlejtimer  (); 

} 

Da  ein  “evnt„multi()”-Aufruf  nicht  notwendigerweise  nur  genau  ein  Ereignis  registriert,  ist 
eine  Benutzung  einer  Exklusiv-Auswahl  wie  mit 

switch  (evnt) 

{ 

case  . .  : 

break; 
case  . .  ; 
break; 

} 

nicht  mbglich!  Bei  einer  Abfrage,  welches  Mitteilungs-Ereignis  (MU_MESAG)  aufgetreten 
ist,  kann  jedoch  eine  derartige  Abfrage  wieder  erfolgen,  da  “evnt_multi()”  nur  maximal  eine 
Mitteilung  abgibt.  Auf  die  einzelnen  Ereignisse  wird  sinnvollerweise  in  gesonderten  Funktio- 
nen  reagiert,  da  so  auch  eine  logische  Aufteilung  der  Ereignisse  im  Programmlisting  erreicht 
werden  kann.  Die  Position  des  Mauszeigers  und  den  Status  der  Sonder-  und  Maustasten  wird 
von  “evnt_multi()”  ubrigens  immer  zuriickgegeben.  Daher  konnen  diese  Werte  auch  an  alle 
Funktionen  weitergereicht  werden. 


/*  Status  der  Maustasten  */ 

/*  Status  der  Sondertasten  */ 


Fensterverwaltung 

Im  Rahmen  der  Fensterverwaltung  wollen  wir  an  die  oben  besprochene  Steuerung  des 
Programms  iiber  Ereignisse  ankntipfen. 

Ftir  die  Fensterverwaltung  ist  die  in  dem  Beispiel  erwahnte  Routine  “hdle_mesag()”  von 
Interesse.  Ihr  wird  die  Adresse  des  Messagepuffers  iibergeben,  der  -  im  Falle  eines  Mittei- 
lungs-Ereignisses  -  die  relevante  Information  enthalt. 

Die  Funktion  “hdlw__mesag()”  konnte  folgenden  Aufbau  haben: 
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void  hdlejmesag  (WORD  *ev__mmgpbuf ) 

{ 

switch  (ev_nimgpbuf [0] ) 

{ 

case  AC_OPEN: 

/ *  Accessory  wurde  angewahlt ...  * / 

/*  Dies  konnte  das  Offnen  eines  Fensters  bedingen.  */ 
break; 

case  AC_CLOSE: 

/*  Accessory  wurde  geschlossen. . .  */ 

/*  Dies  konnte  das  Schlieiien  eines  Fensters  bedingen.  */ 
break; 

case  MN_SELECTED: 

/*  Menuverwaltung . . .  */ 

/*  Dies  konnte  das  Offnen  eines  Fensters  bedingen.  */ 
break; 

/*  ...und  hier  die  Fensterverwaltung!  */ 

/*  falls  Redraw-Meldung. . .  */ 

case  WM_REDRAW:  /*  ID  und  Koordinaten  Ubergeben  */ 
wind_redraw  ( ev_mmgpbuf [ 3 ] ,  ev_romgpbuf [ 4 ] , 
ev_iwngpbu  f  [  5  ] ,  e  v_nnngpbu  f  [  6  ] , 
ev_inmgpbuf  [  7  ] )  ; 

break; 

/*  falls  Fenster  aktiviert  wurde...  */ 
case  WM__TOPPED: 

wind_topped  (ev_mmgpbuf [3] ) ;  /*  ID  des  Fensters  */ 
break; 

/*  falls  Fenster  geschlossen  werden  soil...  V 
case  WM_CLOSED: 

wind_closed  (ev_mmgpbuf [3] ) ;  /*  ID  des  Fensters  */ 
break; 
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/*  falls  Fenster  auf  voile  Grofie  gebracht  werden  soil  */ 
case  WM_FULLED : 

wind_fulled  (evjmmgpbuf [3] ) ;  /*  ID  des  Fensters  */ 
break; 

/*  falls  einer  der  Pfeile  angeklickt  wurde...  */ 
case  WM_ARROWED: 

wind_arrowed  (ev_mmgpbuf [3] ,  /*  ID  des  Fensters  */ 

ev_mmgpbuf  [4] ) ;  /*  Art  der  Veranderung  */ 
break; 

/*  falls  der  horizontale  Slider  bewegt  wurde...  */ 
case  WM_HSLID ; 

wind_hslid  (ev_ramgpbuf [3] ,  /*  ID  des  Fensters  */ 

ev_mmgpbuf  [4] )  ;  /*  Position  in  Prorrtille  */ 
break; 

/*  falls  der  vertikale  Slider  bewegt  wurde...  */ 
case  WM_ySLID ; 

wind_vslid  (ev_mmgpbuf [3] ,  /*  ID  des  Fensters  */ 

ev_mmgpbuf [ 4 ] ) ;  /*  Position  in  Promille  */ 
break; 

/*  falls  die  Grolie  des  Fensters  verandert  wurde.  .  .  */ 
case  WM_SIZED: 

wind__sized  (ev_mmgpbuf [3] ,  /*  ID  des  Fensters  */ 

evjmigpbuf  [  4  ]  ,  /*  x-Koordinate  des  Fensters  */ 

ev_jnmgpbuf [5] ,  /*  y-Koordinate  des  Fensters  */ 

ev_mmgpbuf [6] ,  /*  neue  Breite  */ 

evjmngpbuf  [7] )-;  /*  neue  Hohe  */ 
break; 

/*  falls  das  Fenster  bewegt  wurde...  */ 
case  WM_MOVED: 

windjnoved  (ev_mmgpbuf [3] ,  /*  ID  des  Fensters  */ 
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ev__ramgpbuf  [  4  ] , 
evjnmgpbuf [5] , 
evjanmgpbuf  [6] , 
ev_inmgpbuf  [7] )  ; 
break; 


/* 

neue 

x-Koordinate 

*/ 

/* 

neue 

y-Koordinate 

*/ 

/* 

Breite  */ 

/* 

Hohe 

*/ 

) 


Die  in  diesem  Beispiel  aufgefiihrten  wind-Funktionen  sind  wiederum  durch  die  Programmie- 
rer  zu  deklarieren  und  beinhalten  Aufrufe  der  AES-Fensterfunktionen.  Den  jeweiligen  Fen- 
steraktionen  konnen  beispielsweise  folgende  AES-Funktionen  zugeordnet  werden: 

-  beim  Anlegen  eines  Fensters 

(legt  die  Fensterstruktur  an,  dies  beinhaltet  kein  Offnen  des  Fensters!) 


wind_create  (): 
wind_calc  (): 

beim  Offnen  eines  Fensters 

wind_open  (): 
wind_set  (WF_NAME, ...): 
wind_set  (WF_INFO, ...): 
wind_set  (WF_CURRXYWH, ...): 
wind_set  (WF_HSLIDE, ...): 
wind_set  (WF_VSLIDE, ...): 
wind_set  (WF_HSLSIZE, ...): 
wind_set  (WF_VSLSIZE, 

bei  Ausgaben  in  ein  Fenster 

wind_get  (WFJWORKXYWH, 
wind_get  (WF_HSUDE, ...): 
wind_get  (WF_VSLIDE, ...): 
wind_gct  (WF_FIRSTXYWH, ...): 
wind_get  (WF_NEXTXYWH, 
wind__get  (WF_HSLSIZE, ...): 
wind_get  (WF_VSLSIZE, ...): 
\vind_set  (WF„TOP, 
wind_update  (BEG_UPDATE): 
wind_update  (END_UPDATE): 


legt  maximale  GroBe  fest  und  liefert  ID 
GroBe  berechnen 


offhet  das  Fenster,  setzt  die  AnfangsmaBe 
setzt  Fenstemamen 
setzt  Infozeile 
setzt  Fenstergrofie 

setzt  Position  des  horizontalen  Sliders 
setzt  Position  des  vertikalen  Sliders 
setzt  Grofie  des  horizontalen  Sliders 
setzt  GroBe  des  vertikalen  Sliders 


GroBe  des  Arbeitsbereichs 
Position  des  horizontalen  Sliders 
Position  des  vertikalen  Sliders 
erstes  Rechteck  der  Rechteckliste 
nachstes  Rechteck  der  Rechteckliste 
GroBe  des  horizontalen  Sliders 
GroBe  des  vertikalen  Sliders 
Fenster  wird  zum  aktuellen 
Beginn  einer  Ausgabe/Emeuerung 
Ende  einer  Ausgabe/Emeuerung 
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bei  einer  GroBenveranderung 

wind__get  (WF_CURRXYWH, ...): 
wind_get  (WF_PREVXYWH,  ...): 
wind_get  (WF.FULLXYWH, ...): 
wind_set  (WF_CURRXYWH,  ...): 
wind_set  (WF_HSLIDE, ...): 
wind_set  (WF_VSLIDE,  ...): 
wind_set  (WFJHSLSIZE, ...): 
wind_set  (WF_VSLSIZE, ...): 

Verschieben  eines  Fensters 

wind_set  (WF_CURRXYWH, ...): 

SchlieBen  eines  Fensters 


aktuelle  GroBe 
bisherige  GroBe 
maximale  GroBe 
setzt  FenstergroBe 

setzt  Position  des  horizontalen  Sliders 
setzt  Position  des  vertikalen  Sliders 
setzt  GroBe  des  horizontalen  Sliders 
setzt  GroBe  des  vertikalen  Sliders 


setzt  Fensterkoordinaten 


wind_close  ():  schlieBt  das  Fenster 

Loschen  eines  Fensters  (entfemt  die  Fensterstruktur  aus  dem  Speicher!) 
wind_delete  ():  gibt  die  ID  wieder  frei 


Dialogverwaltung 

Zum  Aufruf  eines  Dialogs  sind  verschiedene  Schritte  notig.  Zum  einen  gehoren  dazu 
Elemente  des  Feedbacks  -  die  groBer  bzw,  kleiner  werdenden  Rechtecke  -  und  zum  anderen 
die  programmtechnisch  erforderlichen  Elemente. 

Die  Verwaltung  eines  Dialogs  teilt  sich  grundsatzlich  in  drei  Teile  auf: 

1.  Vorbereitung 

2.  Durchfiihrung 

3.  Nachbereitung 

Zur  Vorbereitung  gehort,  daB  kein  anderes  Programm  weiter  Ausgaben  tatigt,  die  Mauskontrolle 
bei  der  Applikation  liegt,  die  zu  der  Dialogbox  gehort,  und  der  Hintergrund  reserviert  wird. 
Die  Durchfuhrung  beinhaltet  den  Aufruf  der  eigentlichen  Verwaltungsroutine.  Zuletzt  die 
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Nachbereitung,  die  den  Hintergrund  wieder  freigibt,  die  Kontrolle  der  Maus  abgibt  und 
anderen  Applikationen  die  Ausgabe  wieder  erlaubt.  Somitentstehtfolgende  Minimalfunktion: 

WORD  do_dialog  (OBJECT  *dial) 

{ 

GRECT  size; 

WORD  rc; 

/*  Vorbereitung  */ 

wind_update  (BEG__UPDATE) ; 
wind_update  (BEG_MCTRL) ; 

form_center  (dial,  &size.g_x,  &size.g_y,  &size.g_w, 

&size.g_h) ; 

form_dial  (FMD_START,  size.g_x,  size.g_y,  size.g_w,  size.g__h, 
size.g_x,  size.g_y,  size.g_w,  size.g_h); 
objc_draw  (dial,  ROOT,  MAX_DEPTH,  size.g_x,  size.g_y, 
size. g_w, size. g_h) ; 

/*  Durchfiihrung  */ 

rc  =  formjdo  (dial,  ROOT)  &  0x7FFF; 

/*  Nachbereitung  */ 

form_dial  (FMD_FINISH,  size.g_x,  size.g_y,  size.g___w,  size.g_h, 
size.g_x,  size.g_y,  size.g_w,  size.g_h); 
wind_update  (END_MCTRL) ; 
wind_update  (END_UPDATE) ; 

dial [rc] .ob_state  &=  (~ SELECTED) ;  /*  Knopf  deselektieren  */ 
return  rc; 

} 

Die  Funktion  “do_dialog()”  liefert  die  Nummer  des  Buttons  zuriick,  mit  dem  der  Dialog 
beendet  wurde.  Zu  den  Vorbereitungen  gehort  meistens  das  Setzen  von  Radioknopfen,  die 
Initialisierung  der  Editfelder  und  vieles  andere.  Der  Nachbereitung  ist  somit  die  Auswertung 
veranderter  Objekte  und  Editfelder  zuzuordnen. 

Eine  Abwandlung  des  Durchfiihrungsteils  erlaubt  etwas  komplexere  Verarbeitungen.  Hier 
la6t  sich  zum  einen  der  Doppelklick  auswerten  (das  oberste  Bit  bei  dem  von  “form_do()” 
zuriickgegebenen  Wert)  und  zum  anderen  ein  “Spezial”-Objekt  installieren.  “form_do()” 
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kann  so  lange  in  einer  Schleife  wiederholt  werden,  bis  ein  bestimmter  Button  angeklickt  wor- 
denist.  Bei  Auswahleines  anderen  Elements  lassen  sich  Slider  undsonstigeinteressante  Dinge 
installieren.  Der  Durchfiihrungsteil  hatte  dann  die  Form: 

for  (;;) 

{ 

rc  =  form_do  (dial,  ROOT) ; 
doppel_klick  =  rc  &  0x8000; 
rc  &=  0x7FFF; 

if  ( (rc  ==  OK)  [ |  (rc  =  ABBRUCH) ) 
break; 

/*  weitere,  spezielle  Auswertungen . . .  */ 

} 

Abfragen  z.  B.  auf  den  SELECTED-Status  Oder  auf  den  Inhalt  eines  Editfeldes  erfolgen  direkt 
iiber  die  Objektstruktur. 

Frei  definierte  Objekttypen 

Ein  komplettes  Listing!  Das  kleine  Programm  demonstriert  die  Verwendung  des  Objekttyps 
G_USERDEF.  Statt  des  “normalen”  Select-Status  wird  ein  Objekt  mit  einem  Kreuzchen 
versehen.  Urspriinglich  handelte  es  sich  bei  dem  betreffenden  Objekt  um  eines  des  Typs 


Bitte  Mahlen  Sie: 

f~n  fluswahl 

Bitte  wahlen  Sie: 

[x]  fluswahl 

1  OR  | 

1  OK  | 

■ 

Diatoghox  ohm  G_USERDEF  Diahghox  nit  G_USERDEF 

Abb.  6.4:  Dialogbox  mit  USERDEF-Objekt 
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G_BOX,  das  jedoch  lediglich  dazu  benutzt  wurde,  die  Grofie  des  selbst  definierten  Objekts 
festzulegen.  Das  Programm  erkennt,  daB  ein  Typ  G_USERDEF  zu  setzen  ist,  an  dem  vom 
GEM  ignorierten  oberen  Byte  des  Typs  (der  in  unserem  Falle  auf  0x01  gesetzt  wurde). 

/*  C-Programm,  das  ein  Objekt  vom  Typ  GJJSERDEF  benutzt.  */ 

/*  Includes  fur  GEM  V 
#include  <aes.h> 

#include  <vdi.h> 
tinclude  <portab.h> 

/*  Resourcedatei-Indizes  */ 

# include  "demo.h" 

WORD  apl_id, 

v_handle; 

OBJECT  *dial; 

USERBLK  user; 

/*  Zeichenketten  */ 

char  no_resource []=" [3] [ | Resourcedatei | fehlt  leider!] [  OK  ]", 
rsrc__name  [  ]  ="DEMO.RSC"; 

/*  Prototypen  */ 

WORD  cdecl  selbutton  (PARMBLK  *parmblock) ; 
void  instal  (OBJECT  *dial,  WORD  obj) ; 

void  tree_walk  (OBJECT  *dial,  WORD  start,  void  (*callrout) 

(OBJECT  *dial,  WORD  obj) ) ; 
void  do_dialog  (OBJECT  *dial) ; 
void  main  (void) ; 

/*  Routine,  die  neuen  Selectbutton  ausgibt  */ 

WORD  cdecl  selbutton  (PARMBLK  *parrriblock) 

{ 

WORD  xy  [  8  ] ,  xy__clip  [  4  ] ; 

/*  Clipping  festlegen  */ 
xy_clip[0)  =■--  parmblock->pb_xc; 
xy__clip[l]  =  parmblock->pb_yc; 

xy_clip[2]  =  parmblock”>pb_xc  +  parmblock->pb_wc-l; 
xy_clip[3]  =  parmblock~>pb_yc  +  parmblock->pb_hc-l; 
vs_clip  (v_handle,  1,  xy_clip) ; 


/*  Application-ID  V 
/*  VDI -Handle  */ 

/*  Zeiger  auf  Objektbaum  */ 

/*  USERBLK  fur  G_USERDEF-Ob jekt  */ 
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/*  Rechteck  mit  Rahmen  ausgeben  */ 
xy[0]  =  parrriblock->pb_x+l; 
xy[l]  =  parrriblock->pb_y+l; 

xy[2]  =  parmblock->pb_x+pamnblock->pb_w-2; 
xy[3]  =  parmblock->pb_y+parmblock->pb_h-2; 
vsf_interior  (v__handle,  FIS_H0LL0W) ; 
v_bar  (v_handle,  xy) ; 

/*  Kreuz  als  Kennzeichen  fur  SELECTED  ausgeben  */ 
if  (parmblock->pb_currstate  &  SELECTED) 

{ 

xy[6]  =  xy [0] ; 

xy  [5]  =  xy [1] ; 

xy[4]  =  xy [2] ; 

xy[7]  =  xy [ 3 ] ; 

v_pline  (v_handle,  2,  xy) ; 

vjpline  (vjhandle,  2,  &xy[4]); 

} 

/*  Clipping  wieder  aus  */ 
vs_clip (v_handle,  0,  xy_clip) ; 

return  (parmblock->pb_currstate  &  -SELECTED) ; 


/*  installiert  GJUSERDEF-Objekte  */ 
void  instal  (OBJECT  *dial,  WORD  obj) 

{ 

switch  ( (dial [obj] .ob_type  &  OxFFOO)  »  8) 

{ 

case  0x01  : 

dial [obj] .ob_type  =  GJJSERDEF; 
dial [obj] .ob_spec .userblk  =  &user; 
user .  ub__code  =  selbutton; 

} 

} 

/*  wandert  durch  den  ganzen  Objektbaum  ab  (exklusiv)  start  */ 
void  tree_walk  (OBJECT  *dial,  WORD  start, 

void  (*callrout) (OBJECT  *dial,  WORD  obj) ) 
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{ 

WORD  i; 

for  (i  =  dial [start] .ob_head;  /*  Kopf  der  Objektfolge  */ 

(i  !=  start)  &&  (i  !=  -1);  /*  letztes  zeigt  auf  Parent  */ 
i  =  dialfi] .ob_next)  /*  nachstes  Objekt  */ 

{ 

<*callrout) (dial,  i) ; 
tree_walk  (dial,  i,  callrout); 

) 

) 

/*  do_dialog:  siehe  oben  */ 

/*  Hauptprogramra  */ 
void  main  (void) 

{ 

WORD  i; 

WORD  work_in[12] ,  work_out [57] ,  void__word; 

/*  Application  anraelden  */ 
apl_id  =  appl_init  () ; 

if  (apl_id  >=  0) 

{ 

grafjnouse  (HOURGLASS,  0L)  ; 

/*  Resourcedatei  laden  */ 
if  (rsrc_load(rsrc_name) ) 

{ 

/*  Adresse  ermitteln  */ 

rsrc_gaddr  (R_TREE,  DEMODIAL,  &dial) ; 

/*  VDI-Workstation  anmelden  */ 
v_handle  =  graf_handle  (&void_word,  &void_word, 
&void_word,  &void_word) ; 
for  (i  =0;  i  <  10;  work_in[i++]  =  1); 
work_in[10]  =  2; 

v_opnw;k  (work_in,  &v_handle,  work_out) ; 
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/*  GJJSERDEF  setzen  */ 

tree  walk  {dial,  ROOT,  instal) ; 

/*  Mauszeiger  als  Pfeil  */ 
graf_mouse  (ARROW,  OL) ; 

/*  Dialog  durchfuhren  */ 
do_dialog  (dial) ; 

/*  VDI-Workstation  schliepen  */ 
v_clsvwk  (v_handle)  ; 

} 

else  /*  Fehlermeldung  */ 

form_alert  (1,  no__resource)  ; 

appl_exit  ( ) ; 

I 

} 

Hardwareunabhangigkeit 

GEM-Programme  unabhangig  von  der  Hardware  zu  schreiben  1st  nicht  schwer.  Die  Grund- 
regeln  lassen  sich  schnell  auf  einen  einfachen  Nenner  bringen: 

Aufrufe  tieferer  Betriebssystemschichten  unterlassen  nnd  keine  unsicheren  Annahmen  liber 
irgendwelche  Gegebenheiten  machen. 

Befehle  und  Bibliotheken  der  diversen  Programmiersprachen  (wie  C)  bieten  einen  grofien 
Befehlsreichtum,  womit  Betriebssystemaufrufe  in  aller  Regel  unterbleiben  konnen. 

Wird  jedoch  einmal  eine  spezielle  Funktion  benotigt,  so  deklariert  man  diese  in  einem  eigenen 
Modul.  Bei  einer  Portierung  des  Programms  auf  ein  anderes  System  ist  dann  nur  dieser  eine 
Modul  zu  emeuem,  die  restlichen  Moduln  bleiben  unangetastet. 

Um  die  Portabilitat  der  verschiedenen  C-Compiler  untereinander  zu  erhohen  (manch  ein  Com¬ 
piler  hat  “int”  als  1 6-Bit-Wert  deklariert,  ein  anderer  als  32-Bit-Wert),  findet  eine  Datei  “por- 
tab.h”  Verwendung,  wie  sie  hier  in  aller  Kurze  aufgefiihrt  ist. 

(Die  Datei  “portab.h”  von  Digital  Research  bzw.  Atari,  wie  sie  z.  B.  bei  Laser  C  mitgeliefert 
wird,  enthalt  noch  weitere  Definidonen.) 
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/*  PORTAB.H 

Include-Datei  mit  portablen  Typendefinitionen  fur  C.  */ 

♦ifndef _ PORTAB 

♦define  PORTAB 


♦define 

BYTE 

signed  char 

/* 

Byte  (8  bits)  mit  Vorzeichen  */ 

♦define 

UBYTE 

unsigned  char 

/* 

Byte  ohne  Vorzeichen  */ 

♦define 

BOOLEAN  int 

/* 

2  Werte:  true/false  */ 

♦define  WORD 

signed  int 

/* 

Word  (16  bits)  mit  Vorzeichen  */ 

♦define 

UWORD 

unsigned  int 

/* 

Word  ohne  Vorzeichen  */ 

♦define 

LONG 

signed  long 

/* 

Long  (32  bits)  mit  Vorzeichen  */ 

♦define 

ULONG 

unsigned  long 

/* 

Long  ohne  Vorzeichen  */ 

tendif  PORTAB 


Namensgebung  von  Betriebssystemfunktionen 

Wer  mit  mehr  als  einem  Entwicklungssystem  arbeitet  und  hier  und  da  mal  GEM-Programme 
von  einem  System  auf  das  andere portieren  muB,  kennt  das  Problem,  daBdie  Namen  der  GEM- 
Routinen  nicht  einheitlich  sind. 

Bei  C-Entwicklungssystemen  ist  es  dabei  noch  recht  einfach,  denn  die  C-Namen  der  Funktio- 
nen  und  Konstanten  sowie  deren  Aufbau  sind  von  Digital  Research  vorgegeben. 

Bei  Pascal-Entwicklungssystemen  laBt  sich  eine  Namensubertragung  sehr  leicht  realisieren, 
denn  die  C-Namen  konnenubertragen  werden.  Schwieriger  erscheint  jedoch  die  Namensgebung 
auf  Modula-2-Systemen,  denn  zum  einen  ist  die  Schreibweise  der  Bezeichner  anders  (GroB- 
und  Kleinbuchstaben,  in  der  Regel  keine  Unterstriche,  langere  Namen),  und  zum  anderen 
existiert  kein  bindender  Standard  fiir  GEM/Modula-2-Namen,  Als  einfachster  Weg  der  Na- 
mensbildung  auf  Grundlage  der  C-Nomenklatur  bietet  sich  folgender  von  R.  Schneider  (Digi¬ 
tal  Research)  vorgeschlagene  an: 

-  alle  Funktionsnamen  (und  Silben)  beginnenmit  groBen  Buchstaben  und  werden  pro  Sil- 
be  mit  kleinen  Buchstaben  fortgesetzt 


alle  Unterstriche  fallen  weg. 
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Silben  beziehen  sich  hierbei  nicht  auf  sprachliche  Silben,  sondem  auf  die  durch  Unterstriche 
getrennten  Bestandteile  des  C-Funktionsnamens.  Somit  ergeben  sich  beispielsweise  die 
Namen 

-  VRbox  aus  v  .rbox 

-  VFormAdv  aus  v_form__adv 

-  ShelRdef  aus  sheljrdef 

Konstanten  entstehen  nach  dem  gleichen  Prinzip,  jedoch  kann  den  Namen  ein  Buchstabe  - 
beispielsweise  K  -  vorangestellt  werden.  Beispiel: 

-  KGBoxtext  aus  G_BOXTEXT 
KShadowed  aus  SHADOWED 

Der  Sinn  dieser  Namenswahl  ist,  daft  auch  ein  Modula-2-Programmierer  sofort  auch  die  C- 
Literatur  und  dieses  Buch  verwenden  kann,  ohne  jedesmal  nachdenken  zu  miissen,  wie  der 
Modula-2-Bezeichner  denn  nun  heifien  konnte.  An  die  etwas  kryptische  Schreibweise  ge- 
wdhnt  man  sich  recht  schnell. 


Teil  II 


Die  Hardware  des  ST 
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Uberblick  iiber  das  System 

Bei  den  Atari-Computem  der  ST-Serie  handelt  es  sich,  wie  schon  bei  den  8-Bit-Modellen  der 
XL-  und  XE-Serie,  um  sogenannte  Tastaturcomputer. 

Was  andeutet,  da6  sich  fast  alle  zum  Betrieb  benotigten  Hardwarekomponenten  zusammen 
mit  der  Tastatur  in  einem  Gehause  befinden.  Ein  solcher  Tastaturcomputer  ist  bereits  nach 
AnschluG  der  Stromversorgung  und  eines  Sichtgeriites  (Monitor)  betriebsfahig.  Sinnvolles 
Arbeiten  ist  jedoch  erst  mit  AnschluB  eines  Massenspeichers  (Floppy-Disk/Harddisk)  mog- 
lich,  weshalb  bei  den  Modellen  520ST(FM)/1040ST(FM)  bereits  ein  Floppy-Disk-Laufwerk 
mit  einer  Speicherkapazitat  von  720  KByte  ins  Gehause  eingebaut  wird. 

Die  Gerate  der  MEGA  ST-Serie  fallen  schon  nicht  mehr  in  diese  Kategorie,  da  sie  eine  abge- 
setzte  Tastatur  besitzen.  Die  Intelligenz  befindet  sich  einschlieBlich  Stromversorgung  in 
einem  separaten  Gehause,  welches  auch  eine  720  KByte-Floppy  beinhaltet  und  als  Monitor- 
untersatz  benutzt  werden  kann. 

Im  Prinzip  stellen  sich  jedoch  die  Computer  der  ST-Serie  als  ein  System  mit  den  Grund- 
komponenten  Zentraleinheit,  Grafiksystem,  Musik-  und  Tonsystem  und  verschiedenen 
peripheren  Untersystemen  dar.  Die  Zentraleinheit  besteht  aus: 

-  einem  mit  8  MHz  getakteten  MC68000  Mikroprozessor 

-  192  KByte  Festwertspeicher  (ROM),  durch  einsteckbares  Cartridge  auf  320  KByte 
erweiterbar 

-  512  KByte  Arbeitsspeicher  (RAM)  bei  260ST/520ST(FM)  bzw.  1  MByte  bei  520ST+ 
und  1040  ST(FM)  (1 , 2  oder  4  MByte  bei  der  MEGA  ST-Serie). 

Das  Grafiksystem  in  Stichworten: 

-  32  KByte  Bildschirmspeicher  (beliebig  im  Arbeitsspeicher  gelegen) 

-  folgende  Anzeigemodi  sind  moglich: 

320  x  200  Bildpunkte  in  16  aus  512  moglichen  Farben 
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640  x  200  Bildpunkte  in  vier  aus  512  moglichen  Farben 
640  x  400  Bildpunkte  in  S/W  mit  Monochrom-Monitor 

-  AnschluB  eines  hochauflosenden  Monochrom-  Oder  eines  Farbmonitors  mit  RGB-Ein- 
gang  (beim  520ST(F)M/1040ST(F)M  istder  AnschluB  eines  Fernsehers  durcheingebau- 
ten  HF-Modulator  moglich). 

Das  Musik-  und  Tonsystem  enthalteinen  SoundchipmitdreiprogrammierbarenTonkanalen 
und  einem  Rauschgenerator.  Die  Hiillkurve  ist  programmierbar. 

Die  peripheren  Untersysteme  im  ST  bestehen  aus: 

-  Tastatur-,  Maus-  und  Joystick-Interface  mit  eigenem  Mikroprozessor  und  liber  eine 
serielle  Schnittstelle  mit  dem  Hauptsystem  verbunden 

-  Parallel-Schnittstelle  (in  der  Regel  als  Druckerinterface  nach  Centronics-Standard 
genutzt) 

serielle  Schnittstelle  (RS232)  fiir  Modem  oder  seriellen  Drucker 

-  Floppy  -Disk-Interface  fiir  z  wei  Laufwerke  bis  je  720 KByte  (formatieirter)  Speicherkapa- 
zitat 

-  ATARI  Computer  Sy tern  Interface  (ACSI)  mit  DMA-Unterstiitzung  zum  AnschluB  von 
schnellen  Peripheriegeraten  wie  Harddisk,  CD-ROM,  Laserdrucker  usw. 

-  MIDI-Interface  fiir  AnschluB  an  digital  steuerbare  Musikinstrumente. 

Immer  mehr  Grips  in  immer  weniger  Chips 

Im  ST  befinden  sich  neben  Standardbausteinen  wie  der  68000er-CPU,  WD  1772-Floppy- 
Disk-Controller,  AY-3-89 10- Oder  YM2149-Soundchip,68901-Multifunktionsbaustein,  6850- 
ACIAs  (Bausteine  fiir  asynchrone,  serielle  Dateniibertragung),  RAMs  und  ROMs  noch 
vier  sogenannte  Custom-Chips  (beim  STE  wurde  die  Anzahl  auf  drei  Custom-Chips  redu- 
ziert,  da  GLUE  und  MMU  zur  GSTMCU  zusammengefaBt  wurden).  Diese  speziell  von  Atari 
fiir  die  ST-Computer  entwickelten  Chips  enthalten  eine  Vielzahl  von  Funktionsgruppen,  die 
fiir  das  einwandfreie  Funktionieren  des  Systems  erforderlich  sind.  Ihnen  ist  es  zu  einem  groBen 
Teil  auch  zu  verdanken,  daB  ein  Computer  dieser  Leistungfahigkeit  zu  einem  so  niedrigen 
Preis  zu  haben  ist. 

Der  SHIFTER  sorgt  dafiir,  daB  Sie  ein  klares  Bild  von  Ihrem  ST  erhalten.  Er  setzt  namlich  die 
Information  des  Hauptspeicherbereichs,  der  fiir  den  Bildschirmspeicher  reserviert  ist,  in  ein 
Videosignal  fiir  den  Monitor  um. 
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Abb.  0.1 :  Die  einzelnen  Komponenten  eines  ST 

Dazu  verfiigt  er  zwar  iiber  einen  16  Bil-Datenbusanschlu8,  der  AdreBzahler  fur  die  entspre- 
chende  darzustellende  BildschirmspeicherAdresse  befindet  sich  jedoch  in  der  MMU  und  wird 
dort  verwaltet,  Uber  entsprechende  Registerauswahl-  und  Steuerleitungen  ladt  die  MMU 
unter  Mithilfe  des  GLUE  (Steuersignalerzeugung)  die  SHIFTER-Register  mit  den  Werten  aus 
dem  Bildschirmspeicher  und  fiir  die  Farbpalette.  Mit  dem  32  MHz-Mastertakt  wird  die 
Bildinformation  dann  al$  Color-  oder  Monochromsignal  ausgegeben. 

Der  BLITTER-Chip  ist  in  den  MEGA  STs/STEs  eingebaut  und  realisiert  die  Line-A-Funktion 
“Bit-Block-Transfer”  mit  Hardware-Unterstiltzung.  Mit  seiner  Hilfe  lassen  sich  ohne  Umweg 
iiber  die  CPU  blitzschnell  groBe  Datenbereiche  im  Bitraster  manipulieren. 

Der  BLITTER  darf  dazu  ebenfalls  wie  die  DMA-Einheit  auf  den  Hauptspeicher  direkt 
zugreifen.  Zugriffe  miissen  jedoch  mit  der  CPU  und  der  DMA-Einheit  abgestimmt  werden, 
wobei  der  DMA-Betrieb  des  BLITTERs  niedrigste  Prioritat  besitzt,  Im  Gegensatz  zum  SHIF¬ 
TER  ist  der  BLITTER  ein  eigener  Co-Prozessor-Chip,  der  iiber  einen  voll  wertigen  AdreB-  und 
Datenbus  verfiigt.  AuBerdem  besitzt  er  alle  notigen  Steueranschliisse  fiir  die  Steuerung  des 
Daten-  und  AdreBbusses  als  eigenstandige  Einheit  in  einem  68000er-Prozessorsystem. 

Die  DMA-Einheit  hilft  den  Peripheriegeraten  wie  Floppy-Controller  und  den  am  ACSI-Bus 
angeschlossenen  schnellen  Peripheriegeraten  wie  Harddisk,  CD-ROM  und  evtl .  Laserdrucker 
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Abb.  0.2:  Das  Blockschaltbild  des  ST 
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beim  Datenaustausch.  Sie  kann  dabei,  genau  wie  die  CPU  direkt  auf  den  Hauptspeicher 
zugreifen  (deshalb  DMA  =  Direct  Memory  Access)  und  die  erforderlichen  Daten  fur  die  Peri- 
pheriegerate  dort  abholen  Oder  deponieren. 

Die  CPU  hat  mit  dem  Datentransfer  also  nicht  mehr  viel  zu  tun  und  konnte  sich  anderen 
Aufgaben  widmen  (tut  sie  aber  nicht!).  Dem  DMA -Chip  ist  es  ahnlich  gegangen  wie  dem 
SHIFTER.  Die  entsprechenden  AdreBzahler  fur  die  Abwicklung  von  DMA-Operationen 
befinden  sich  in  der  MMU.  Lediglich  ein  16  Bit-AnschluB  zum  Datenbus  ist  vorhanden,  iiber 
den  der  DMA-Chip  den  DMA-Transfer  abwickelt.  Die  Steuerung  des  AdreBbusses  iibemimmt 
der  GLUE  in  Zusammenarbeit  mit  der  MMU! 

Die  Memory  Management  Unit  (MMU)  besorgt  die  Umsetzung  der  von  der  CPU  ausgehenden 
AdreBinformation  in  einen  gemultiplexten  AdreBbus  fur  die  dynamischen  RAMs.  AuBerdem 
werden  von  ihr  die  Refresh-Signale  fur  die  RAMs  zur  Verfiigung  gestellt,  die  dafiir  sorgen, 
daB  die  Speicherzellen  in  den  RAM-Chips  nicht plotzlich  an  “Gedachtnisschwund”  leiden  und 
ihren  Informationsinhalt  verlieren.  Die  MMU  ist  dazu  vollslandig  an  den  AdreBbus  angebun- 
den  mit  den  zugehorigen  Handshake-Leitungen  ftir  den  Memory-Zugriff. 

Auf  den  Datenbus  greift  die  MMU  direkt  nur  zur  Halfte  (D0..D7)  zu.  Diese  Halfte  wird  fiir 
das  Laden  der  in  diesem  Chip  integrierten  Register  wie  fiir  Memory-Configuration,  die  Video- 
Base-  und  Video-Counter-Register  sowie  die  DMA-Base-Register  verwendet. 

Der  GLUE  ubernimmt  die  Decodierung  der  AdreBbereiche  fiir  RAM,  Betriebssystem-  und 
Cartridge-ROM  und  die  peripheren  Chips  wie  Soundchip,  ACIAs  und  68901.  Weiterhin  wer¬ 
den  die  fiir  die  CPU  erforderlichen  Steuer-  und  Quittungssignalefiirlnterrupts.Zugriffsberech- 
tigung  auf  geschiitzte  Speicherbereiche  usw.  vom  GLUE  erzeugt. 

Der  GLUE-Chip  hat  dazu  einen  vollwertigen  AdreBbus-AnschluB  und  Zugriff  auf  alle  CPU- 
Steuersignale.  Dafiir  ist  jedoch  sein  Datenbus-AnschluB  entsprechend  mager  ausgefallen 
(gerade  mal  DO  und  Dt  sind  angebunden  -  also  genausoviel  wie  der  GLUE  braucht,  um  das 
interne  Sync-Mode-Register  zu  bedienen!). 

Wenn  also  bei  den  weiteren  Erlauterungen  von  dem  Video-Controller  oder  der  DMA-Einheit 
die  Rede  ist,  sind  damit  alle  Register  und  Logikkomponenten  gemeint,  die  fiir  die  angespro- 
chene  Funktionseinheit  erforderlich  sind,  egal  in  welchem  Custom-Chip  sie  zu  finden  sind. 
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Kapitel  1:  Die  Zentraleinheit 

Die  Zentraleinheit  der  Atari  ST  Computer  besteht  aus  dem  Mikroprozessor,  dem  Hauptspeicher 
und  der  DMA-Einheit. 


Der  Mikroprozessor 

Das  Herz  des  ATARI  ST  ist  eine  MC68000-CPU,  die  mit  einer  Frequenz  von  8  MHz  getaktet 
wird.  Hierbei  handelt  es  sich  um  eine  32-Bit-CPU,  die  intern  eine  Verarbeitung  von  Daten  mit 
32  Bit  Breite  vomimmt.  Der  Datentransfer  von  und  zur  CPU  erfolgt  jedoch  uber  einen  1 6  Bit 
breiten  Datenbus  (Daher  auch  die  Bezeichnung  ”ST”  =  Sixteen  Thirtytwo=  16  Bit  ext. 
Datenbus/32  Bit  int.  Datenbus). 


Es  konnen  also  gleichzeitig  zwei  Bytes  (ein  Datenwort)  iibertragen  werden,  wobei  aber  auch 
Einzelbyte-Zugriffe  moglich  sind.  Ein  Befehl,  um  z.  B.  ein  Datenwort  aus  einer  Speicherstelle 
in  eines  der  CPU-Register  zu  laden,  benotigt  im  ST  vier  Taktzyklen,  Bei  einer  Taktfrequenz 
von  8  MHz  dauert  das  Ganze  also  nur  0,5  Mikrosekunden! 


Die  CPU  besitzt  acht  Daten-  und  neun  AdreBregister  mit  je  32  Bit  Breite,  wobei  zwei  der  neun 
AdreBregister  Stapelzeiger  (Stackpointer)  darstellen.  Zwei  Stapelzeiger  deshalb,  weil  die 
CPU  zwei  Betriebsarten  kennt,  den  Supervisor-Modus  und  den  User-Modus.  Je  nach  Betriebs- 
art  “sieht”  das  laufende  Programm  den  Supervisor-  oder  den  User-Stapelzeiger, 


Im  Supervisor- oder  System-Modus  istvomProgrammher der ZugriffaufalleSpeicherbereiche 
und  das  gesamte  Statu  sregister  der  CPU  moglich. 


Im  User-  oder  Benutzer-Modus  kann  nicht  auf  Daten  des  Supervisorspeicherbereichs  zuge- 
griffen  werden,  so  daB  sich  eine  erhohte  Sicherheit  gegen  versehentliches  Manipulieren  von 
fur  das  Betriebssystem  “lebenswichtigen”  Daten  (Systemvariablen),  die  im  Supervisorspeicher- 
bereich  untergebracht  sind,  durch  ein  User-Programm  ergibt. 


Der  Programmzahler  der  CPU  ist  zwar  32  Bit  breit,  herausgefiihrt  auf  den  AdreBbus  sind 
jedoch  nur  die  AdreBleitungen  A 1 . .  A23 .  Die  AdreBleitung  AO  existiert  beim  MC68000  nicht, 
da  ja  mit  einem  16-Bit-Datenbus  gearbeitet  wird.  Um  aber  auch  auf  ungerade  Adressen  (ein- 
zelne  Bytes)  zugreifen  zu  konnen,  liefert  die  CPU  die  lo w-aktiven  Steuersignale  UDS  und  LDS 
(Upper-Data-Strobe  und  Lower-Data-Strobe ). 
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Abb.  1 .1 :  Die  Register  des  MC68000 


UDS  ist  aktiv  (Low),  wenn  auf  das  hoherwertige  Byte  eines  Wortes  zugegriffen  wird  (Bits 
8..  15  des  Datenbusses,  gerade  Speicheradresse),  und  LDS  ist  entsprechend  aktiv  (Low)  bei 
einem  Zugriff  auf  das  niederwertige  Byte  (Bits  0.  .7  des  Datenbusses,  ungerade  Speicheradresse). 
Logischerweise  sind  also  dann  bei  einem  Wortzugriff  beide  Leitungen  aktiv! 

Mit  den  AdreBleitungen  A1..A23  lassen  sich  also  “nur”  max.  16  MBytes  an  Speicherraum 
direkt  ansprechen,  diese  16  MByte  jedoch  durchgehend  linear  ohne  Segmentierung  wie  z,  B. 
bei  den  8086/808 8-CPUs.  Dieser  AdreBraum  von  1 6  MB yte  wird  im  ATARI  ST,  wie  in  Abbil- 
dung  1.2  gezeigt,  eingeteilt. 
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Abb.  1.2:  Die  Speicheraufteilung  des  ST  im  Uberblick 
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RAM  und  ROM 

Die  ersten  zwei  KByte  des  Adrefiraums  des  ST  sind  fur  die  Ausnahmevektoren  und  den 
Supervisor-Stack  reserviert  und  liegen  (fast  ausschlieBlich)  im  RAM.  Dabei  belegen  die  im 
ST  benutzten  Ausnahmevektoren  die  ersten  zwei  Pages  des  Speicherraums  (von  $8  bis  $  1 3C). 
Ab  Adresse  $380  schlieBt  sich  daran  der  Bereich  mit  den  verschiedenen  Systemvariablen  an 
(siehe  Teil  1,  Kapitel  1,  “BIOS  und  XBIOS”). 

Bei  den  ersten  acht  Bytes  ab  Adresse  $0  handelt  es  sich  nicht  um  RAM,  sondern  um  ROM! 
Es  sind  dies  die  ersten  achtBytes  des  ST-ROMs  ab  Adresse  $FC  0000,  die  durch  entsprechende 
AdreBdecodierung  an  diese  S  telle  des  AdreBraums  gedoppelt  werden.  Der  Inhalt  dieser  beiden 
LangwSrter  sorgt  dafiir,  daB  nach  dem  Einschalten  des  ST  oder  nach  einem  RESET  das  gesam- 
te  Computersystem  von  einem  definierten  Ausgangspunkt  hochgefahren  werden  kann. 

Die  68000er-CPU  erwartet  nach  einem  RESET  namlich  in  Adresse  $0  einen  Anfangswert  fur 
den  Supervisor-Staekpointer  und  in  Adresse  $4  einen  Pointer  auf  die  Adresse  des  ersten 
auszufiihrenden  Befehls! 

Wer  jetzt  mal  schnell  bei  Adresse  $0  nachgeschaut  hat,  wundert  sich  bestimmt  tiber  diesen 
seltsamen  Wert,  der  dort  als  Startweit  fur  den  Supervisor-Staekpointer  aufbewahrt  wird.  Keine 
Bange,  der  Wert  stimmt  schon,  nur  enthalt  das  Langwort  (eigentlich  ja  bei  $FC  0000  im  ROM 
gelegen)  einen  Sprungbefehl  auf  die  Systemstart-Routinen  im  ROM.  Das  ist  aber  nicht  weiter 
tragisch,  da  der  ST  nacheinemRESET  zunachstsowieso  nicht  weiB,  welcheSpeicherbestiickung 
fur  das  RAM  vorliegt.  Zuerst  muB  namlich  mit  Hilfe  der  MMU  und  den  eingebauten  RAM- 
Chips  ein  durchgehender  Speicherbereich  “zusammengebaut”  werden.  Dazu  spater  noch  ein 
wenig  mehr. 

Die  Gerate  260ST  und  520ST(FM)  besitzen  in  ihrer  Grundausstattung  eine  Speicherkapazitat 
von  512  KByte  RAM.  Somit  endet  fur  diese  Gerate  der  RAM-Bereich  bei  $07  FFFF.  Diese 
512  KByte  werden  mittels  1 6  Dynamischer  RAM-Chips  des  Typs  4 1 256  realisiert,  welche  pro 
Chip  eine  Speicherkapazitat  von  256K  x  1  Bit  aufweisen. 

Die  Datenleitungen  dieser  1 6  Chips  werden  zu  einem  1 6-Bit-Datenbus  zusammengefaBt,  denn 
dieCPUkannjal6Bitaufeinmal  verarbeiten.FurdieAdressierung  der262144Speicherstellen 
in  den  Speicherchips  wird  ein  gemultiplexter  AdreBbus  verwandt.  Man  legt  dazu  zeitlich 
nacheinander  erst  die  untere  und  dann  die  obere  Halfte  der  in  diesem  Fall  benotigten 
AdreBinformation  an  die  Speicherchips. 

Deshalb  geniigen  dann  fur  einen  256  KBit-Chip  auch  statt  der  sonst  erforderlichen  18  (2A18 
=  262144)  nun  18/2  =  9  AdreBleitungen  und  je  eine  sogenannte  RAS-  und  CAS-Leitung.  Die 
RAS-  und  CAS-Leitung  (RAS  =  Row  Adress  Strobe  =  Zeilen-AdreBimpuls  /  CAS  =  Column 
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Adress  Strobe  =  Spalten-  AdreBimpuls)  signalisieren  der  Logik  in  den  Speicherchips,  welcher 
Teil  der  benotigten  Adresse  gerade  an  den  AdreBeingangen  des  Chips  anliegt. 

Man  spart  so  Platz,  Anschliisse  und  Leitungen,  bendtigt  aber  etwas  zusatzliche  Logik  fiir  das 
Multiplexen  und  das  Timing.  Im  ST  befindet  sich  diese  Logik  in  der  sogenannten  Memory- 
Management-Unit  (MMU). 


Standardchips  erleichtern  den  Speicherausbau 

Bereits  bei  der  Entwicklung  der  ST-Serie  wurde  von  ATARI  Wert  auf  eine  moglichst  einfache 
Verwendbarkeit  von  Standard-RAM-Chips  gelegt. 

So  unterstiitzt  die  derzeit  in  den  ST  verwendete  MMU  zwei  RAM-Speicherbanke  mit  dynami- 
schem  RAM  zu  max.  2  MByte  pro  Bank.  Die  STs  des  Typs  260ST  und  520ST(FM)  besitzen 
nur  eine  Speicherbank  mit  1 6  Chips  des  256KBit-Typs  und  kommen  so  auf  5 1 2  KByte  RAM. 

Um  nun  bei  den  Geraten  des  Typs  520ST+  und  1040ST(FM)  auf  einen  Speicherausbau  von 
1  MByte  RAM  zu  kommen,  wurde  einfach  die  zweite  Speicherbank  mit  weiteren  1 6  Chips 
des  256  KBit-Typs  eingebaut.  Diese  Aufriistung  ist  relativ  problemlos,  denn  auBer  den  Chips 
braucht  man  keine  zusatzlichen  Multiplexer  und  Adrefidecoder.  Die  MMU  liefert  bereits  von 
Haus  aus  die  hierfiir  zusatzlich  erforder]  ichen  RAS-  und  CAS-Signale  fiir  die  zweite  Speicher¬ 
bank. 

Fiir  die  zusatzlich  erforderlichen  16  Chips  der  zweiten  Bank  ist  das  Platinenlayout  des 
1040ST(FM)  bereits  vorgesehen.  Beim  520ST+  (oder  nachtraglich  beim  260ST  oder 
520ST(FM))  lassen  sich  die  Chips  fiir  die  zweite  Speicherbank  einfach  auf  die  Chips  der  ersten 
Bank  “huckepack”  aufloten.  Lediglich  die  RAS-  und  CAS- Anschliisse  werden  nicht  direkt  mit 
den  darunterliegenden  Chipanschliissen  verlotet,  sondem  separat  mit  der  MMU  verbunden. 

Dabei  werden  alle  R  AS-Anschliisse  (Pin  4  der  Speicherchips)  der  neuen  Bank  verbunden  und 
an  den  AnschluB  RAS  1  (Pin  1 8)  der  MMU  gefiihrt.  Die  CAS- Anschliisse  (Pin  1 5  der  Speicher¬ 
chips)  der  acht  Chips,  die  mit  den  Datenleitungen  D0...D7  des  Datenbus  (niedrigwertiges 
Byte)  verbunden  sind,  werden  gebriickt  und  iiber  einen  68  Ohm-Widerstand  an  CAS  1L  (Pin 
21)  der  MMU  gelegt. 

Entsprechend  ist  mit  den  CAS-Anschliissen  der  acht  Chips  zu  verfahren,  die  an  die  Datenlei¬ 
tungen  D8...D15  (hoherwertiges  Byte)  des  Datenbusses  angeschlossen  sind.  Sie  werden 
ebenfalls  gebriickt  und  auch  iiber  einen  68  Ohm-Widerstand  mit  CAS  1H  (Pin  22)  der  MMU 
verbunden .  Fiir  den  Aufbau  der  Speicherbanke  konnen  verschiedene  T ypen  von  dynamischen 
RAM-Chips  verwendet  werden,  wie  Abbildung  1 .3  zeigt. 
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Abb.  1.3:  Die  im  ST  verwendbaren  RAM -Chips 


1  MBit-Chips  passen  leider  nicht! 

Die  64  KBit-  und  256  KBit-Chips  sind  untereinander  pinkompatibel  und  konnen  direkt 
ausgetauscht  werden.  Ein  direkter  Tausch  der  256  KBit-  gegen  1  MBit-Typen  ist  aber  leider 
nicht  moglich  (unterschiedliches  Pin-Layout!). 

Will  man  einen  “Nicht-MEGA  ST”  mit  1  MBit-Chips  bestiicken,  so  sindeinige  Modifikationen 
bei  den  Chipanschliissen  erforderlich,  die  einen  versierten  Hardware-Bastler  jedoch  nicht  vor 
uniiberwmdliche  Probleme  stellen  diirften!  Auch  werden  inzwischen  von  verschiedenen 
Firmen  Aufriistplatinen  angeboten,  die  mit  Oder  ohne  Entfemen  der  alten  Speicherbank 
eingebaut  werden  konnen  und  wahlweise  eine  Bestiickung  mit  256  KBit-  oder  mit  Megabit- 
Chips  erlauben.  Aufriistungen  auf  bis  zu  4  MByte  sind  auch  fur  “Nicht-MEGA  ST -Computer” 
moglich.  Grenzen  sind  nur  durch  den  eigenen  Geldbeutel  gesetzt.  Die  Gerate  der  MEGA  ST- 
Serie  besitzen  von  Haus  aus  die  Megabit-Chips  und  kommen  somit  auf  einen  Speicherausbau 
von  2  MByte  bei  einer  Bank  bzw.  4  MByte,  wenn  auch  die  zweite  Bank  auf  der  Hauptplatine 
bestiickt  ist. 

Wegen  der  1988/89  teilweise  auftretenden  Speicherknappheit  hat  ATARI  insbesondere  bei 
den  Rechnem  der  1040er-Serie  verschiedene  Platinenlayouts  verwendet,  urn  eben  alle  nur 
moglichen  Speicherchips  verwenden  zu  konnen.  So  kamen  unter  anderem  auch  1  MBit- 
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RAMs  der  Organisation  256K  x  4  Bit  zum  Einsatz.  Die  Bestiickung  der  damit  ausgeriisteten 
1040er  sieht  dann  so  aus,  daS  pro  Speicherbank  vier  Chips  zum  Einsatz  kommen  und  damit 
512  KByte  Kapazitat  aufweisen. 

Urn  auf  die  Standardkapazitat  von  1  MByte  pro  Rechner  zu  kommen,  wurde  die  zweite  Bank 
genauso  bestiickt.  Acht  Chips  ergeben  somit  eine  Kapazitat  von  1  MByte!  Eine  Erweiterung 
auf  2  MByte  oder  4  Mbyte  istbei  diesen  Rechnem  aber  nicht  mehr  im  einfachen  “Huckepack- 
Verfahren”  moglich. 

Bei  einer  evtl.  Speichererweiterung  ist  darauf  zu  achten,  daB  jede  Bank  einheitlich  mit  den 
gleichen  Chips  bestiickt  werden  muB. 

Es  ist  aber  ohne  weiteres  moglich,  in  den  beiden  moglichen  Speicherbanken  unterschiedliche 
Chiptypen  zu  verwenden.  So  kann  man  z.  B .  die  erste  Bank  mit  256  KBit-Chips  bestiicken  und 
kommt  dann  auf  512  KByte  RAM.  Die  zweite  Bank  kann  mit  Megabit-Chips  bestiickt  sein 
und  weist  dann  eine  Kapazitat  von  2  MByte  auf. 

Zusammen  sind  das  dann  stattliche  2,5  MByte!  (Leider  gibt  es  einige  ST s  mit  MMUs  derFirma 
IMP,  die  eine  ungleiche  Bestiickung  der  beiden  Speicherbanke  nicht  erlauben!)  Durch  diese 
Moglichkeit  der  gemischten  Bestiickung  ergeben  sich  eine  Reihe  von  moglichen  Speicher- 
konfigurationen. 
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Abb.  1.4:  So  programmiert  der  ST  semen  Speicherausbau 
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Weiter  nit  der  Systeninitialisierung 


Abb.  1.5:  So  stellt  der  ST  beim  Systemstart  semen  Speicherausbau  fest 


Wieviel  RAM  ist  denn  drin? 

Um  festzustellen,  welcher  Speicherausbau  denn  nun  vorliegt,  wird  zu  Beginn  der  Sy  steminitia- 
lisierung  ein  Speichertest  ausgefuhrt,  der  AufschluB  dariiber  gibt,  welche  Speicherchips 
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vorhanden  sind.  Der  Programmteil  liegt  im  ROM  und  wird  nahezu  unmittelbar  nach  dem 
Systemstart  ausgefiihrt. 

Hierbei  wird  folgender  Effekt  ausgenutzt: 

Man  geht  zunachst  beim  Speichertest  davon  aus,  daG  beide  Speicherbanke  vorhanden  sind  und 
mit  Megabit-Chips  bestiickt  sind. 

Die  ersten  zwei  Pages  ($0. ..$  Iff)  jeder  Bank  werden  nun  mit  einem  Testmuster  beschrieben. 
Befinden  sich  jedoch  start  der  Megabit-RAMs,  die  ja  unterstellt  werden,  solche  des  64  KBit- 
oder  256  KBit-Typs  im  Rechner,  so  werden  durch  eine  Art  Falschdecodierung  der 
AdreGleitungen  zu  den  Speicherchips  nicht  nur  die  ersten  beiden  Pages  der  Speicherbank  mit 
dem  Testmuster  beschrieben,  sondem  je  nach  verwendeten  Chips  noch  andere  Pages! 

Aus  der  Information,  welche  Pages  noch  beschrieben  wurden,  kann  auf  die  Art  der  eingebauten 
Speicherchips  geschlossen  werden. 

Das  sogenannte  Memory-Configuration-Register  (Label:  “memconf ’)  bei  Adresse  $FF  8001 
wird  dann  entsprechend  gesetzt,  so  daG  auch  bei  unterschiedlicher  Bestiickung  der  beiden 
Banke  ein  durchgehender  RAM-Speicherbereich  vorliegt.  Das  “Schattenregister”  des  “mem¬ 
conf ’-Registers  befindetsich,  fiirdenProgrammiererbesser  zuganglich,  bei  den  Systemvaria- 
blen  als  Bytewert  (jedoch  nur  unteres  Nibble  interessant!)  an  Speicherstelle  $424  (Label: 
“memcntrl”).  Soviel  zum  RAM  des  ST! 


Nichtfliichtige  Speicherbereiche 

Wie  bereits  aus  dem  Bild  zur  Speicheraufteilung  des  ST  hervorgeht,  liegen  im  AdreGraum  der 
CPU  zwei  Speicherbereiche,  die  fur  ROM-Bestiickung  vorgesehen  sind.  Als  erstes  soil  der 
Bereich  ab  Adresse  $FC  0000  betrachtet  werden.  Hier  ist  ein  Speicherbereich  von  1 92  KByte 
fiir  das  Betriebssystem  (TOS)  des  ST  vorgesehen.  Inzwischen  werden  alle  ST-Systeme  mit 
Betriebssystem-ROMs  ausgeliefert. 

Die  260ST-  und  520ST+  -Rechner  enthielten  nur  zwei  8Kx8  Bit  “Boot-ROMs”  in  zwei  der 
insgesamt  sechs  vorgesehenen  Fassungen  fiir  die  Betriebssystem-ROMs.  Damit  konnte  das 
eigentliche  TOS  von  einer  Systemdiskette  in  den  RAM-Arbeitsspeicher  geladen  (gebootet) 
und  gestartet  werden.  Auf  diese  Weise  gehen  aber  immerhin  192  KByte  vom  RAM  fiir  das 
Betriebssystem  drauf !  Die  Boot-ROMs  belegen  den  AdreGraum  von  $FC  0000  bis  $FC  3FFF. 

In  diesen  16  KByte  ROM  ist  ein  Programmabschnitt  fiir  die  Grundsysteminitialisierung 
enthalten  sowie  Daten  fiir  die  Bildinformation,  die  vom  angeschlossenen  Monitor  wiederge- 
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Abb.  1 .6:  Pinbelegung  der  im  ST  verwendbaren  ROMs 


geben  wird,  wahrend  das  eigentliche  TOS  von  der  Systemdiskette  in  den  Arbeitsspeicher 
geladen  wird. 


Geballte  “Intelligenz”  sofort  verfiigbar  -  TOS  im  ROM 

Bei  den  von  ATARI  ab  Ende  1986  ausgelieferten  Rechnem  der  ST-Serie  ist  das  komplette 
Betriebssystem  in  sechs  ROM-Chips  der  Organisation  32K  x  8  Bit  oder  in  zwei  ROM-Chips 
der  Organisation  128K  x  8  Bit  enthalten.  Die  ROM-Chips  sind  von  ATARI  auch  als  Set  se- 
parat  erhaltlich,  so  da8  auch  altere  ST-Rechner  mit  ROM-TOS  nachgenistet  werden  konnen, 
die  Steckplatze  sind  ja  vorhanden. 

Mit  Erscheinen  der  MEGA  ST-Serie  wurde  erstmals  eine  neue  Version  von  ROM-TOS 
(Version  1 .02)  ausgeliefert,  welche  den  BLITTER  (deshalb  auch  als  BLITTER-TOS  bezeich- 
net)  und  den  neuen  Hardware-Uhr-Chip  unterstiitzt.  Eine  weitere,  iiberarbeitete  TOS-Version 
(1.04)  steht  seit  Mitte  Marz  1989  auf  ROMs  zur  Verfiigung. 

In  neueren  ST-Systemen  (sowohl  MEGA  ST  als  auch  1040ST(FM)  konnen  durch  geanderte 
Platinen-Layouts  erstmals  auch  Megabit-ROM-Chips  verwendet  werden. 
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Das  bedeutet,  daB  fur  das  TOSnurnochzwei  Chips  mitje  128K  x  8  BitKapazitaterforderlich 
sind  und  diese  noch  nicht  einmal  voll  ausgenutzt  werden!  In  Abbildung  1 .7  ist  der  Schaltungsaus- 
zug  wiedergegeben,  der  zeigt,  wie  die  Einbindung  der  Betriebssystem-ROMs  beim  MEGA 
ST  und  bei  Geraten  der  1040er-Serie  vorgenommen  wurde. 


Abb.  1.7:  Schaltung  der  ROM-Bank  fUr  MEGA  ST  und  1040STF(M) 
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Da  je  ROM-Chip  ein  Byte  pro  Adresse  angesprochen  wird,  bilden  immer  zwei  Chips  ein 
Parchen,  um  den  I6-Bit-Datenbus  mit  ROM-Informationen  zu  versorgen.  Wenn  256  KBit- 
ROMs  (oder  EPROMs)  verwendet  werden,  sind  alle  sechs  Chipfassungen  belegt.  Dabei  ist  die 
Aufteilung  des  AdreBraums  entsprechend  der  nachfolgenden  Tabelle  vorgenommen: 


AdreBbereich 

Chip-# 
MEGA  ST 

Chip-# 

1040ST 

Chip  aktiviert 
bei  Low  auf 

In  halt 

$FC  0000  bis 

U  10 

U  67 

_ROM2 

Low-Byte 

$FC  FFFF 

U  9 

U  63 

_ROM2 

High-Byte 

$FD  0000  bis 

U  7 

U  62 

JROM1 

Low-Byte 

$FD  FFFF 

U  6 

U  59 

JROM1 

High-Byte 

$FE  0000  bis 

U  4 

U  53 

_ROM0 

Low-Byte 

$FE  FFFF 

U  3 

U  48 

_ROM0 

High-Byte 

Die  Chip  Enable(_CE)-Information  auf  den  Leitungen  _ROMO.._ROM2  werden  dabei  vom 
GLUE-Chip  geliefert.  Je  nach  “gewiinschtem”  AdreBbereich  wird  somit  vom  GLUE  das 
entsprechende  ROM-Chip-Parchen  aktiviert. 

Bei  Verwendung  von  Megabit-ROMs  kommt  man  locker  mit  zwei  Chips  (2  x  128 
KByte  =  256KByte)  aus,  um  das  komplette  TOS  darin  unterzubringen.  Allerdings  muB  dazu 
natiirlich  dafilr  gesorgt  werden,  daB  sich  dieses  Chip-Parchen  iiber  den  gesamten  ROM- 
AdreBbereich  von  $FC  0000..$FE  FFFF  “angesprochen”  fiihlt  und  auch  alle  AdreBleitungen 
am  Chip  vorhanden  sind.  Das  Platinenlayout  beim  MEGA  ST  und  1040  STF(M)  ist  entspre¬ 
chend  ausgelegt.  Die  Mega-Bit-ROMs  miissen  dazu  in  die  Fassungen  fur  U63/U9  und  U67/ 
U10  eingesetzt  sein.  fiber  entsprechende  Lotbriicken  wird  die  korrekte  Einbindung  der  ROM- 
Chips  dann  folgendermaBen  vorgenommen  (siehe  dazu  Abbildung  1.7!): 

-  Briicke  “W2”  auf  Stellung  “1M”  versetzen,  um  die  AdreBleitung  A  1 7  der  CPU  an  die 
Megabit-ROM-Chips  (Pin  22  =  A  16-AnschluB  des  ROMs)  zu  fuhren.  (Bei  256KBit- 
ROMs  istderChipanschluB  (Pin  22)  das  “Output  Enable  (_OE)”-SignalundfestaufLow 
zu  legen.) 

-  Briicke  “W3”  ebenfalls  auf  Stellung  “  1M”  bringen.  Damit  wird  die  AdreBleitung  A  16 
der  CPU  an  Pin  1  (=  A  15-AnschluB)  der  Megabit-ROM-Chips  gefiihrt.  (Bei  256KBit- 
ROMs  ist  Pin  1  des  Chips  intern  nicht  angeschlossen,  bzw.  bei  EPROMs  muB  dort  +5V 
angelegt  werden.  Bei  eingelegter  Briicke  “  W3”  wird  an  alle  Pin  1  der  ROM-Fassungen 
+5V  angelegt!) 
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Die  Briicke  “W4”  darf  nicht  eingelegt  sein.  Das  3fach  NAND-Gatter  in  U12/U68  faBt 
dann  die  Signale  _ROMO.._ROM2  zu  einem  einzigen  “Chip  Enable  (_CE)”-Signal  fur 
die  Megabit-ROM-Chips  zusammen.  Damit  ist  gewahrleistet,  da  8  die  beiden  Megabit- 
ROMs  im  gesarnten  TOS-ROM-AdreBbereich  aktiviert  sind!  (Bei  256KBit-ROMs 
braucht  jedesROM-Parcheneineigenes  “Chip  Enable  (_CE)”-Signal(JROMO.._ROM2). 
Die  Funktion  von  U12/U68  ist  deshalb  durch  Auftrennen  der  Briicke  am  Ausgang  des 
NAND-Gatters  aufzuheben.  Wichtig !  Leider  ist  durch  einen  Platinen-Layout-Fehler  bei 
den  MEGA  STs  diese  Briicke  nicht  vorhanden.  Trennen  geht  also  hier  nur  durch  z.  B. 
Ausloten  des  gesarnten  Gatterbausteins  U12  Oder  durch  Kappen  des  Pins  12  von  U12!) 

In  Abbildung  1.7  ist  die  Bestiickung  der  Briicken  (sie  werden  im  MEGA  ST  iibrigens  durch 
0  OHM-Widerstande  realisiert!)  fur  256KBit-ROMs  eingezeichnet.  Wo  findet  man  nun  den 
Gatterbaustein  U12  (MEGA  ST)  bzw.  U68  (1040STF(M))  auf  der  Platine? 

Beim  MEGA  ST  befindet  sich  U1 2  in  der  linken,  unteren  Ecke  der  Platine,  direkt  links  neben 
der  Quadratischen  MMU.  In  derNahebefinden  sich  auch  die  Briicken  “W2”bis  “W4”!  Wegen 
der  vielen  Platinenversionen  beim  1 040STF(M)  kann  man  als  Anhaltspunkt  nur  sagen:  In  der 
Nahe  der  ROM-Fassungen  auf  die  Suche  gehen.  Die  Briicken  sind  beim  1040STF(M)  durch 
Lotspiegel  realisiert  und  wegen  der  Beschriftung  der  Platine  relativ  gut  zu  finden! 

Wiirde  ATARI  einen  anderen  GLUE-Chip  verwenden  (dieser  liefert  unter  anderem  die  Chip- 
Select-Signale  _ROMO.._ROM2  fiir  die  ROM-Chips),  so  lieBen  sich  in  den  6  Chip-Fassungen 
768  KByte  ROM  unterbringen.  Die  Schaltung  und  das  Platinenlayout  sind  dafiir  bereits  aus- 
gelegt! 

Nach  einem  RESET  oder  bei  einem  Kaltstart  ist  ein  Rechner  mit  ROM-TOS  also  sofort  “voll 
da”,  wahrend  dieser  Vorgang  mit  einem  von  Diskette  zu  ladenden  TOS  ca.  35  Sek.  dauert. 

AuBerdem  steht  bei  TOS  im  ROM  dann  natiirlich  ein  schones  Stiick  RAM  mehr  zur  Verfii- 
gung,  welches  ja  sonst  vom  einzuladenden  TOS-Betriebssystem  belegt  wird.  Es  ist  aber  auch 
mit  TOS  im  ROM  weiterhin  moglich,  Boot-Disketten  mit  z.  B.  modifizierten  Oder  neuen  TOS- 
Versionen  zu  starten. 


Das  Cartridge-System  des  ST 

Aber  nicht  nur  das  Betriebssystem  kann  in  ROMs  untergebracht  werden!  Der  AdreBraum  von 
$FA  0000  bis  $FB  FFFF  kann  durch  ein  ROM-Cartridge  (Einsteckplatine  mit  ROM-  bzw. 
EPROM-Chips)  belegt  werden,  welches  ein  oder  mehrere  Programme  enthalten  kann.  Es 
stehen  128  KByte  Speicherplatz  fiir  ein  solches  Cartridge  zur  Verfiigung.  Die  eventuelle 
Verwendung  solcher  Cartridges  ist  im  Betriebssystem  schon  vorgesehen  worden. 
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Der  Vorteil  von  Software  auf  Cartridge  liegt  einmal  in  der  schnellen  Handhabung,  denn  das 
Laden  vom  Massenspeicher  entfallt. 

Als  weitererPluspunkt  ist  anzufiihren,  dab  ja  kein  Platz  im  RAM  fair  diese  Software  benotigt 
wird.  Dies  gilt  jedoch  nur  dann,  wenn  die  Programme  auch  wirklich  im  Cartridge-ROM  ablau- 
fen  und  nicht  erst  liber  ein  Treiberprogramm  ins  RAM  kopiert  und  dann  dort  gestartet  werden 
(wie  es  z.  B.  bei  einer  RAM-Disk  gemacht  wird)! 


Ein  neues  Betriebssystem  fur  den  ST? 

Entsprechend  der  Behandlung  des  Cartridge- Anschlusses  in  der  Betriebssystem-Software  ist 
es  sogar  moglich,  mittels  Cartridge  ein  neues  Betriebssystem  auf  dem  ST  zu  fahren!  So 
existiert  bereits  als  Cartridge  das  Betriebssystem  “RTOS-UH”  (Realtime  Operating  System 
-  Uni  Hannover)  mit  Compiler  fur  die  Programmiersprache  “PEARL”.  Dieses  Betriebssystem 
erlaubt  das  komfortable  Bearbeiten  von  Echtzeit-Steuerungsaufgaben  bei  “gleichzeitiger” 
Ausfiihrung  mehrerer  Aufgaben  (Multitasking). 

Ein  sogenannter  MAC-Emulator,  mit  dem  das  Betriebssystem  des  Apple-Macintosh  erfolg- 
reich  auf  dem  ST  nachgebildet  wird,  ist  auch  mit  Cartridge-Unterstiitzung  erhaltlich!  Dazu 
werden  die  Original  Macintosh-ROMs  in  das  Cartridge  eingesetzt  und  mit  einer  Anpassungs- 
software  das  Betriebssystem  des  MAC  gestartet. 

AnschluBplatinen  fur  den  Einsatz  von  “selbstgebrannten”  EPROMs  mit  eigener  Software 
sowie  EPROM-Programmiergerate  zum  AnschluB  an  den  Cartridge-Slot  sind  ebenfalls  von 
Drittanbietem  lieferbar. 

Weiterhin  gibt  es  bereits  AnschluBplatinen  fur  den  Cartridge-Port,  mit  denen  die  128  KByte- 
Grenze  “durchstoBen”  wird.  512  KByte  und  mehr  an  residenter  Software  sind  mittels  Bank- 
Switching-Technik  am  Cartridge-Port  abrufbar.  Man  unterteilt  dazu  den  Speicherraum  von 
512  KByte  oder  mehr  in  einzelne  Blocke  von  z.  B .  64  KByte.  Eine  entsprechendeTreibersoftware 
(ebenfalls  auf  dem  Cartridge)  sorgt  dann  dafiir,  daB  die  CPU  im  Cartridge-AdreBraum  immer 
den  gerade  notwendigen  Block  “zu  sehen”  bekommt,  der  gerade  angesprochen  werden  soli. 

Im  TOS-Magazin  8/90  und  9/90  habe  ich  auBerdem  beschrieben,  wie  man  den  Cartridge-Port 
des  ST  als  I/O-Portfiir  einfache  Steuer-  und  Uberwachungsaufgaben  verwenden  kann.  Folgen- 
de  Signale  stehen  am  Cartridge-Port  zur  Verftigung: 

D0...D15  Der  16  Bit  breite  Datenbus  (ungepuffert!)  der  CPU 

A1...A15  Die  unteren  15  AdreBleitungen  (ungepuffert!)  der  CPU 
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Abb.  1 .8:  Die  Belegung  des  Cartridge-Anschlusses  (von  aufien  aufden  Anschlufi  gesehen) 


LDS/UDS  Lower-/Upper-Data  Strobe  (Aktiv=low!).  Dient  zur  Decodierung,  ob  Wort- 
oder  Einzelbyte-Zugriff  erfolgen  soil. 

ROM3  sel.  Wird  Low,  sobald  eine  Adresse  im  Bereich  von  $FB  0000  bis  $FB  FFFF  ange- 

sprochen  wird  (64  KByte-Block).  Als  “Chip-Select’-Signal  fur  die  ROM- 
Chips  eines  Cartridges  benutzbar. 

ROM4  sel.  Wird  Low,  wenn  eine  Adresse  im  Bereich  von  $FA  0000  bis  $FA  FFFF  aus- 
gelesen  wird  (64  KByte  Block).  Ebenfalls  als  “Chip-Select”  fur  Cartridge- 
ROM-Chips  benutzbar. 

+5V  Versorgungsspannung  fur  das  Cartridge 

GND  Masseanschlu8  fur  das  Cartridge 

Wer  bereits  mit  den  8-Bit-Computem  von  ATARI  gearbeitet  und  sich  mit  dem  dort  ebenfalls 
schon  realisierten  Cartridge-Konzept  beschaftigt  hat,  dem  wird  das  Prinzip  vertraut  vorkom- 
men. 

Gegenuber  dem  Cartridge-Slot  der  8-Bit-Rechner  hat  man  leider  beim  ST  nicht  mehr  die 
Moglichkeit,  in  das  Cartridge  zu  schreiben.  Es  ist  aber  nicht  so,  daB  fur  die  R/W-Leitung  kein 
Platz  mehr  gewesen  oder  diese  nur  “vergessen”  worden  ware. 
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Abb.  1.9:  So  konnte  die  Schaltung  fur  ein  128  KByte-Cartridge  aussehen 

Bei  jedem  Schreibversuch  in  den  AdreBbereich  $FA  0000  bis  $FE  FFFF  meldet  der  GLUE- 
Chip  der  CPU  einen  “BUS-ERROR”.  Schreibzugriffe  in  diesen  Bereich  sind  also  nicht 
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erwiinscht  und  vorgesehen!  AuBerdem  hat  ATARI  bei  der  Realisierung  des  Cartridge-Slots 
fur  die  Direktsteckvorrichtung  ein  uniibliches  RastermaB  von  2  mm  verwandt.  Warum  man 
hier  nicht  auf  dem  sonst  iiblichen  MaB  von  1/10  Inch  =  2,54  mm  geblieben  ist,  ist  nicht  ohne 
weiteres  nachvollziehbar. 

Von  Drittanbietem  sind  aber  Adaptersteckverbinder  von  2mm  ->  2,54mm  Raster  mit  zum  Teil 
Pufferbausteinen  fur  die  Adrefi-  und  Datenbussignale  lieferbar. 

AuBerdem  kann  der  Hardewarebastler  auf  Leerplatinen  zuriickgreifen,  die  zum  Aufbau  eige- 
ner  Schaltungen  am  Cartridgeport  verwendet  werden  konnen. 


Die  Behandlung  von  Cartridge-Software  durch  das  Betriefassystem 

Wie  bereits  erwahnt,  wird  vom  Betriebssy  stem  das  Vorhandensein  eines  Cartridges  schon  bei 
der  Systeminitialisierung  beriicksichtigt.  So  bestehen  verschiedene  Moglichkeiten,  aus  dem 
normalen  “Hochfahren”  des  Computersystems  “auszusteigen”  und  die  weitere  Kontrolle  iiber 
den  ST  an  die  Cartridge-Software  zu  iibergeben. 

Die  “Anwesenheit”  eines  Cartridges  wird  vom  Betriebssystem  durch  Lesen  des  ersten  Lang- 
wortes  ($FA  0000)  im  Cartridge-Speicherbereich  uberpriift.  Abhangig  von  dem  Wert  dieses 
“magischen  Langworts”  wird  evtl.  schon  direkt  nach  einem  RESET  die  Kontrolle  an  das 
Cartridge  iibergeben  oder  erst  zu  einem  spateren  Zeitpunkt.  Lautet  der  Inhalt  des  magischen 
Langworts  auf  SFA52  235F,  so  wird  nahezu  unmittelbar  nach  einem  System-RESET  nach 
Adresse  $FA  0004  im  Cartridge  verzweigt.  In  Register  A6  der  CPU  wird  jedoch  fur  den  Fall, 
daB  spater  die  normale  Systeminitialisierung  fortgesetzt  werden  soli,  eine  RETURN-Adresse 
mit  an  die  Cartridge-Software  iibergeben. 

Cartridge-Software,  welche  schon  zu  diesem  Zeitpunkt  die  “Herrschaft”  iiber  den  ST  iiber- 
nimmt,  muB  alle  Hardware-Komponenten  des  ST  selbst  initialisieren,  die  benutzt  werden  sol- 
len.  Anwendung  findet  dieser  friihzeitige  Ausstieg  aus  der  Systeminitialisierung  z.  B.  beim 
Gerate-Test  im  Reparaturservice. 

Mittels  eines  sogenannten  Diagnostic-Cartridge  ist  es  so  moglich,  den  ST  durchzuchecken. 
Es  werden  durch  die  Diagnose-Software  alle  Systemteile  angesprochen,  und  aus  entsprechen- 
den  Riickmeldungen  (oder  eben  auch  nicht! )  kann  auf  die  Funktionsfahigkeit  geschlossen  wer¬ 
den.  ImRegelfall  wird  Cartridge-Software  jedoch  auf  ein  voll  initialisiertes  System  zuriickgreifen 
wollen.  AuBerdem  lassen  sich  auf  einem  Cartridge  mehrere  Programme  unterbringen. 

In  so  einem  Fall  muB  bei  Adresse  $FA  0000  der  Inhalt  des  magischen  Langwortes  auf 
$ABCD  EE42  lauten.  AuBerdem  mtissen  im  Cartridge  noch  einige  Angaben  mehr  enthalten 
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sein.  So  istfiirjedesProgrammeinsogenannter“Programm-Vorspann”  (Cartridge-Application- 
Header)  erforderlich,  der  folgendermaBen  aufgebaut  sein  muB: 


Adresse 

Label 

Bedeutung 

$FA  6888 

CA-HAGIC 

'nagisches'  Langwort 

SFA  8884 

CA-NEXT 

Zeiger  auf  nachsten  Progrannkopf 

$FA  0888 

CA-INIT 

Zeiger  auf  Progranninitial isier . 

$FA  808C 

CA.RUN 

Progrannanf ang 

$FA  8818 

QA_TIME 

Erstel lungs-  Oder  anderungszeit 

$FA  8812 

CA-0ATE 

Erstellungs-  oder  anderungsdatun 

SFft  8814 

CA-SIZE 

Progranntange 

$FA  8818 

CA-NAME 

Progrannnane 

Adresse 

Inhalt 

Bedeutung 

CA-NEXT 

CA-NEXTl 

Zeiger  auf  nachsten  Progrannkopf 

*  $84 

CA-INITl 

Zeiger  auf  Progranninitislisier. 

+  $84 

CA-RUN1 

Progrannanf ang 

+  $84 

CA-TIME1 

Erstellungs-  Oder  Snderungszeit 

+  $82 

CA-DATE1 

Erstellungs-  Oder  tinderungsdatun 

+  $82 

CA-SIZE1 

Progrannlange 

t  $84 

CA-NAHEl 

Progrannnane 

Header 


Header 


Abb.  1.10:  So  sind  die  Programm-V 'orspanne  beim  ST-Cartiidge  aufgebaut 


Die  Label  haben  dabei  im  einzelnen  folgende  Bedeutung: 

CA„NEXT  Wenn  mehrere  Programme  auf  dem  gleichen  Cartridge  enthalten  sind,  enthalt 
CA_NEXT  einen  Pointer  auf  den  nachsten  Programmvorspann.  1st  nur  ein  Pro- 
gramm  vorhanden  oder  ist  der  betrachtete  Programmvorspann  der  letzte  auf 
dem  Cartridge,  steht  hier  $0000  0000! 

CAJNIT  Anfangsadresse  einerevtl.  Cartridge-Programm-Initialisierung.  Die  Bits  24.3 1 

bleiben  fur  die  Adressierung  unberiicksichtigt  und  enthalten  Informationen,  zu 
welchem  Zeitpunkt  der  ST-Systeminitialisierung  nach  CA_INIT  verzweigt 
werden  soil.  Ist  das  entsprechende  Bit  gesetzt,  so  erfolgt  Ausfiihrung. 

Bit  24  Initialisierung  oder  Start  der  Cartridge-Software  nach  erfolgter  Hardwareinitiali- 

sierung.  Die  Betriebssystemvariablen  und  Interruptvektoren  sind  schon  ge- 
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setzt.DieBildschirmauflosungistbereitsermitteltundeingestellt.  Die  Interrupts 
sind  jedoch  in  der  CPU  noch  gesperrt  (Interrupt-Priority-Level  auf  7). 

Bit  25  Initial  isierung  oder  Start  der  Cartridge-Software  wie  bei  gesetztem  Bit  24, 

jedoch  erst  unmittelbar  nach  Freigabe  der  Interrupts  in  der  CPU  (Interrupt-Prio¬ 
rity-Level  ist  dann  auf  3  gesetzt)  und  vor  der  GEMDOS-Initialisierung. 

Bit  26  Initialisierung  oder  Start  der  Cartridge-Software  etwas  friiher,  als  fur  Bit  24  be- 

schrieben.  Einstellung  der  aktuellen  Bildschirmauflosung  ist  noch  nicht  erfolgt. 

Bit  27  Cartridge-Programm-Initialisierung  oder  -Start  erfolgt  erst  unmittelbar  vor 

einem  evtl.  Disk-Boot.  Sonst  wie  bei  Bit  25. 

Die  Bits  29  ..31  sind  nur  dann  von  Bedeutung,  wenn  Cartridge-Programme  als  GEMDOS- 
Anwendungen  laufen.  (Es  ist  mir  allerdings  noch  nicht  gelungen,  Parameter  an  eine  TTP- 
Anwendung  im  Cartridge  zu  ubergeben,  wie  man  das  bei  “normalen”  TTP-Programmen 
problemlos  mittels  der  Dialogbox  bewerkstelligen  kann.  Die  Angaben  fur  die  Bits  29... 31 
beruhen  auf  Informationen  aus  dem  “Hitchhiker’s  guide  to  the  BIOS”  von  ATARI.) 

Bit  29  Programm  gehort  zum  Desktop  (Accessory) 

Bit  30  TOS-Applikation 

Bit  3 1  TOS-Applikation  mit  der  Moglichkeit,  Parameter  an  das  Programm  zu  iiberge- 

ben.  (TTP-Anwendung  =TOS  takes  Parameters) 

CA_RUN  AdressedesProgrammanfangseinesCartridge-Programms.Anderhierangege- 
benen  Adresse  beginnt  das  eigentliche  Programm.  Alle  evtl.  notigen  Initialisie- 
rungen  sind  schonerfolgt.  Nur  notig,  wenn  Programm  unter  GEMDOS  lauft. 

CA_TIME  Uhrzeit  der  Programmerstellung  im  Format  (dient  nur  zur  Information  des 
Benutzers). 

High-  Low- 

Byte  Byte 

hhhhhmmm  mmmsssss 

Sekunden  in  2er  Schritten  (0..29) 
Minuten  (0..59) 

Stunden  (0..23) 
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CA_D  ATE  Datum  der  Programmerstellung  im  Format  (dient  ebenfalls  nur  zur  Information 
des  Benutzers.) 

High-  Low- 

Byte  Byte 


YYYYYYYM  MMMDDDDD 


CA_SIZE  GroBe  des  Einzelprogramms.  Wird  eigentlieh  nicht  benotigt! 

CA_NAME  Name  des  Programms  im  GEMDOS-Format  (FILENAME.EXT+$00),  also 
max.  acht  Zeichen  fiir  den  Programmnamen,  evtl.  drei  Zeichen  fiir  die  Erweite- 
rung  mit  dazwischenliegendem  Trennungspunkt,  abgeschlossen  durch  $00. 
Nur  zur  Information  des  Benutzers. 

Cartridge-Programme,  die  unter  GEMDOS  laufen,  sind  auf  dem  virtuellen  Laufwerk  c:  zu 
finden  (der  Laufwerksbezeichner  ist  ein  kleines  “c”). 

Gestartet  werden  die  Programme  mit  dem  gewohnten  Doppelklick  auf  das  gewiinschte 
Programmsymbol.  Software,  die  im  Cartridge  laufen  soli,  muB  fiir  den  entsprechenden 
AdreBbereich  (ROM!)  geschrieben  sein,  in  dem  sie  spater  ablaufen  soil,  oder  voll  relokatibel 
angelegt  sein.  GEMDOS  hat  jakeine  Moglichkeit,  anhand  eines  Programm-Headers  irgend- 
welche  Adressen  im  TEXT-  oder  DATA-Bereich  im  Cartridge  (ROM!)  zu  relozieren. 

Cartridge-Programme,  die  RAM-Speicher  benotigen  (Pufferspeicher  u.a.),  miissen  sich  die- 
sen  Speicher  “zuteilen”  lassen  (iiber  die  GEMDOS-Funktion  “Malloc”)  und  selbst  verwalten. 
Ein  BSS-Bereich  (Bereich  fiir  nichtinitialisierte  Daten,  wie  er  z.  B.  fiir  Zwischenspeicherung 
von  Benutzereingaben  benutzt  wird)  ist  ja  im  ROM  schlecht  zu  realisieren! 

Beim  Aufruf  eines  Cartridge-Programms  legt  GEMDOS  auch  eine  Basepage  an,  die  aber  im 
wesendichen  nur  die  Startadresse  des  Programms  und  einen  Pointer  auf  den  Anfang  der 
eigenen  Basepage  sowie  die  Basepage  des  aufrufenden  Programms  enthalt. 


Soviel  zum  Cartridge-Slot  des  ST. 
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Abb.  1.11:  So  erscheinen  Cartridge-Programme  auf  dem  Desktop 


DMA  im  ST 


Die  Konstrukteure  des  ATARI  ST  haben  der  CPU  einen  tatkraftigen  Heifer  zur  Seite  gestellt, 
der  zwar  nicht  besonders  viel  “Intelligenz”  besitzt,  dafiir  aber  ganz  schon  schnell  arbeiten 
kann. 

Es  handelt  sich  hierbei  um  eine  DMA-Einheit,  die  von  ATARI  ebenfalls  speziell  fiir  die  ST- 
Serie  entwickelt  wurde.  Mittels  DMA  =  Direct  Memory  Access  (zu  deutsch  etwa:  direkt  auf 
den  Hauptspeicher  zugreifend)  ist  es  moglich,  groGeDatenmengen  von  und  zu  Peripheriegeraten 
wie  z.  B.  Floppy-Disk-  und  Hard-Disk-Stationen  ohne  Um  wege  fiber  die  CPU  und  deren  Regi¬ 
ster  zu  transportieren.  Der  DMA-Baustein  kann  dabei  gleichberechtigt  mit  der  CPU  auf  das 
RAM  zugreifen.  Wer  zuerst  kommt,  darf  an  die  Daten! 


Datentransfer  mit  Turbolader 

Durch  den  DMA-Baustein  bedient  der  ST  den  Floppy-Disk-Controller  (FDC)  und  das  soge- 
nannte  ACSI  (ATARI  Computer  System  Interface).  Der  Datenstrom  vom  und  zum  Floppy- 
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Disk-Controller  konnte  mit  einer  Transferrate  von  bis  zu  500  KBit/Sekunde  “flicBen”,  wobei 
der  eingebaute  FDC  jedoch  nur  eine  Ubertragungsrate  von  250  KBit/s  verkraftet.  Beim  ACSI 
handelt  es  sich  um  einen  8  Bit  breiten  Bus  zum  AnschluB  von  schnellen  Peripheriegeraten  wie 
z.  B,  eine  Festplatte  oder  einen  Laserdrucker.  Die  Datentransferrate  betragthierbei  immerhin 
8MBits/Sek(beiderHarddisk-ca.  12MBits/Sek  sindaberdurchaus  noch  drin,wenn  das  Peri- 
pheriegerat  da  mitkommt!). 

Die  CPU  allein  wiirde  dabei  schon  ganz  schon  ins  Sch  witzen  geraten  und  hatte  kaum  noch  Zeit 
fur  andere  “Hobbys”.  Durch  Verwendung  der  DMA-Einheit  ist  es  nun  nur  noch  erforderlich, 
diese  entsprechend  zu  “informieren”,  wo  die  zu  transportierenden  Daten  im  RAM  abgelegt 
oder  geholt  werden  (Startadresse)  und  wie  viele  Daten  (Blocks  zu  je  5 12  Bytes)  zum  oder  vom 
Peripheriegerat  iibertragen  werden  sollen. 

Damit  die  DMA-Einheit  uberhaupt  wirkungsvoll  arbeiten  kann,  ist  sie  darauf  ausgelegt, 
Datenblocke  mit  5 1 2  B  y  tes  (beim  ST  ist  das  sinnvollerweise  die  GroBe  eines  Datensektors  auf 
Disk)  oder  einem  Vielfachen  davon  zu  iibertragen. 

Die  weitere  Abwicklung  der  Dateniibertragung  liegt  nun  bei  der  DMA-Einheit,  so  daB  die  CPU 
mit  anderen  Aufgaben  beschaftigt  werden  kann  (vom  TOS  wird  diese  Moglichkeit  leider  nicht 
ausgenutzt!). 


Die  Halfte  reicht  auch 

Wie  das  Blockschaltbild  zeigt,  wird  der  16  Bit  breite  Datenbus  des  Hauptspeichers  durch  die 
DMA-Einheit  auf  einen  8  Bit  breiten  Datenbus  reduziert.  Die  Umsetzung  eines  16  Bit-Daten- 
wortes  in  zwei  aufeinanderfolgende  8-Bit-Datenworte  erledigt  die  DMA-Einheit  automa- 
tisch.  Ein  16  Bit  breiter  Bus  auf  der  Peripheriegerateseite  ist  auch  nicht  erforderlich,  da  der 
Floppy-Disk-Controller  (FDC)  nur  liber  einen  8-Bit-Datenbus  verfligt. 

Der  ACSI-AnschluB  ist  wegen  seiner  Anlehnung  an  den  verbreiteten  SCSI-Bus  (SCSI = Small 
Computers  System  Interface)  ebenfalls  nur  8  Bit  breit  ausgefallen. 

Die  DMA-Einheit  verfiigt  intern  iiberfUnf  Register,  mit  denen  die  Steuerung  desDatentransfers 
zum/vom  Floppy-Disk-Controller  und  dem  ACSI-Bus  eingestellt  werden  kann.  Ein  32  Byte 
groBer  Puffer  nach  dem  FIFO-Prinzip  (First  In,  First  Out  =  zuerst  eingebrachte  Daten  werden 
auch  zuerst  abgeholt)  in  der  DMA-Einheit  iibemimmt  die  Pufferung  zwischen  dem  Hauptspei- 
cher  und  dem  Floppy-Disk-Controller/ACSI-Bus. 

AuBerdem  geschieht  dortdie  Umsetzung  eines  16-Bit-Datenwortes  in  zwei  8-Bit-Datenworte 
und  umgekehrt. 
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Abb.  1.12:  Die  DMA-Einheit  bedient  den  FDC  und  den  ACSI-Bus 


Hierbei  ist  zu  beachten,  daB  ein  Transfer  zwischen  DMA-Einheit  und  Hauptspeicher  immer 
erst  dann  erfolgt,  wenn  der  Fifo-Buffer  zu  mehr  als  zur  Halfte  gefiillt  ist. 

Die  DMA-Einheit  versucht  dann,  die  Buskontrolle  zu  ubemehmen  und  16  Bytes  zu  iibertra- 
gen.  EineUbertragung  erfolgt  also  immer  in  Bursts  zu  je  1 6Byte!  Bei  Datentransfers  in  Sektor- 
groBe  (512  Bytes)  braucht  man  darauf  nicht  so  sehr  zu  achten. 

Will  man  jedoch  weniger  als  einen  Sektor  (512  Bytes)  von  Disk  lesen,  also  z.  B .  nur  AdreBfel- 
der  (die  sind  nur  6  Bytes  lang),  so  sollten  mindestens  drei  dieser  Felder  gelesen  werden,  um 
auf  eine  Bytezahl  von  iiber  16  zu  kommen.  Sonstbleiben  die  gelesenen  Daten  im  Fifo-Buffer 
hangen,  und  man  wundert  sich  nach  einer  anscheinend  doch  korrekt  ausgefuhrten  DMA-Ope- 
ration,  daB  keine  Daten  im  Hauptspeicher  angekommen  sind. 


So  wie  in  der  Abbildung  1.13  dargestellt,  kann  man  sich  ungefahr  das  Innenleben  der  DMA- 
Einheit  des  ST  vorstellen. 
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Abb.  1.13:  So  ist  die  DMA-Einheit  im  Prinzip  aufgebaut 


Fur  die  Steuerung  der  Peripheriebausteine  wie  FDC  und  ACSI-Bus  sind  unter  anderem  die  CR / 
W-Leitung  (Controller  Read/Write  =  Lesen/Schreiben-Signalisierung  fur  FDC  oder  ACSI- 
Bus  (bei  Low  erfolgt  Schreibzugriff))  und  die  HDCS-Leitung  (Hard  Disk  Controller  Select 
=  ACSI-Bus-Zugriffssignalisierung)  notig. 

liber  die  FDCS-Leitung  wird  dem  Floppy-Controller-Chip  ein  Zugriff  signalisiert  (Floppy- 
Disk-Controller-Select).  DieCAl/CA2-Leitungen  dienen  als  AdreOleitungcnzurRegisteraus- 
wahl  beim  FDC-Chip  oder  zur  Command-Byte-Signalisierung  am  ACSI-Bus. 

Wie  man  sieht,  wird  durch  den  Zustand  der  R/W-Leitung  am  Eingang  der  DMA-Einheit 
entschieden,  ob  ein  Zugriff  auf  das  DMA-Mode-Register  oder  das  DMA-Status-Register 
erfolgt.  So  kann  das  DMA-Status-Register  nur  ausgelesen  und  das  DMA-Mode-Register  nur 
beschrieben  werden.  Beide  Register  sind  im  Speicherraum  des  ST  unter  der  gleichen  Adresse 
zu  fmden! 

Durch  das  Bit  4  im  DMA-Mode-Register  laBt  sich  steuern,  ob  auf  das  Controller-Access- 
Register  oder  das  Sector-Counter-Register  zugegriffen  werden  soil.  Diese  beiden  Register 
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konnen  sowohl  beschrieben  als  auch  ausgelesen  werden  und  belegen  ebenfalls  nur  eine 
Adresse. 

Die  einzelnen  Register  haben  nun  folgende  Funktionen: 

DMA-Base-  und  Counter-Register 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8609 

R/W 

High-Byte  DMA-Base-  und  Counter-Register 

“dmahigh” 

$FF  860B 

R/W 

Mid-Byte  DMA-Base-  und  Counter-Register 

“dmamid” 

$FF  860D 

R/W 

Low-Byte  DMA-Base-  und  Counter-Register 

“dmalow” 

Diese  drei  jeweils  8  Bit  breiten  Register  werden  zu  Beginn  des  Datentransfers  mit  der  Start- 
adresse  des  zu  ubertragenden  Datenbereichs  geladen.  (Wichtig!  Reihenfolge  des  Zugriffs: 
Low-,  Mid-,  High-Byte!) 

Im  DMA-Betrieb  werden  die  Register  von  der  DMA-Einheit  nach  jedem  ubertragenen 
Datenwort  automatisch  weitergezahlt.  Die  drei  Register  bilden  zusammen  also  einen  Pointer 
auf  das  jeweils  nachste  zu  iibertragende  Datenwort  vom  bzw.  zura  Hauptspeicher. 

Controller-Access-Register 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8604 

R/W 

Durchgriff  auf  FDC-Register/ACSI-Bus 

“disked” 

Dieses  Register  ist  nur  zuganglich,  wenn  Bit  4  im  DMA-Mode-Register  “0”  ist!  Wenn  man 
hier  Daten  einschreibt,  werden  diese  von  der  DMA-Einheit  an  eines  der  FDC-Register 
weitergereicht  oder  auf  den  ACSI-Bus  ausgegeben.  Ein  Lesezugriff  auf  diese  Adresse  ergibt 
den  Inhalt  eines  der  FDC-Register  oder  eines  Bytes  vom  ACSI-Bus. 

Ein  Durchgriff  auf  FDC-Register  erfolgt,  wenn  Bit  3  im  DMA-Mode-Register  “0”  ist. 
Welches  FDC-Register  man  im  Zugriff  hat,  legen  dann  Bit  1  und  2  im  DMA-Mode-Register 
fest  (diese  steuem  die  “AdreBleitungen”  CA 1  und  CA2  fur  die  FDC-Register).  Das  Controller- 
Access-Register  hat  zwar  Wortbreite,  ftir  FDC-Register-Zugriffe  sind  jedoch  nur  die  unteren 
8  Bit  relevant  (8-Bit-Bus  zum  FDC)! 

Fur  einen  Zugriff  auf  den  ACSI-Bus  muB  Bit  3  des  DMA-Mode-Register  gesetzt  sein.  Beim 
Durchgriff  auf  den  ACSI-Bus  ist  auch  hier  wieder  nur  das  niederwertige  Byte  des  Registers 
“disked”  relevant! 
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Sector-Counter-Register 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8604 

R/W 

Zahler  fiir  Datenblocke  in  SektorgroBe 

“disked” 

Uber  dieses  Register  wird  der  DMA-Einheit  mitgeteilt,  wie  viele  Blocke  (Sektoren)  zu  je  512 
Bytes  vom  bzw.  zum  FDC/ACSI-Bus  iibertragen  werden  sollen.  Der  Zugriff  auf  dieses  Regi¬ 
ster  ist  nur  moglich,  wenn  im  DMA-Mode-Register  das  Bit  4  gesetzt  ist!  Da  dieses  Register 
nur  8  Bit  breit  ist,  karat  man  in  einem  Rutsch  nur  255  *  512  =  127,5  KBytes  iibertragen. 

Bei  groBeren  Datenmengen  muB  man  also  mehrere  “Pakete”  direkt  hintereinander  versenden. 
Durch  das  Bescltreiben  dieses  Registers  wird  der  DMA-Vorgang  intern  schon  gestartet.  So 
wird  die  DMA-Einheit  bei  einem  Schreibvorgang  auf  Floppy  oder  ACSI-Bus  schon  mal 
beginnen,  den  Fifo-Buffer  aus  dem  Hauptspeicher  mit  Daten  zu  fiillen. 

Wenn  dann  die  DMA-Freigabe  durch  Loschen  von  Bit  7  im  DMA-Mode-Register  erfolgt, 
reagiertdie  DMA-Einheit  auch  auf  Datenanforderungen  vomFDC  (FDRQ =Floppycontroller- 
Data-Request)  oder  ACSI-Bus  (HDRQ  =  Harddiskcontroller-Data-Request). 


DMA-Status-Register 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8606 

R 

Status  der  ausgefiihrten  DMA-Operation 

“fifo” 

Nur  die  unteren  3  Bits  dieses  16-Bit-Registers  werden  fur  Zustandsinformationen  uber  eine 
DMA-Operation  benutzt. 

Die  Bits  sindLow-aktiv,  d.  h.,  wenn  der  genannte  Zustand  aufgetreten  ist,  wird  das  Bit  auf  “0” 
zuriickgesetzt! 


Bit 


Bedeutung 


0  Der  “Turbolader”  hatte  eine  Funktionsstorung. 

Es  ist  ein  Fehler  wahrend  der  DMA-Operation  aufgetreten. 

1  Das  Sector-Counter-Register  ist  bis  auf  Null  heruntergezahlt. 

2  DATA  REQUEST  von  FDC/ACSI-Bus  ist  inaktiv. 
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Die  Bits  1  und  2  werden  jedoch  vom  Betriebssystem  rticht  benutzt.  Vor  einem  Zugriff  auf  das 
DMA-Status-Register  soilte  It.  ATARI-Information  immer  erst  das  Sector-Counter-Register 
selektieit  werden  (Bit  4  in  DMA-Mode-Register  setzen)! 

DMA-Mode-Register 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8606 

W 

“Kommando”-Register  fiir  die  DMA-Einheit 

“fifo” 

Die  Bedeutung  der  einzelnen  Bits  ist  in  Abbildung  1.14  erlautert. 
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PNfl-Mode  Register 


Diese  beidert  Bits  steuern  die 
Leitungen  CA1/CA2  der  DMA-Ein- 
heit.  Sie  werden  zur  Register- 
auswahl  bein  FDC  bzw .  zur  ACSI- 
Bus-Steuerung  benotigt. 


Es  erfolgt  ein  Zugriff  auf 
eines  der  Per i pher i ereg ister : 


1  = 
0  = 


hlsi-hus  Kegisterzugr 
FDC-Beg ister zugr if f 


Bestinnt  ob  auf  Sector  Counter  Reg. 
Oder  Controller  Access  Reg.  zuge- 
griffen  werden  kann . 

1  =  Sector  Counter  Register 
0=  Controller  Access  Reg. 


DMA-interne  Uerwendung  (=01 


DMA  nit  FDC  Oder  ACSI-Bus 

0  =  DMA  nit  ACSI-Bus 
1  =  DMA  nit  FDC 


DMA-Datentransportr ichtung 


DMA-Einh. 
DMA-Einh . 


schreibt  an  Peripherie 
liest  won  Peripherie 


Abb.  1.14:  Das  DMA-Mode-Register 


Das  Bit  8  (DMA-Datentransport-Richtung)  bat  noch  eine  besondere  Funktion  in  Verbindung 
mit  dem  FIFO-Buffer.  Da  der  FIFO-Buffer  nicht  automatisch  zu  Beginn  einer  jeden  neuen 
DMA-Operation  geloscht  wird,  hat  der  Programmierer  selbst  fiir  “saubere”  Verhaltnisse  zu 
sorgen.  Durch  “Klappem”  (Wechseln  des  Zustands)  mitBit  8  des  DMA-Mode-Registers  wird 
namlich  der  Fifo-Buffer  geloscht  und  die  DMA-Einheit  auf  einen  DMA-Transfer  vorbereitet! 
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Das  Loschen  des  FIFO-Buffers  wird  sinnvollerweise  gleichzeitig  mit  dem  Einstellen  der 
DMA-Dateniibertragungs-Richtung  durchgefiihrt.  Beispiel: 

move.w  #$090, dma_mode  ;  Diese  Befehlssequenz  loscht  den 
move.w  #$190,dma_mode  ;  FIFO-Buffer  in  der  DMA-Einheit 

move.w  #$090,dma_mode  ;  und  schaltet  diese  auf  Lesen 

(Bei  Schreibzugriffen  ist  entsprechend  gegensatzlich  zu  verfahren!)  Soviel  an  dieser  Stelle 
zur  DMA-Einheit  des  ATARI  ST.  Weitere  Informationen  sind  bei  der  Beschreibung  des 
Floppy-Disk-Interface  und  des  ACSI-Busses  zu  finden. 


Der  Systembus  des  MEGA  ST 

Erstmals  bei  den  Geraten  der  MEGA  ST-Serie  hat  ATARI  die  Moglichkeit  vorgesehen, 
Erweiterungen  des  Systems  vorzunehmen.  So  wurde  im  GehSuse  des  MEGA  ST  Platz  gelas- 
sen,  um  eine  zusatzliche  Erweiterungskarte  unterzubringen.  Die  Karte  wird  liegend  iiber  die 
Hauptplatine  (Mainboard)  montiert  (in  der  linken  Gehausehalfte).  Dabei  konnen  zwei  ver- 
schiedene  Typen  von  Erweiterungskarten  eingebaut  werden.  Die  sogenannte  “Half  Card”  hat 
die  Abmessungen  137  x  145  mm,  wahrend  die  “Full  Card”  ca.  137  x  280  mm  groB  ist. 

In  beiden  Fallen  ist  an  der  Gehauseriickseite  eine  Befestigungsmoglichkeit  fiir  die  Karten 
vorgesehen.  AuBerdem  kann  ein  bereits  vorbereiteter  Ausschnitt  der  Gehauseruckwand  ent- 
femt  werden,  um  so  Platz  fiir  AnschluBbuchsen  oder  -kabel  zu  erhalten. 

Weitere  Stabilitat  fiir  die  Erweiterungskarte  ergibt  sich  durch  die  Befestigung  der  Karte  mit 
Abstandshaltem  im  Gehauseboden  des  MEGA  ST.  Entsprechende  Aussparungen  in  der 
Hauptplatine  des  MEGA  ST  und  Locher  zur  Aufnahme  der  Befestigungsschrauben  im  Gehau¬ 
seboden  sind  bereits  vorgesehen. 

Die  elektrischeVerbindungerfolgtilbereine64pol.Steckverbindung.  An  der  Erweiterungskarte 
sitzt  auf  der  Lotseite  eine  zweireihige  Federleiste  (Buchse)  nach  DIN  41612,  Bauform  B.  Auf 
dem  Mainboard  des  MEGA  ST  befindet  sich  das  Gegenstiick  dazu,  eine  zweireihige  Messer- 
leiste. 


Pinbelegung  des  MEGA  ST-Systembusanschlusses 

An  den  64  Anschliissen  des  Erweiterungsanschlusses  stehen  im  Prinzip  alle  Signale  der 
68000er-CPU  zur  Verfiigung.  D.  h.,  daB  sowohl  der  komplette  AdreB-  als  auch  der  Datenbus 
und  alle  wesentlichen  Steuer-  und  Meldeleitungen  herausgefiihrt  sind! 
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Die  Einbindung  des  Systembusanschlusses  (im  folgenden  kurz  Megabus  genannt)  in  die 
Hardware  des  MEGA  ST  zeigt  der  Sehal  tungsauszug  in  Abbildung  1 . 1 5 .  Alle  Ausgangssignale 
sind  ungepuffert  und  konnen  einen  LS-TTL-Eingang  treiben. 

Das  Signaltiming  am  Megabus  ist  das  einer  normalen  68000er-CPU  mit  einem  Takt  von  8 
MHz.  Deshalb  konnen  periphere  Einheiten  auch  ohne  Probleme  so  angeschlossen  werden,  wie 
sie  an  eine  normale  68000er-CPU  angeschlossen  wiirden.  Natiirlich  kann  die  Logik  auf  der 
Erweiterungskarte  auch  die  Bussteuerung  ubemehmen,  wenn  sie  sich  an  das  gleiche  Protokoll 
halt,  als  wenn  sie  an  eine  68000er-CPU  angeschlossen  wiirde. 

Dazu  muB  dem  augenblicklich  aktiven  Busmaster  (das  ist  die  Einheit,  welche  gerade  die 
Kontrolle  iiber  die  Bussteuerung  besitzt,  also  in  der  Regel  die  CPU)  mit  einem  Low  auf  der 
BR-Leitung  (BR  =  Bus-Request  =  Anfrage  fiir  Busiibernahme)  signalisiert  werden,  dafi  eine 
andere  intelligente  Einheit  die  Bussteuerung  ubemehmen  will. 


Abb.  1.15:  Anschlufibelegung  des  Systembusses  im  MEGA  ST 
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Der  Busmaster  gibt  mit  einem  Low  auf  der  BG-Leitung  (Bus-Grant  =  Buszuteilung)  an  die 
anfragende  Einheit  sozusagen  sein  Einverstandnis,  daB  nach  Beendigung  des  gerade  laufen- 
den  Buszyklusses  die  Bussteuerung  abgegeben  wird.  Jetzt  wartet  die  anfragende  Einheit,  bis 
der  laufende  Buszyklus  beendet  ist  (AS  =  Adress-Strobe  geht  dairn  auf  High,  und  DT  ACK  muB 
ebenfalls  auf  High  sein!),  und  iibemimmt  dann  die  Bussteuerung,  indent  sie  als  neuer  Bus- 
master  jetzt  ein  Low  auf  die  BGACK-Leitung  (Bus-Grant- Acknowledge  =  Quittung  fiir  Bus¬ 
zuteilung)  legt  und  die  BR-Leitung  wieder  auf  High  setzt.  BGACK  muB  fiir  mindestens  einen 
Buszyklus  des  neuen  Busmasters  auf  Low  bleiben.  Der  neue  Busmaster  behalt  die  Bussteue¬ 
rung  so  lange,  wie  er  BGACK  auf  Low  halt. 

Im  MEGA  ST  sind  bereits  zwei  Einheiten  an  der  Arbeit  (DMA-Baustein  und  BLITTER), 
welche  ebenfalls  von  Zeit  zu  Zeit  als  Busmaster  auftreten.  Deshalb  mud  eine  weitere  Einheit, 
die  in  der  Lage  ist ,  die  Bussteuerung  zu  tibemehmen,  sich  den  Bus  mit  den  bereits  vorhandenen 
Einheiten  teilen,  Dazu  wird  das  Signal  BGO  (B  us-Grant-Out)  an  Pin2 1  des  Megabusanschlusses 
benutzt.  Das  BGO-Signal  am  Megabus  wird  nicht  direkt  von  der  CPU,  sondem  vom  GLUE 
erzeugt  und  beriicksichtigt  bereits  die  anderen  DM  A-Bausteine  im  Mega  ST,  die  ebenfalls  die 
Bussteuerung  tibemehmen  konnen  (Daisy-Chaining = Verkettung  unter  Berticksichtigung  der 
Prioritaten  von  ST-DMA-Einheit,  BLITTER  und  intelligenter  Einheit  am  Megabus). 

Sind  die  Interrupts  fiir  die  68000er-CPU  nicht  gesperrt,  sollte  gewahrleistet  sein,  daB  ein 
anderer  Busmaster  als  die  CPU  den  Bus  nicht  langer  als  jeweils  ca.  50  Buszyklen  beansprucht, 
um  noch  eine  einigermaBen  niedrige  Reaktionszeit  auf  Interruptanfordemngen  zu  erhalten! 

Liegt  die  Bussteuerung  bei  der  Erweiterung  am  Megabus,  miissen  die  Buszyklen  exakt  wie 
die  einer  mit  8  MHz  arbeitenden  68000er-CPU  ausgefiihrt  werden,  da  sonst  S  torungen  mit  dem 
Video-Controller  auftreten  konnen.  Die  Zugriffe  des  Video-Controllers  auf  das  RAM  miissen 
auch  unter  einem  anderen  Busmaster  wie  gewohnt  ablaufen  konnen. 

Nun  noch  eine  kurze  Beschreibung  der  einzelnen  Anschliisse  des  Megabusses: 

CLK  1:1  Rechteck-TTL-Taktsignal  mit  einer  Frequenz  von  8.0106  MHz. 

RESET,  HALT  Diese  Anschliisse  dienen  zur  Initialisierung  des  Prozessors  und  des 

gesamten  Systems.  Die  Anschliisse  sind  bidirektional.  RESET  ist  auf 
demMainboardmiteinem  lK-Pullup-Widerstand  abgeschlossen,HALT 
mit  einem  4K7-Pullup-Widerstand. 

Fiihrt  die  68000er-CPU  den  Befehl  RESET  (CPU-Status  und  -Register  bleiben  unbeeinfluBt) 
aus,  wird  die  RESET-Leitung  fiir  ca.  1 5  pSek.  (124  Taktzyklen)  auf  LOW  gezogen  und  setzt 
damit  exteme  Bausteine  zuriick.  Kommt  das  RESET-Signal  von  einem  anderen  Baustein,  so 
wird  die  CPU  zuriickgesetzt. 
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Die  CPU  zieht  den  HALT-AnschluB  auf  LOW,  um  damit  auf  ihren  Funktionsstillstand 
hinzuweisen,  den  sie  einnimmt,  weil  z.  B.  ein  doppelter  Busfehler  aufgetreten  ist. 

Wird  der  HALT-AnschluB  von  auBen  auf  LOW  gebracht,  stellt  die  CPU  am  Ende  eines  laufen- 
den  Buszyklus  alle  weiteren  Tatigkeiten  ein  und  versetzt  alle  Leitungen  in  den  hochohmigen 
Zustand. 

Ein  System-RESET  erfolgt  durch  LOW-Setzen  beider  Leitungen  RESET  und  HALT  beim 
Einschalten  oder  durch  Druck  auf  den  RESET-Knopf.  Der  Einschaltreset  Oder  der  Druck  auf 
den  RESET-Knopf  veranlaBt,  daB  beide  Leitungen  fur  ca.  130  msec  auf  LOW  gezogen  wer- 
den. 

A1  -  A23  Der23-Bi£-AdreBbusdirektvonderCPU.  AufdemMainboardsinddie 

AdreBleitungen  mit  4K7-Pullup-Widerstanden  abgeschlossen. 

DO  -  D 1 5  Der  1 6-Bit-Datenbus  (bidirektional)  der  CPU.  Auf  dem  Mainboard  mit 

1  OK-Pullup-Widerstanden  abgeschlossen. 

FCO,  FC1 ,  FC2  Funktionscode-Leitungen  von  der  CPU.  Siegebenden  Betriebszustand 

des  Prozessors  fur  den  laufenden  Buszyklus  an.  Abgeschlossen  sind 
diese  direkt  von  der  CPU  kommenden  Leitungen  auf  dem  Mainboard 
mit  lOK-Pullup-Widerstanden. 

AS  Adress-Strobe.  Bei  LOW  signaliert  diese  Leitung  gultige  AdreBinforma- 

tionen  auf  dem  AdreBbus.  4k7-Pullup  auf  Mainboard! 

R/W  Read/Write-Leitung.  LOW  zeigt  einen  Schreibzyklus,  HIGH  einen 

Lesezyklus  an.  4k7-Pullup  auf  Mainboard! 

UDS.LDS  Upper-Data-Strobe,  Lower-Data-Strobe.  LOW  an  UDS  signalisiert 

gultige  Informationen  auf  dem  hoherwertigen  Byte  des  Datenbusses. 
LOW  an  LDS  zeigt  gultige  Daten  auf  dem  niederwertigen  Byte  des 
Datenbusses  an.  Bei  einem  Wortzugriff  sind  beide  Leitungen  auf  LOW. 
Beide  Leitungen  sind  mit4k7-Pullups  auf  dem  Mainboard  abgeschlos¬ 
sen! 

Data-lransfer-ACKnowledge.  Bidirektionaler  AnschluB  (Open  Collec¬ 
tor).  Mit  einem  LOW  wird  einDatentransfer  bestatigt.  Ein  Erweiterungs- 
baustein,  dem  Daten  von  der  CPU  zugeschrieben  werden,  muB  der  CPU 
den  Empfang  der  Daten  mit  einem  LOW  auf  dieser  Leitung  bestatigen. 


DTACK 
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BERR 


E 


VPA 


VMA 


BR 


BGO 


1st  die  periphere  Einheit  auf  der  Erweiterungskarte  Busmaster,  so  muB  diese 
an  der  DTACK-Leitung  “lauschen”,  ob  der  Datenaustauschkorrekt  abgelau- 
fen  ist.  Mit  einem  lK-Pullup-Widerstand  ist  diese  Leitung  auf  dem  Main- 
board  abgeschlossen. 

Bus  Error.  Zeigt  der  CPU  oder  einer  DMA-Einheit  an,  das  keine  periphere 
Einheit  auf  den  laufenden  Buszyklus  reagiert  hat.  Beim  ST  wird  automa- 
tisch  nach  64  Taktzyklen  diese  Leitung  auf  LOW  gesetzt,  wenn  bis  dahin 
keine  Reaktion  von  einem  angesprochenen  Peripheriebaustein  erfolgt  ist. 
Diese  Open-Collector-Leitung  der  CPU  ist  mit  einem  4K7-Pullup-Wider- 
stand  auf  dem  Mainboard  abgeschlossen. 

Enable  Clock.  Dient  zur  Synchronisation  beim  AnschluB  von  Peripheriebau- 
steinen  der  6800-Serie.  Dieser  Takt  ist  mit  dem  8  MHz-Taktfest  verkniipft. 
Fiir  sechs  Taktzyklen  des  CLK-Signals  ist  E  auf  LOW,  dann  wieder  auf 
HIGH  fiir  vier  Taktzyklen  (also  ein  Takt  von  ca.  0,8  MHz). 

Valid  Peripheral  Address.  Der  CPU  wird  mit  einem  LOW  iiber  diese  Lei¬ 
tung  mitgeteilt,  das  ein  synchron  arbeitender  Baustein  (z.  B.  Peripheriebau¬ 
stein  der  68XX-Serie)  adressiert  wurde.  AbschluB  mit  2K2-Pullup-Wider- 
stand  auf  dem  Mainboard. 

Valid  Memory  Address.  Die  CPU  reagiert  damit  auf  die  Anforderung 
(durch  LOW  an  VPA)  nach  einem  synchronen  Buszyklus  und  meldet  mit 
einem  LOW  iiber  VMA,  daB  sie  nun  auf  den  E-Takt  synchronisiert  ist.  4K7- 
Pullup  auf  Mainboard! 

Bus  Request.  Mit  einem  LOW  wird  der  CPU  hier  mitgeteilt,  daB  ein  anderer 
Baustein  die  B  ussteuerung  tibemehmen  mochte.  Auf  dem  Mainboard  ist  die 
Leitung  mit  einem  4K7-Pullup-Widerstand  abgeschlossen.  ATARI  emp- 
fiehltebenfallseinen4K7-Pullup-AbschluBwiderstandaufderErweiiErungs- 
karte. 

Bus  Grant  Out.  Der  Einheit  auf  der  Erweiterungskarte,  welche  die  Bussteue- 
rung  angefordert  hat  (mit  LOW  auf  der  BR-Leitung)  wird  mit  einem  LOW 
signalisiert,  daB  sie  die  Bussteuerung  nach  AbschluB  des  laufenden  Buszy- 
klusses  tibemehmen  kann. 

Dieses  Signal  wird  vom  GLUE  geliefert  und  ist  mit  den  anderen  Bausteinen 
des  Mega  ST  (BLITTER  und  DMA-Einheit),  die  ebenfalls  die  Bussteue¬ 
rung  von  Zeit  zu  Zeit  tibemehmen  konnen,  “abgestimmt”. 


Die  Zentraleinheit 


825 


BGACK  Bus  Grant  Acknowledge.  Mit  einem  LOW  auf  dieser  Leitung  bestatigt 

der  anfordemde  Baustein,  daS  er  die  Bussteuerung  ubemommen  hat 
(Buszuteilungsquittung). 

Als  Open-Collector-Leitung  ist  dieser  AnschluB  auf  dem  Mainboard  mit 
einem  4K7-Pullup-Widerstand  abgeschiossen,  was  ATARI  auch  fiir  den 
AbschluB  auf  der  Erweiterungskarte  empfiehlt. 

NMI,  INT  5,  INT  3  Jenachdem,  wclche dieser drci  LeitungenvonderLogikderErweiterungs- 
karte  auf  LOW  gezogen  wird,  wird  ein  Interrupt  der  Prioritat  7  (Non 
Maskable  Interrupt),  Prioritat  5  oder  Prioritat  3  ausgelost.  Sollten  alle 
drei  Interrupts  gleichzeitig  auftreten,  wird  naturlich  der  hoclistwertige 
(Prioritat  7)  zuerst  beriicksichtigt.  Die  periphere  Einheit  am  Megabus 
muB  nun  korrekt  auf  die  Interruptbestatigung  durch  die  68000er-CPU 
reagieren  (siehe  auch  Teil  II,  Kapitel  4,  Abschnitt  “Interrapt-Steue- 
rung”). 


Stromversorgung  der  Erweiterungskarte 

Die  Stromversorgung  der  Erweiterungskarte  erfolgt  uber  eine  6pol.  Steckverbindung  (siehe 
Abbildung  1,15).  Die  +5V  konnen  dabei  mit  bis  zu  750  mA  und  die  +12V  mit  bis  zu  500  mA 
belastet  werden. 


Speicherraumreservierungen  fiir  die  Erweiterungskarte 

Nach  ATARI-Informationen  konnen  der  AdreBbereich  von  $C0  0000 ...  $CF  FFFF,  $FF  0000 
...  $FF  7FFF  und  $FF  FE00 ...  $FF  FFFD  durch  die  Erweiterungskarte  belegt  werden.  Fiir  die 
Benutzung  aller  weiteren  Adrefibereiche  behalt  sich  ATARI  das  Recht  auf  eine  eigene  Benut- 
zung  vor. 

Da  fiir  den  Megabus  inzwischen  einige  Erweiterungen  erhaltlich  sind,  wie  z.  B.  eine  Floating- 
Point-Coprocessor-Karte  von  ATARI,  Einbau-Festplatten  mit  Controller,  Netzwerkkarten 
und  Ansteuerkarten  fiir  GroBbildschirme,  ist  der  eine  oder  andere  Besitzer  eines  “kleinen”  STs 
(260ST/520ST+  oder  520ST(M))  nicht  abgeneigt,  seinem  System  ebenfalls  einen  Megabus- 
AnschluB  zu  spendieren. 

Im  ST  Magazin,  Ausgabe  10/88,  ist  aufgezeigt,  wie  unerschrockene  Hardware-Bastler  ihren 
“kleinen”  ST  mit  einem  Megabus- AnschluB  nachriisten  konnen! 


827 


Kapitel  2:  Das  Grafiksystem 

Die  Computer  der  ATARI  ST-Serie  kennen  vom  Prinzip  her  zwei  Grafikbetriebsarten: 

-  Monochrombetrieb 

-  Colorbetrieb 


Nur  schwarz/weifi,  aber  gestochen  scharf  - 
Der  Monochrombetrieb 

Der  Monochrombetrieb  eignet  sich  durch  seine  hohe  Graftkauflosung  von  640  *  400  Punkten 
und  der  schwarz-auf-weiB  Darstellung  hervorragend  fiir  die  Textverarbeitung  und  den  Pro- 
grammierbetrieb.  Der  von  ATARI  fiir  den  Monochrombetrieb  vorgesehene  Monitor  SMI 24 
/  SM125  liefert  ein  scharfes  und  flimmerfreies  Bild. 

Das  wird  durch  eine  Bildwiederholfrequenz  von  ca.  70  Hz  erreicht,  wahrend  diese  bei 
normalen  Femsehem  und  Monitoren  iiblicherweise  bei  50  Hz  (50  Haibbilder/s.)  liegt.  Der  ST 
stellt70VollbIlder/.smit400sichtbarenBildschijmzeilendar.Dazu  niuR  die  Horizon talfrequenz 
(Zahl  der  Bildschirmzeilen/s)  auf  einen  Wert  von  ca,  36  kHz  gebracht  werden.  Der  ST  arbeitet 


Honitorbudise  des  Atari  ST 


Augenansicht  auf  die  Buchse 


1  -  Audio  Ausgang 

2  -  H+U-Synch.-Signalgenisch 

3  -  Port  A,  Bit  6,  Soundchip 

4  -  Monochron-Sensor 

5  -  Audio  Eingang 

6  -  Briin-Signal 

7  -  Rot-Signal 

8  -  +12U  out  (nax,  18nA) 

9  -  Horizontal-Synch. -Signal 

10  -  Blau-Signal 

11  -  Honochronsignal 

12  -  Vertikal-Synch. -Signal 

13  -  Masse 


Abb.  2.1:  Die  Monitorbuchse  des  ATARI  ST 
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mit  einer  H-Ablenkfrequenz,  die  also  nahezu  2,5mal  so  hoch  wie  bei  “normalen”  Femsehem 
und  Monitoren  (ca,  1 5 ,6  kHz)  liegt.  Ein  “normaler”  Monitor  oder  Femseher  mit  Videoeingang 
ist  da  klar  uberfbrdert  und  kann  evtl.  Schaden  erleiden,  da  die  Hochspannungserzeugung  in 
Fernsehem  und  Monitoren  iiblicherweise  vom  Horizontaloszillator  gesteuert  wird. 

Angeschlossen  wird  der  ATARI-Monochrommonitor  an  die  13polige  Monitorbuchse  des  ST. 

Die  Bildinformation  wird  dem  Monitor  bei  Monochrombetrieb  tiber  den  AnschluBpin  11 
(Monochrom-Signal)  der  Monitorbuchse  angeboten.  Das  Signal  kennt,  ahnlich  dem  Ausgang 
eines  Digitalbausteins,  nur  zwei  Zustande.  Der  ST  liefert  ein  Signal  von  1  Vss  an  75  Ohm. 


Vert ikal-Sunch. -Signal 

3 . 5  V  -I - 1 . - 


0U 


Horizontal-Sunch. -Signal 


Abb.  2.2:  Die  Video-Ausgangssignale  bei  Monochrombetrieb 
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Bin  Spannungs  wert  von + 1 V  gegen  Masse  (liegt  an  Pin  1 3  der  Monitorbuchse)  entspricht  dabei 
derBildinformation  “weiB”,  undOV  bedeutet  somit  “schwarz”.  Zwischenwerte  (Grauabstufun- 
gen)  sind  nicht  moglich. 

Die  Synchronisationssignale  fur  das  entsprechende  Strahlriickiauf-Timing  ira  Monitor  wer- 
den  fur  Horizontal-  und  Vertikalablenkung  sowohl  getrennt  als  auch  in  Form  eines  Signal- 
gemischs  an  der  Monitorbuchse  angeboten.  Sie  haben  TTL-Pegel  und  sind  Low-aktiv,  was 
bedeutet,  daB  die  Aktion  (Elektronenstrahlriicklauf  im  Monitor  zum  Zeilen-/Bild-Anfang) 
ausgelost  wird,  wenn  das  Signal  auf  Low-Pegel  geht. 


Der  Monitor  bestimmt  die  Betriebsart 

Uber  Pin  4  der  Monitorbuchse  “erfiihlt”  der  ST,  welche  Art  von  Monitor  angeschlossen  ist. 
Durch  einen  Low-Pegel  wird  “mitgeteilt”,  daB  im  hochauflosenden  Monochrom-Modus  gear- 
beitet  werden  soil.  Der  AnschluB  fiihrt  im  ST  auf  den  I/OPort,  Bit  7,  des  Multi-Function-Peri- 
pheral-Bausteins  (MFP)  68901. 

Bei  der  Sy steminitialisierung  wird  durch  Abfrage  des  eben  erwahnten  Port-Anschlusses  7  des 
MFP  festgestellt,  ob  im  Monochrom-  oder  Colorbetrieb  gearbeitet  wird. 

Ein  Pegelwechsel  an  diesem  Eingang,  z.  B.  durch  Abziehen  des  Monitorsteckers,  wird  wah- 
rend  des  Vertikal-Blank-Interrupts  festgestellt  und  fiihrt  zur  Neuinitialisierung  des  Systems. 


Jetzt  wird’s  bunt  -  Die  Colorbetriebsart 

Im  Colorbetrieb  arbeitet  der  ST  mit  “normalen”  RGB-Monitoren  Oder  Farbfemsehem  mit 
SCART-Eingang  zusammen. 

Hierbei  wird  die  Farbinformation  fiir  jeden  Bildpunkt  in  entsprechende  Intensitatswerte  der 
drei  Primarfarben  Rot,  Griin  und  Blau  zerlegt.  Fiir  jede  Primarfarbe  wird  die  Bildinformation 
uber  eine  eigene  Leitung  dem  Monitor/Femseher  zugefuhrt. 

Der  ST  liefertRGB-Signale  von  max.  1  Vss  an  75  Ohm,  denen  ein  Gleichspannungspegel  von 
ca.  0,5  Volt  unterlegt  ist,  wobei  ein  Spannungswert  von  +1,5  Volt  gegen  Masse  der  hochsten 
Farbintensitiit  entspricht.  Ein  Wert  von  0,5  Volt  (-  unterlegter  Gleichspannungspegel) 
bedeutet  somit  niedrigste  Farbintensitat. 

Die  Synchronisationssignale  sind  auch  in  dieser  Betriebsart  wieder  getrennt  von  den  Signalen 
fiir  die  Bildinformation  gefiihrt.  Sie  stehen  sowohl  getrennt  nach  H-  und  V-Signal  als  auch  als 
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Abb.  2.3:  Anschlufi  des  ST  an  einen  Farbfernseher  mit  SCART-Eingang 


Synchronsignalgemisch  an  Pin  2  der  Monitorbuchse  zur  Verfiigung.  (Achtung!  Das  Synchron- 
signalgemisch  steht  wegen  des  eingebauten  Modulators  bei  alteren  520STM-Geraten  nicht  zur 
Verfiigung!) 

Durch  die  getrennte  Zufiihrung  von  Rot-,  Griin-  und  Blau-Signalen  erhalt  man  auch  auf  einem 
handelsiiblichen  Farbfernseher  mit  SCART-Eingangsbuchse  ein  besseres  Farbbild  als  von 
Computem  mit  einem  sogenanntem  FBAS-Ausgang. 

Ein  Farb-Bild-Austast  und  Synchronsignal-Ausgang  (FBAS-Ausgang)  hat  zwar  den  Vorteil, 
daB  man  nur  eine  Leitung  (nun  ja,  die  Masseleitung  ist  natiirlich  ebenfalls  noch  erforderlich) 
zwischen  Computer  und  Monitor  benotigt. 

Alle  Informationen  wie  Farbe,  Farbintensitat,  Synchronisier-  und  Austastinformation  (zur 
Dunkeltastung  des  Elektronenstrahls  in  der  Bildrohre,  wahrend  dieser  vom  Ende  einer  Bild- 
schirmzeile  zuriick  zum  Anfang  einer  neuen  Zeile  springt)  sind  in  einem  Signal  gewisserma- 
Ben  verschliisselt  enthalten. 
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Rot-Signal 

Griin-Signal 

Blau-Signal 


3.5U 

0U 


A  k. 

Vertikal- 
Synch, -Signal 


Horizontal- 
Synch. -Signal 


H+V-Synch.- 

Signalgenisch 


Abb.  2.4:  Die  Video-Ausgangssignale  bei  RGB-Betrieb 


Sie  miissen  jedoch  (aha!  Jetzt  kommt  der  Haken !)  im  Monitor  erst  wieder  entschliisselt  wer- 
den.  Dabei  erleidet  die  eigentliche  Bildinformation  einige  Qualitatseinbufien  durch  Dekodier- 
und  Verzogerungsschaltungen. 


Das  bessere  Farbbild  -  mit  RGB-Monitor 

Bei  einem  RGB-AnschluB  werden  die  Bildinformationen  dagegen  schon  direkt  in  ihre 
Primarfarben  zerlegt  angeboten,  wie  es  der  Monitor/Femseher  im  Endeffekt  ja  eigentlich 
benotigt.  Diese  Signale  erfahren  im  Monitor/Femseher  nur  noch  eine  Pegelanpassung  und 
gelangen  dann  direkt  an  die  Bildrohre,  welche  fur  jede  Primarfarbe  ein  eigenes 
Strahlerzeugungssystem  besitzt.  Die  RGB-Bildinformation  wird  also  kaum  beeinflulJt  und 
verfalscht. 

Man  kann  tibrigens  mit  relativ  geringem  Aufwand  einen  handelsiiblichen  Monochrom-Moni- 
tor  dazu  “bewegen”,  als  Sichtgerat  fur  den  Colorbetrieb  zu  arbeiten.  Die  einzelnen  Farb- 


832 


ATARI  Profibuch 


Abb.  2.5:  So  einfach  lafit  sich  ein  normaler  Monochrom-Monitor  ah  Sichtgerat  fiir  die  Colorbe- 
triebsart  des  ST  anschalten 


informationen  und  Farbintensitatswerte  miissen  nur  in  entsprechende  Grauwerte  umgesetzt 
werden. 

AuBer  den  AnschluBelementen  an  Computer  und  Monochrom-Monitor  sowie  Koaxialkabel 
entsprechender  Lange  benotigtmannurnoch  vierWiders  tande,  einenLo  tkolben,  Seitenschnei- 
der  und  ein  wenig  bastlerisches  Geschick. 

Soviel  zur  Video- AnschluBtechnik  bei  den  ST-Computem.  Erwahnt  sei  hier  noch,  daB  der 
ATARI  520ST(F)M/I040STFM  mit  einem  eingebauten  Modulator  ausgeriistet  ist.  Damit  ist 
es  moglich,  einen  Farbfernseher  als  Sichtgerat  fiir  Colorbetrieb  zu  benutzen.  Aufgrund  der 
hierbei  auftretenden  Qualitdtsverluste  des  Bildinformationssignals  dutch  Modulation  im  ST 
und  Demodulation  im  Farbfernseher  ist  die  Bildqualitat  natiirlich  nicht  mit  der  eines  RGB- 
Monitors  zu  vergleichen.  Ein  langeres  Arbeiten  mit  einem  iiber  den  Modulator  angeschlos- 
senen  Farbfernseher  ist  insbesondere  bei  Textdarstellung  nicht  empfehlenswert. 


Organisation  des  Bildschirmspeichers 

Die  Computer  der  ST -Serie  besitzen  keinen  separaten  Bildschirmspeicher  wie  z.  B .  viele  “pro- 
fessionelle”  Personal-Computer. 

Vielmehr  wird  ein  Teil  des  normalen  RAMs  dafiir  benutzt.  Im  Prinzip  ist  die  Lage  des 
Bildschirm-RAMs  im  Speicherraum  des  STbeliebig  einstellbar,  also  nicht  auf  einen  bestimm- 
ten  AdreBbereich  beschrankt. 
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Der  Video-Hardware  muB  nur  “gesagt”  werden,  ab  welcher  Adresse  im  RAM  der  Bildschirm- 
speicher  beginnt.  Dann  werden  die  ab  dieser  Adresse  folgenden  32000  Bytes  im  RAM  vom 
Video-Controller  als  Bildschirminformation  interpretiert  und  entsprechend  umgesetzt, 

Je  nach  Wahl  der  gewiinschten  Bildschirmauflosung  werden  die  Daten  im  Bildschirmspeicher 
vom  Video-Controller  in  ein  Videosignal  umgewandelt. 


High  resolution  -  Hohe  Auflosung 

Diese  Darstellungsart  ist  nur  in  Verbindung  mit  dem  hochaufldsenden  Monitor  moglich.  Es 
werden  640Bildpunkte  in 400Zeilen  und  dabei  mitzwei  Farben  dargestellt.  Ein  Bildschirmpunkt 
(Pixel  =  umgangssprachliche  Kurzform  von  Picture  cell  =  zu  deutsch:  Bildelement)  kann 
hierbei  nur  zwei  Zustande  annehmen,  entweder  hell  oder  dunkel.  Entsprechend  der  Abbildung 
2.6  wird  jedes  helle  Pixel  durch  ein  geloschtes  Bit  und  ein  dunkles  Pixel  durch  ein  gesetztes 
Bit  im  Bildschirmspeicher  dargestellt. 


Abb.  2.6:  Organisation  des  Bildschirmspeichers  fiir  die  High-Resolution-Darstellung 


Medium  resolution  -  Mittlere  Auflosung 

Auf  dem  hochauflosenden  Monitor  ist  diese  Darstellungsart  nicht  moglich  (zumindest  nicht 
ohne  kraftige  bastlerische  Klimmziige  wie  z.  B.  in  der  “ST  COMPUTER”  5/88  beschrieben). 
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Es  handelt  sich  hierbei  um  eine  Colorbetriebsart,  die  einen  RGB-Monitor/Farbfernseher  mit 
SCART-Eingang  oder  einen  “normalen”  Monochrommonitor/Femseher  mit  entsprechendem 
AnschluBkabel  erfordert.  Die  Bildschirmdarstellung  umfaBt  hierbei  200  Zeilen  zu  je  640 
Pixel.  Jedes  Pixel  kann  hierbei  vier  Zustande,  also  vier  Farben  annehmen. 

Der  Bildschirmspeicher  wird  vom  Video-Controller  dabei  als  zwei  sogenannte  Bit-Planes 
(Bit-Ebenen)  interpretiert,  wobei  die  Kombination  der  jeweils  “iibereinanderliegenden”  Bits 
der  beiden  Planes  bestimmt,  welche  Farbe  der  zugehorige  Bildschirmpunkt  auf  dem  Monitor 
dann  bekommen  soli  (siehe  Darstellung  in  der  Abbildung  2.7). 


Abb.  2.7:  Organisation  des  Bildschirmspeichers  fur  die  Medium-Resolution-Darsteihmg 


Low  resolution  -  Niedrige  Auflosung 

Auch  hierbei  handelt  es  sich  um  eine  Colorbetriebsart.  Es  werden  320  Pixel  in  200  Zeilen  auf 
dem  Bildschirm  dargestellt. 

Der  Bildschirmspeicher  wird  jetzt  in  vier  B  it-Planes  organisiert.  Ein  Pixel  wird  also  durch  vier 
Bits  beschrieben,  Somit  kann  die  Pixelfarbe  aus  einem  der  16  zur  Verfiigung  stehenden  Farb- 
register  ausgewahlt  werden. 
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Abb.  2.8:  Organisation  des  Bildschinnspeiehers  bei  Low-Resolution 

Indirekte  Farbgebung 

ATARI  benutzt  auch  hier,  wie  schon  bei  den  8-Bit-Modellen  800XL/130XE,  das  Prinzip  der 
Color  indirection,  d.  h.,  die  Bitkombination  fiirein Pixel  legt  noch  nicht  direkt  einebestimmte 
Farbe  fur  den  Bildschirmpunkt  fest,  sondem  dient  dem  Video-Controller  lediglich  zur  Aus- 
wahl  eines  Farbregisters.  Dieses  Farbregister  enthalt  dann  erst  den  entsprechenden  Farbwert 
fur  das  Pixel.  Der  ST  besitzt  insgesamt  1 6  solcher  Farbregister,  auch  Palette-Register  genannt, 
die  mit  unterschiedlichen  Farbinformationen  geladen  werden  konnen.  Pro  Pixel  stehen  bei 
Medium  Resolution  also  zwei  Bits  zur  Verfiigung,  die  entsprechend  ihrer  Wertigkeit  im 
Video-Controller  eines  von  vier  Palette-Registern  0...3  adressieren  konnen.  In  Low  Resolu¬ 
tion  kann  mit  vier  Bits  pro  Pixel  eines  von  16  Farbregistem  angewahlt  werden. 


Der  ATARI- Videocontroller 

ATARI  verwendet  auch  in  den  16  Bit-Computem  der  ST-Serie  keinen  Standard-Video- 
Controller.  Es  handelt  sich  hierbei  ura  eine  Eigenentwicklung  mit  speziell  auf  den  ST  hin 
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ausgelegten  Eigenschaften.  Der  Video-Controller  laftt  sich  ebensowenig  wie  die  anderen 
Systemkomponenten  DMA-Einheit,  Speicherverwaltung  usw.  in  einem  ganz  bestimmten 
Chip  auf  der  Platine  des  ST  wiederfinden.  Vielmehr  bilden  erst  die  Kombination  von  CPU  und 
vier  ATARI-spezifischen  Chips,  nhmlich  MMU,  DMA,  Shifter  und  GLUE,  ein  funktionsfa- 
higes  System. 

Wenn  also  hier  von  dem  ST-Video-Controller  die  Rede  ist,  so  sind  damit  alle  Register  und 
Steuereinheiten  in  den  vier  ATARI  Custom-Chips  gemeint,  die  zusammen  die  Funktion  des 
Video-Controllers  erfiillen!  Wesentliche  Aufgaben  bei  der  Erzeugung  des  Videosignals  iiber- 
nimmt  hierbei  der  Shifter-Chip. 

Fur  den  Programmierer  -  auch  den  hardwarenahen  Systemprogrammierer  -  ist  es  jedoch 
letztlich  egal,  in  welchem  Chip  sich  welches  Register  befindet  (Hauptsache,  die  Adresse  ist 
bekannt).  Die  Arbeitsweise  des  Video-Controllers  soil  das  in  Abbildung  2.9  aufgefiihrte 
Prinzipschaltbild  verdeutlichen. 


So  werden  Bits  zu  Pixel 

Die  Schieberegister  im  Video-Controller  haben  Wortbreite  und  werden  zyklisch  mit  den 
Daten  aus  dem  Bildschirmspeicher  geladen.  CPU-Zugriffe  und  Zugriffe  des  Videocontrollers 
(Shifters)  sind  dabei  zeitlich  ineinander  verzahnt.  Die  Information  wird  dann  bitweise  im 
Pixel-Takt  an  die  Register-Select-Logik  “hinausgeschoben”.  Diese  bestimmt  aufgrund  der 
Ausgangsbitkombination  der  Schieberegister  und  der  eingestellten  Grafikbetriebsart  im  Shift- 
Mode-Register  das  fur  das  Pixel  mabgebende  Farbregister. 

Die  Grafikbetriebsart  wird  mit  dem  Shift-Mode-Register  nach  dem  in  Abbildung  2.10 
dargestellten  Schema  eingestellt.  Ist  von  der  Register-Select-Logik  das  Farbregister  ausge- 
wahlt  worden,  wird  aus  diesem  die  Information  fiir  Farbe  und  Farbintensitat  an  das  Output- 
Register  ausgegeben.  Die  Farbintensitat,  mit  der  jede  der  drei  Primarfarben  im  Ausgangssignal 
vertreten  ist,  ist  in  acht  Stufen  einstellbar.  Fiir  jede  Farbe  existieren  drei  digitale  Ausgangsan- 
schliisse,  also  sind  2J=  8  Kombinationen  =  Farbintensitaten  moglich.  So  labt  sich  durch  ent- 
sprechende  Bitkombination  in  jedem  Farbregister  einer  von  2(3+3+3)  =  29  =  512  Farbtonen 
anwahlen. 

Die  Information  aus  dem  fiir  den  Bildpunkt  angewahlten  Farbregister  gelangt  also  ins  Output- 
Register  und  wird  an  dessen  Ausgangen  mit  einem  aus  jeweils  drei  Widerstanden  gebildeten 
Digital/Analog-Wandler  in  eine  analoge  Spannung  umgesetzt. 

Dazu  wird  noch  das  Blanking-Signal  gemischt,  und  dann  geht  es  iiber  Impedanzwandler  ab 
an  die  Monitorbuchse  des  ST. 
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Abb.  2.9:  Primipschaltbild  des  ST-Video-Controllers 


In  der  Monochrom-Betriebsart  kann  lediglich  fiber  das  niedrigstwertige  Bit  des  Farbregisters 
0  eingestellt  werden,  ob  derBildpunkt  normal  oder  invertiert  ausgegeben  werden  soli,  was  eine 
“normale"  oder  “invertierte”  Bildschirmdarstellung  zur  Folge  hat. 

Fureinen  reibungslosen  Ablauf  dieser  Vorgange  sorgtdieTiming-Logik,  welche  aus  dem  32- 
MHz-Takt  des  ST-Systems  alle  fur  den  Video-Controller  erforderlichen  Timing-Signale  ge- 
neriert.  Der  32-MHz-Mastertakt  gelangt  vom  Oszillator  in  den  Shifter  und  wird  dort  zur  Pixel- 
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Abb.  2.10:  Das  Shift-Mode-Register 
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Abb.  2.11:  Die  Farbregister 


ausgabe  benutzt.  Ein  aus  den  32  MHz  im  Shifter  abgeleiteter  16-MHz-Takt  wird  zur  MMU 
gefuhrt,  die  daraus  Horizontal-  und  Vertikal-Synchronimpulse  erzeugt  und  auBerdem  den  8- 
MHz-Takt  fur  u.  a.  die  CPU  erzeugt. 
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Abb.  2.12:  Die  Bitbelegung  des  Sync-Mode-Registers 


Mit  dem  Sync-Mode-Register  laBt  sich  unter  anderem  einstellen,  mit  welcher  Vertikal- 
Synchronisationsfrequenz  gearbeitet  wird.  Das  Bit  0  verdient  dabei  noch  besondere  Beach- 
tung,  1st  es  geloscht,  werden  die  Impulse  fur  die  Horizontal-  und  Vertikalsynchronisation  von 
der  Timing-Logik  des  Video-Controllers  selbst  erzeugt.  Bei  gesetztem  Bit  0  erwartet  die  Tim- 
ing-Logik  jedoch  die  H-  und  V-Synch.-Impulse  (Low-aktiv)  von  einer  extemen  Signalquelle. 
Eingespeist  werden  diese  an  den  H-  und  V-Sync.-Anschliissen  der  Monitorbuchse.  DieH-  und 
V-Sync.-Anschliisse  des  ST-Video-Controllers  sind  dann  als  Eingange  geschaltet! 

So  lieBe  sich  der  ST  also  mit  extemen  Videosignalquellen  wie  z.  B.  Videokamera  oder  Video¬ 
recorder  synchronisieren.  Leider  ist  damit  noch  keine  pixelgenaue  Synchronisation  moglich, 
und  es  kommt  zu  unschonem  “ZeilenreiBen”.  Von  einer  Zeile  zur  nachsten  ergeben  sich 
Spriinge  und  somit  ein  verzerrtes  Mischbild.  Um  diese  Verzerrungen  auszumerzen,  muB  man 
(im  STE  endlich  realisiert)  den  gesamten  ST  mit  einem  extemen  Takt  versorgen. 

Der  Video-Controller  ist  im  Prinzip  ein  System  mit  “Eigenleben”,  das  sowohl  Zugriff  auf  den 
AdreB-  als  auch  den  Datenbus  (nur  der  RAMs!)  hat,  ohne  den  Umweg  iiber  CPU-Register 
nehmen  zu  mtissen.  Einige  Daten  muB  die  CPU  dem  Video-Controller  aber  schon  mitteilen, 
damit  dieser  z.B.  weiB,  wo  die  Bildschirmdaten  im  Speicher  stehen.  Den  Anfang  des  Bild- 
schirmspeichers  erfahrt  der  Video-Controller  aus  dem 

Video-Base-Register 


Adresse 

Zugriff 

Funktion 

Label 

SFF  8201 

R/W 

Video-Base-Register  High-Byte 

“dbaseh” 

SFF  8203 

R/W 

Video-Base-Register  Mid-Byte 

“dbasel” 
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Das  Video-Base-Register  besteht  eigentlich  aus  zwei  einzelnen  Registem  zu  je  acht  Bit, 
beginnt  an  einer  ungeraden  Adresse  und  kann  deshalb  nicht  mit  einem  Word-Zugriff 
angesprochen  werden.  Der  Anfang  des  Bildschirmspeichers  kann  im  Hauptspeicher  des  ST 
auch  immer  nur  an  einer  256-Byte  Schwelie  (an  einer  Page-Grenze)  liegen,  da  ja  fur  das  Low- 
Byte  der  vollstandigen  Adresse  das  Register  fehlt.  Ein  Zugriff  auf  das  Register  ist  nur  im 
Supervisor-Modus  moglich! 

Das  folgende  Register  dientdem  Video-Controller  alsAdreBzahlerfiirdenBildschirmspeicher. 
Die  CPU  kann  den  Inhalt  des  Video-Adress-Counters  nur  auslesen  (Supervisor-Mode!). 

Video-Adress-Counter 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8205 

R 

Video-Adress-Counter  High-Byte 

“vcounthi” 

$FF  8207 

R 

Video-Adress-Counter  Mid-Byte 

“vcountmid” 

$FF  8209 

R 

Video-Adress-Counter  Low-Byte 

“vcountlow” 

Gesetzt  wird  der  Video-Adress-Counter  iiber  das  Video-Base-Register.  Dieser  Counter 
ubemimmt  zu  Beginn  eines  jeden  Bildes  die  Anfangsadresse  des  Bildschirmspeichers  aus  dem 
Video-Base-Register. 


Erwiinschte  Unterbrechungen? 

Die  H-  und  V-Synchronisationssignale  vom  Video-Controller  werden  zusatzlich  im  ST  noch 
zurlnterruptsteuerung  benutzt.  Der  Vertical -Blank-Interrupt  wird  ausgelost,  sobald  die  letzte 
Bildschirmzeile  eines  Bildes  geschrieben  ist.  Im  Monitor  mull  der  Elektronenstrahl,  der  die 
Pixel  auf  der  Phosphorschicht  des  Bildschirms  zum  Leuchten  bringt,  ausgeschaltet  werden. 
So  wird  verhindert,  daB  derBetrachter  sieht,  wie  der  Elektronenstrahl  vom  Strahl- Ablenksystem 
wieder  an  den  Anfang  der  ersten  Bildschirmzeile  des  neuen  Bildes  positioniert  wird  (also  von 
rechts  unten  nach  links  oben  springt). 

Wahrend  dieser  Zeitspanne  lassen  sich  einige  Programmroutinen  abwickeln,  die  zyklisch 
irgendwelche  Aktionen  durchfiihren.  So  wird  z.  B.  im  Vertical-Blank  abgefragt,  ob  bei  den 
Floppys  der  Motor  noch  lauft.  Steht  dieser,  wird  die  entsprechende  Floppy  deselektiert.  Vom 
Betriebssystem  ist  die  Moglichkeit  fiir  den  Programmierer  vorgesehen,  eigene  VBlank- 
Interruptroutinen  einzufugen  (siehe  auch  Teil  I,  Kapitel  1,  “Der  Vertical  Blank  Handler”). 

Es  ist  moglich,  auch  beim  Strahlriicklauf  vom  Ende  einer  Bildschirmzeile  zum  Anfang  einer 
neuen  Bildschirmzeile  (Horizontal-Blanking  =  Horizontal-Strahlaustastung)  einen  Interrupt 
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auszulosen,  Im  normal  arbeitenden  ST-System  ist  dieser  HBlank-Interrupt  jedoch  nicht 
vorgesehen.  Ein  laufender  ProzeB  wiirde  namlich  in  der  Monochrom-Betriebsart  sonst  alle  28 
pSek  filr  mindestens  sieben  uSek  unterbrochen.  Solange  dauert  es  namlich,  bis  der  Prozes- 
sor  den  Interrupt  erkannt,  quittiert  und  abgeschlossen  hat.  Dazu  kommt  natiirlich  noch  die  Zeit 
fur  die  eigentliche  Interrupt-Routine,  die  ausgefiihrt  werden  soli.  Der  HBlank-Interrupt  wiirde 
somit  schon  mindestens  25%  der  Prozessorzeit  beanspruchen;  ein  schoner  Bremsklotz  also. 


Jede  Menge  Manipulationen  moglich 

Die  Programmierung  des  ST-Video-Controllers  wird  dem  Programmierer  durch  eine  Reihe 
von  XBIOS-Aufrufen  erleichtert.  Es  sind  dies  die  XBIOS-Funktionen  #2  (“Physbase”),  #3 
(“Logbase”),  #4  (“Getrez”),  #5  (“Setscreen”),  #6  (“Setpallette”),  #7  (“Selcolor”)  und  #37 
(“Vsync”).  Nahere  Einzelheiten  dazu  im  Teil  I,  Kapitel  1,  in  der  “XBIOS-Referenz”. 

Die  komfortablen  Moglichkeiten  des  ST,  Text  und  Grafiken  gleichermaBen  gut  darzustellen, 
liegen  darin  begriindet,  daB  es  keinen  speziellen  Character-  und  Grafik-Modus  gibt. 

In  herkommlichen  Systemen  hat  man  iiblicherweise  einen  sogenannten  Charactergenerator 
(Zeichengenerator),  der  in  Zusammenarbeit  miteinem  Video-Controller  die  Darstellung  von 
Textzeichen  auf  dem  Bildschirm  ermoglicht.  Die  Zeichen  konnen  so  nur  in  einem  relativ  gro- 
ben  Raster  auf  dem  Bildschirm  angeordnet  werden  (Zeichenmodus).  Ein  zusatzlicher  Grafik- 
modus  ermoglich  das  Setzen  und  Riicksetzen  von  einzelnen  Bildpunkten. 

Beim  ST  gibt  es  nur  den  Grafikmodus.  Alle  Zeichen  und  Buchstaben  werden  durch  einzelnes 
Setzen  und  Riicksetzen  von  Pixeln  gebildet.  Das  beansprucht  natiirlich  einiges  an  Prozessorzeit 
und  Speicherplatz,  gestattet  dafiir  aber  das  komfortable  Mischen  von  Grafik  und  Text,  da 
Textzeichen  filr  den  ST  nichts  anderes  als  Gruppen  von  Grafikpunkten  darstellen.  AuBerdem 
lassen  sich  so  Zeichen  imPixelrasterbeliebig  auf  dem  Bildschirm  plazieren  (z.  B.Textverarbei- 
tung  “Signum!”).  Proportionalschrift  ist  somit  auch  moglich! 


Der  Blitter 

Zur  Entlastung  der  CPU  und  Beschleunigung  der  Graphikausgabe  wurde  von  ATARI  schon 
bei  der  Entwicklung  der  ST-Computerserie  ein  Hilfsbaustein  vorgesehen,  der  wesentliche 
Aufgaben  bei  der  Aktualisierung  des  Bildschiimspeichers  iibemehmen  sollte.  Zunachst  wur- 
den  die  Gerate  der  MEGA  ST-Serie  mit  dem  Bit-Block-Transfer-Processor  (Blitter)  ausgestat- 
tet.  Der  Blitter  ubemimmt  dabei  die  Aufgaben,  welche  bisher  von  der  BitBlt-Funktion  der 
Line- A-Routine  #$A007  ausgefiihrt  wurden.  Es  handelt  sich  hierbei  also  urn  eine  hardware- 
maBige  Realisierung  des  BitBlt-Algorithmus. 
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Bei  einem  Bit-Block-Transfer  konnen  Bitfelder-Daten  von  einer  Ausgangsposition  im 
Bildschirmspeicher  an  eine  Zielposition  iibertragen  werden. 

Dabei  ist  es  moglich,  die  Ursprungsdaten  iiber  eine  wahlbare  logische  Verkniipfung  mit  dem 
bereits  im  Zielspeicherbereich  vorhandenen  Bitmuster  zu  verkiipfen.  Es  ist  aber  ebenfalls 
moglich,  einen  Zielbereich  mit  einem  vorher  definiertem  Muster  zu  ftillen  und  so  beispiels- 
weise  Bildschirmausschnitte  zu  loschen  oder  vorzubesetzen. 

Unter  Zuhilfenahme  der  BitBlt-Funktion  lassen  sich  so  relativ  einfach  Funktionen  wie  Text- 
Scrolling,  Textumsetzungen  in  Fettschrift,  Italic  oder  Outline  realisieren.  Funktionen  wie 
Window-Updating  und  -Verschiebung  profitieren  ebenfalls  von  den  Moglichkeiten,  welche 
die  BitBlt-Funktion  bietet. 


Der  Atari  ST -Blitter 

Der  Grundalgorithmus  der  BitBlt-Funktion  wurde  erstmalig  durch  Newman  &  Sproull  im 
Jahre  1979  bei  der  Beschreibung  der  RasterOp-Funktion,  im  Bucb  “Principles  of  interactive 
computer  graphics”  definiert.  Diese  Definition  sah  einen  “Bit  fur  Bit”-Block-Transfer  vor.  Es 
waren  nur  wenige  logische  Verkniipfungsmoglichkeiten  zwischen  Quell-  und  Zielbitfeldern 
vorgesehen. 

Im  Laufe  der  Zeit  wurden  die  Grundfunktionen  um  weitere  Verkniipfungsmoglichkeiten 
ei  weitert  und  die  Parallelverarbeitung  von  Bits  implementiert. 

AuBerdem  wurde  vorgesehen,  die  Ursprungsdaten  mit  einem  frei  definierbaren  Grundmuster 
“vorzuverarbeiten"  (sogen.  Halftone  Pattern)  und  erst  das  daraus  entstehende  Ergebnis  mit 
den  Zieldaten  zu  verkniipfen.  Ein  nach  diesen  Definitionen  erstellter  RasterOp-Chip  (die 
“VL16160  RasterOp  Graphics/Boolean  Operation  ALU”  von  VLSI-Technology)  konnte  je- 
doch  immer  nurEinzeldaten  bearbeiten.  Die  Quell-,  Halftone-  und  Zieldaten  muBten  laufend 
von  der  CPU  in  den  RasterOp-Chip  nachgeladen  werden.  DMA-Betrieb  war  nicht  moglich. 

Der  ATARI  ST-Blitter  ist  ein  eigenstandiger  Prozessor,  der  alle  Definitionen  der  BitBlt- 
Funktion  erfiillt.  Er  verarbeitet  die  Daten  wortweise  (also  maximal  16  Bits  auf  einmal)  und 
braucht  von  der  CPU  nicht  fiir  jedes  Datenwort  mit  den  Quell-,  Halftone-  und  Zieldaten  nach¬ 
geladen  zu  werden. 

Die  erforderlichen  Quell-  und  Zieldaten  holt  er  sich  als  DMA-Baustein  selbst  aus  dem  RAM 
und  legt  sie  nach  Verarbeitung  auch  wieder  dort  ab.  AuBerdem  verfiigt  er  iiber  ein  eigenes 
schnelles  Halftone-RAM.  Zugriffe  auf  das  RAM  des  ST  muB  der  Blitter  mit  der  CPU  und  der 
DMA-Einheit  “absprechen”. 
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Bit-Block  Verarbeitung 

Beim  Bit-Block-Transfer  werden  Bitfeld-Daten  aus  einem  Ursprungs-Speicherbereich  mit 
den  Daten  eines  Bitfelds  im  Ziel-Speicherbereich  unter  Verwendung  eines  Booleschen  Opera¬ 
tors  verkniipft. 

Die  Verkniipfung  wird  dabei  jeweils  auf  die  zueinandergehorenden  Bits  des  Quell-  und  Ziel- 
bitfelds  angewendet. 

Folgende  logische  Verkniipfungsmoglichkeiten  ergeben  sich  dabei: 


Verkniipfgs.-Nr. 

Ergebnis  der  Verkniipfung  im  Zielbitfeld 

0 

Zielbit  =  0 

1 

Zielbit  =  Quellbit  AND  Zielbit 

2 

Zielbit  =  Quellbit  AND  NOT  Zielbit 

3 

Zielbit  =  Quellbit 

4 

Zielbit  -  NOT  Quellbit  AND  Zielbit 

5 

Zielbit  =  Zielbit 

6 

Zielbit  =  Quellbit  XOR  Zielbit 

7 

Zielbit  =  Quellbit  OR  Zielbit 

8 

Zielbit  =  NOT  Quellbit  AND  NOT  Zielbit 

9 

Zielbit  =  NOT  Quellbit  XOR  Zielbit 

10 

Zielbit  =  NOT  Zielbit 

11 

Zielbit  =  Quellbit  OR  NOT  Zielbit 

12 

Zielbit  =  NOT  Quellbit 

13 

Zielbit  =  NOT  Quellbit  OR  Zielbit 

14 

Zielbit  =  NOT  Quellbit  OR  NOT  Zielbit 

15 

Zielbit  =  1 

Bit-Block-Transfer  mit  dem  Blitter 

Der  ST-Blitter  verfiigt  iiber  eine  Anzahl  von  Registem,  die  an  den  in  der  Abbildung  2. 1 3  auf- 
gefiihrten  Adressen  im  Speicherraum  des  ST  zu  finden  sind  (sofem  der  Blitter  eingebaut  ist!). 

Blitter-Registerzugriffe  miissen  jedoch  immer  im  Supervisor-Modus  erfolgen,  sonst  “wirft” 
der  ST  Bomben! 

Zur  Erlauterung  des  Ablaufes  eines  Bit-Block-Transfers  mit  dem  Blitter  soil  das  in  Abbildung 
2.14  gezeigte  Datenflufibild  dienen. 
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Abb.  2.13:  Die  Register  des  Blitter-Chips 


Abb.  2.14:  Der  Datenflufi  beim  Bit-Block-Transfer 
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Nun  zur  Arbeitsweise  des  Blitters.  Betrachten  wir  zunachsteine  einfache  Blitter-Operation; 
Ein  Bit-Block  soil  vollstandig  mit  0-  oder  1-Bits  gefiillt  werden. 

Zur  Wahl  der  Verkniipfung  mud  das 

Operation-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A3B 

R/W 

Verkniipfungsart  festlegen 

Byte 

OP 

im  Blitter  mit  der  entsprechenden  Verkniipfungs-Nummer  geladen  werden  (Beispiel:  Fiillen 
des  Zielbitfeldes  mit  0-Bits = OP-Nr.  0,  Fiillen  mit  1-Bits  =  OP-Nr.  15).  Daten  aus  dem  Quell- 
bitfeld  und  Halftone-RAM  sind  in  diesem  Fall  nicht  erforderlich  (der  Source-Buffer  und  das 
Halftone-RAM  werden  also  nicht  benotigt).  Der  fur  die  Durchfiihrung  derlogischen  Verkniip- 
fung  zustandige  Funktionsblock  (im  DatenlluBbild  mit  Log.  OP  bezeichnet)  erzeugt  die  noti- 
gen  0-  bzw.  1-Bits  fur  die  Fulloperation. 

Bei  jeder  Blitter-Operation  wird  der  Funktionsblock  ENDMASK  gebraucht.  Hier  muG  nam- 
lich  festgelegt  werden,  welche  Bits  im  Zieldatenwort  geandert  werden  miissen  und  welche 
nicht.  Wenn  alle  Bits  eines  Wortes  im  Zielbitfeld  mit  0-  oder  1-Bits  gefiillt  werden,  schreibt 
der  Blitter  einfach  ein  Datenwort  nach  dem  anderen,  ohne  jemals  Daten  aus  dem  Zielbitfeld 
lesen  zu  miissen.  Sind  dagegen  jedoch  nicht  alle  Bits  eines  Wortes  im  Zielbitfeld  zu  andem, 
so  geben  die  ENDMASK-Register  die  Bitpositionen  an,  die  im  Zieldatenwort  geandert  wer¬ 
den  miissen. 

ENDMASKl-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

SFF8A28 

R/W 

Zu  andemde  Zielbits 

Word 

Endmaskl 

(Zeilenanfang) 

Dieses  Register  legt  fest,  welche  Bits  im  ersten  Datenwort  einer  Zeile  des  Zielbitfeldes  gean¬ 
dert  werden  sollen. 

ENDMASK2-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A2A 

R/W 

Zu  andemde  Zielbits 

Word 

Endmask2 
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Wird  benutzt,  wenn  keines  der  anderen  beiden  ENDMASK-Register  angewendet  wird  (das 
ist  fur  alle  Datenworte  zwischen  dem  ersten  und  letzten  Datenwort  einer  Zeile  des  Zielbitfeldes 
der  Fall). 

ENDMASK3-Register 


Adresse 

Zugriff 

Funktion 

Grdlle 

Label 

$FF  8A2C 

R/W 

Zu  andemde  Zielbits 

Word 

Endmask2 

(Zeilenende) 

Fur  das  Schreiben  des  letzten  Datenworts  einer  Zeile  im  Zielbitfeld  wird  dieses  Register  als 
Maske  benutzt,  um  festzulegen,  welche  Bits  geandert  werden  miissen. 

Folglich  ist  also  immer  dann  ein  READ-MODIFY-WRITE-Zyklus  fiir  das  Zieldatenwort 
erforderlich,  wenn  in  dem  zugehorigen  ENDMASK-Register  nicht  alle  Bits  gesetzt  sind  (zur 
Veranschaulichung  dient  die  Abbildung  2.15). 


Datenwort  k 


Datenwort  k+ 1 


Datenwort  k+2 


I  I  11  I  i  1  1  I  I  1  I  1  U  Gl  I  1  I  I  I  1  rm  I  I  1  I  □!  I  1-  l-L  1  I  I  □  □  f  1  I  U  ■ 

i  i  i  i  i  i  i  i  i  i  i  i  i  i  ma~m  i  rrm  i  i  i  rr  irrrr  1 1 1  i  m  1 1 1 im  ■ 


ENPHftSKl-  ITm  ui  i  ii  i  lammiBi  =$0D0F  tRERD-MOD  ifv -write) 
EMDMftSK2=[M»ilBlB|»l»iJgl«l»l»l»NI«l-l-Til  -SFFFF  CWRITE  only) 
EHDMftSK3=  mm  I  T~T~I  =SFF00  crefid-mooifv-write) 


Zeile  N 
Zeile  N+ 1 
Zeile  N+2 


ein  Aus- 
schnitt  aus 
den  Bild- 
schirnspei - 
c her here i chi 
CHonochron- 
betriebs- 
artl 


Abb.  2.15:  Eine  einfache  Aufgabe  fiir  den  Blitter:  das  Fallen  eines  Zielbitfeldes  mit  1-Bits 
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1st  eine  Zeile  des  Zielbitfelds  iibrigens  “schmaler”  als  ein  Datenwort  (z.  B.  nur  12  Bit  breit), 
so  wird  nur  das  ENDMASKl-Register  benutzt. 

Nachdem  der  Blitter  ein  Datenwort  im  Zielspeicherbereich  bearbeitet  hat,  muB  die  nachste 
zu  bearbeitende  Adresse  erniittelt  werden.  Dazu  benotigt  der  Blitter  die  Angaben  im 
Destination-X-Increment-,  Destination-Y-Increment-,  X-Count-,  Y-Count-  und  Destination- 
Address-Register. 

Mit  diesen  Registem  wird  sozusagen  der  zu  bearbeitende  Bitblock  von  seinen  Abmessungen 
her  festgelegt. 

X-Count-Register 


Adresse 

Zugriff 

Funktion 

Grofie 

Label 

$FF  8A36  | 

R/W 

Anzahl  Words/Zcile  im 
Zielbitfeld 

Word 

X_Count 

Hiermit  wird  festgelegt,  wie  viele  Datenworte  zu  einer  Zeile  des  Zielbitfeldes  gehoren  (in  dem 
Beispiel  in  der  Abbildung  2.15  steht  also  hier  ein  Wert  von  3). 

Der  kleinste  Wert  ist  1  (mindestens  ein  Datenwort  muB  im  Zielspeicherbereich  schon  zu 
bearbeiten  sein,  sonstbrauchtman  jakeineTransferoperation  durchzufiihren!),  und  der  groBte 
Wert  ist  65536  (wird  durch  einen  Wert  von  $0000  dargestellt). 

Der  Blitter  zahlt  jedesmal  dann  den  Inhalt  des  Registers  um  1  herunter,  wenn  er  ein  Datenwort 
geschrieben  hat.  Bei  Erreichen  von  $0000  wird  automatisch  das  X-Count-Register  wieder  auf 
den  urspriinglich  programmierten  Wert  gesetzt.  (Ahnlichkeiten  in  der  Arbeitsweise  mit  dem 
Timer-Data-Register  des  MFP  sind  zufallig  und  nicht  beabsichtigt.)  Beim  Auslesen  erhalt  man 
die  Zahl  der  Datenworte,  die  in  der  augenblicklich  in  Bearbeitung  befmdlichen  Zeile  noch 
geschrieben  werden  miissen. 

Y-Count-Register 


Adresse 

Zugriff 

Funktion 

Grofie 

Label 

$FF  8A38 

R/W 

Zeilenzahl  im  Zielbitfeld 

Word 

Y_Count 

Gibt  an,  aus  wie  vielen  Zeilen  das  Zielbitfeld  besteht.  Wertebereich  wie  beim  X-Count- 
Register  (mindestens  eine  Zeile,  maximal  65536  Zeilen  sind  moglich.  Im  Beispiel  in  Abbil¬ 
dung  2.15  also  ein  Wert  von  21). 
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Nachdem  eine  komplette  Zeile  des  Zielbitfeldes  geschrieben  ist,  wird  der  Inhalt  des  Registers 
jeweils  um  1  vermindert.  Bei  $0000  ist  der  Transfer  dann  beendet!  Ein  Lesezugriff  liefert  die 
Zahl  der  Zeilen,  die  noch  geschrieben  werden  miissen. 

Destination-X-Increment-Register 


Adresse 

Zugriff 

Funktion 

Grolk 

Label 

$FF  8A2E 

RAV 

Distanz  zwischen  zwei  Words 
im  Zielbitfeld 

Word 

|  Dst_Xinc 

Wird  als  vorzeichenbehaftete  Zahl  interpretiert  (hochstwertiges  Bit  wird  fur  Vorzeichen 
benutzt).  Das  niedrigstwertige  Bit  wird  nichtbenutzt,  weil  der  Blitter  immer  mit  Wordzugriffen 
arbeitet.  Und  die  sind  nur  auf  gerade  Adressen  erlaubt. 

Anzugeben  ist  in  diesem  Register  der  Abstand  in  Bytes  zwischen  zwei  Datenwortem  einer 
Zeile  des  Zielbitfeldes  (Achtung  bei  Bitplanes!  In  Low-Resolution  steht  hier  also  8  Oder  -8, 
bei  Mid-Resolution  dann  4  bzw.  -4  und  im  Monochrom-Modus  entspr.  2  Oder  -2).  Ein  negati- 
ver  Wert  weist  darauf  hin,  daB  die  Zeile  von  rechts  nach  links  bearbeitet  wird. 

Nachdem  der  Blitter  ein  Zieldatenwort  geschrieben  hat,  wird  der  Wert  aus  dem  Destination- 
X-Increment-RegisterunterBeriicksichtigungseinesVorzeichenszudemlnhaltim  Destination- 
Address-Register  addiert  (jedoch  nur,  wenn  das  X-Count-Register  einen  Wert  <>1  hat,  also 
eine  Zeile  im  Zielbitfeld  aus  mehr  als  einem  Datenwort  besteht). 

So  kann  der  Blitter  in  einstellbaren  Schrittweiten  den  Zielspeicherbereich  bearbeiten  und  nicht 
nur  unmittelbar  nebeneinanderliegende  Datenwbrter  ansprechen  (wichtig  bei  Bit-BlockT 
Transfers  auf  den  Bitplanes  in  der  niedrigen  und  mittleren  BildschirmauHGsung,  bei  denen  ja 
die  zu  einem  Plane  gehorigen  Datenworter  nicht  unmittelbar  nebeneinander,  sondem  vier 
bzw.  acht  Bytes  auseinanderliegen!). 

Destination-Y-Increment-Register 


Adresse 

Zugriff 

Funktion 

Grolk 

Label 

$FF  8A30 

RAV 

Distanz  zwischen  zwei  Zeilen 
im  Zielbitfeld 

Word 

Dst_Yinc 

Daten  werden  auch  hier  vorzeichenbehaftetbetrachtet.  Das  Register  enthalt  den  Byte- Abstand 
von  der  letzten  Zieladresse  einer  Zeile  zur  ersten  Zieladresse  in  der  nachsten  Zeile  des 
Zielbitfeldes.  Dieser  Wert  wird  nach  dem  Schreiben  des  letzten  Datenworts  einer  Zeile 
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vorzeichenrichtig  zum  Inhalt  des  Destination-Address-Registers  addiert.  Somit  zeigt  das 
Destination-Address-Register  dann  wieder  auf  das  nachste  zu  bearbeitende  Zieldatenwort. 

Sollte  das  X-Count-Register  von  vomberein  nur  mit  einem  Wert  von  1  geladen  worden  sein 
(wei]  eine  Zeile  im  Zielbitfeld  max.  ein  Datenwort  breit  ist),  arbeitet  der  Blitter  bei  der  Ermitt- 
lung  der  nachsten  Zieldatenadresse  ausschlieBlich  mit  dem  Destination-Y-Increment-Regi- 
ster.  Eine  Zeile  im  Zielbitfeld  besteht  dann  ja  nur  aus  einem  Datenwort,  und  nach  Bearbeitung 
dieses  einen  Wortes  ist  schon  die  nachste  Zeile  an  der  Reihe. 

Destination-Adress-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A32 

R/W 

Zeiger  auf  (nachstes) 
Zieldatenwort 

Long 

Dst_Addr 

Zu  Beginn  eines  Bit-Block-Transfers  ist  hier  die  Anfangsadresse  des  ersten  Wortes  des 
Zielbitfeldes  einzutragen.  Wahrend  des  Transfers  wird  das  Register  standig  mit  Hilfe  der 
Werte  im  Destination-X-Increment-  und  Destination-Y-Increment-Register  auf  den  aktuellen 
Stand  gebracht.  Man  wiirde  deshalb  bei  einem  Lesezugriff  wahrend  eines  Transfers  die 
Adresse  des  nachsten  zu  bearbeitenden  Zieldatenwortes  erhalten. 

Fiir  etwas  komplexere  Operationen  werden  noch  einige  weitere  Register  gebraucht.  Unter  an- 
derem  werden  diese  erforderlich,  wenn  z.  B.  ein  Zielbitfeld  mit  Daten  eines  Musters  AND- 
verkniipft  werden  soli.  Als  Ergebnis  bleiben  also  im  Zielbitfeld  nur  jene  Bits  gesetzt,  die  auch 
im  Muster  gesetzt  sind,  Hier  kommt  nun  das  Halftone-RAM  (GroBe:  16  Datenworter)  ins 
Spiel. 

Zunachst  wird  das  Muster,  mit  dem  das  Zielbitfeld  verkniipft  werden  soil,  als  16x16  Bitfeld 
ins  Halftone-RAM  eingeschrieben.  Dann  wird  das  OP-Register  mit  dem  Wert  fiir  die  AND- 
Verkniipfung  (OP-Nr.l)  geladen.  AnschlieBendmuB  dem  Blitter  noch  mitgeteilt  werden,  daB 
die  Verkniipfung  von  Daten  im  Zielbitfeld  nur  mit  dem  Muster  aus  dem  Halftone-RAM  durch- 
gefiihrt  werden  soli. 

Das  geschieht  iiber  das 

Halftone-Operation-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A3A 

R/W 

Halftone-Verkntipfungsvorschrift 

Byte 

HOP 
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Folgende  Moglichkeiten  sind  einstellbar: 


HOP 

Verknupfungsergebnis 

0 

Alle  Bits  =  1 

1 

Nur  Halftone-Daten 

2 

Nur  Source-Daten 

3 

Source  AND  Halftone 

Das  HOP-Register  muB  bei  obigem  Beispiel  also  mit  dem  Wert  von  I  geladen  werden,  weil 
ja  nur  die  Musterdaten  aus  dem  Halftone-RAM  benotigt  werden  ( Achtung  beimRegisterzugriff ! 
Das  HOP-Register  ist  nur  1  Byte  breit.) 

AuBerdem  kommt  jetzt  noch  ein  weiterer  Parameter  ins  Spiel: 

Line-Number-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A3C 

R/W 

Zeiger  auf 

Halftone- Verkniipfungsword 

Byte 

Line_Num 

Bei  einer  Halftone-Operation  gibt  die  Line  Number  an  (gebildet  aus  den  niedrigstwertigen  vier 
Bits  in  diesem  Register),  welchesder  16  WorterimHalftone-RAMals  Verkniipfungsdatenwort 
fur  die  gerade  zu  bearbeitende  Zeile  benutzt  wird. 

Abhangig  vom  Destination-Y-Increment-Register  wird  am  Ende  einer  Zeile  die  Line  Number 
um  1  erhoht  (bei  positivem  Wert  in  Destination- Y-Increment-Register)  Oder  um  1  emiedrigt 
(bei  negati vem  Wert  im Destination- Y -Increment-Register),  um  sodas  nachste  Verkniipfungs- 
datenwort  im  Halftone-RAM  zu  adressieren.  Die  Line  Number  wird  “rund”  geziihlt,  d.  h.,  bei 
einem  Wert  von  15  wird  bei  weiterer  Erhohung  der  Zahler  wieder  bei  0  beginnen.  Bei  einer 
weiteren  Dekrementierung  bei  einem  Zahlerstand  von  0  wird  die  Line  Number  entsprechend 
auf  15  springen. 

Die  schon  bekannten  Register  (Destination- Address-,  Destination-X-Increment,  Destination- 
Y-Increment-,  X-Count-  und  Y-Count-Register)  werden  entsprechend  mit  Werten,  die  sich 
aus  der  Lage  und  den  “Abmessungen”  des  zu  fullenden  Zielbitfeldes  ergeben,  geladen. 

Im  Prinzip  funktioniert  die  ganze  Angelegenheit  genauso,  wenn  man  statt  des  Musters  aus  dem 
Halftone-RAM  ein  Quellbitfeld  zur  Verkniipfung  mit  dem  Zielbitfeld  heranzieht.  Nur  das 
HOP-Register  muB  dann  anders  gesetzt  werden  (HOP-Nr.2  oder  HOP-Nr.3). 
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Der  Quellbitblock  hat  dann  die  gleichen  “Abmessungen”  wie  der  Zielbitblock  (X-Count  und 
Y-Count  gelten  sowohl  fiir  den  Source-  als  auch  den  Destination-Bit-Block!).  Unterscheiden 
diirfen  sich  jedoch  die  Werte  fiir  X-Increment  und  Y-Increment,  weshalb  auch  fiir  den 
Quellbitblock  eigene  Register  zur  Aufnahme  dieser  beiden  Werte  vorgesehen  sind. 


Source-X-Increment-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A20 

R/W 

Distanz  zwischen  zwei 

Words  im  Quellbitfeld 

Word 

Src_Xinc 

I-Iier  wird  der  Abstand  (in  B  y  tes)  zwischen  zwei  Datenwortem  in  einer  Zeile  des  Quellbitblocks 
eingetragen  (unter  Berticksichtigung  des  Vorzeichens!).  Nachdem  jeweils  ein  Source-Wort 
gelesen  wurde,  wird  der  Wert  dieses  Registers  zum  Inhalt  des  Source-Address-Registers  vor- 
zeichenrichtig  addiert  (solange  X-Count  <>1  ist!). 

Source-Y-Increment-Register 


1 

Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A22 

R/W 

Distanz  zwischen  zwei 

Zeilen  im  Quellbitfeld 

Word 

SrcJYinc 

Abstand  in  Bytes  zwischen  dem  letzten  Wort  einer  Zeile  des  Quellbitfeldes  und  dem  ersten 
Wort  der  nachsten  Zeile  (mit  Vorzeichen!). 

Wenn  das  letzte  Wort  einer  Zeile  des  Quellbitblocks  gelesen  ist,  wird  der  Wert  im  Source-Y- 
Increment-Register  zum  Inhalt  des  Source- Address-Registers  vorzeichenrichtig  addiert.  Das 
Source-Address-Register  zeigt  danach  wieder  auf  das  nachste  zu  lesende  Datenwort  des 
Quellbitfeldes. 

Source-Adress-Register 


Adresse 

Zugriff 

Funktion 

GroBe 

Label 

$FF  8A24 

R/W 

Zeiger  auf  (nachstes) 
Zieldatenwort 

Long 

Src_Addr 

Zu  Beginn  eines  Bit-Block-Transfers  wird  hier  die  Anfangsadresse  des  ersten  Wortes  des 
Quellbitfeldes  eingetragen. 
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Wahrend  des  Transfers  wird  das  Source-Adress-Register  standig  mit  Hilfe  der  Werte  im 
Source-X-Increment-  und  Source- Y-Increment-Register  auf  den  aktuellen  Stand  gebracht. 
Bei  einem  Lesezugriff  wahrend  des  Transfers  steht  hier  die  Adresse  des  nachsten  zu  lesenden 
Quelldatenwortes.  Werden  Quellbitfeld-Daten  in  die  Verarbeitung  einbezogen,  kommt  der  im 
DatenfluBbild  mit  Source-Buffer  bezeichnete  Funktionsblock  ins  Spiel.  Bei  einer  Bit-Block- 
Operation  mit  Sourcedaten  spieltsich  im  Blitter  dann  folgendes  ab  (Zumbesseren  Verstandnis 
sollte  man  die  Abbildung  2.14  betrachten): 

Die  ersten  beiden  Sourceworte  werden  in  den  Source-Buffer  eingelesen.  Zur  Verkiipfung  mit 
den  Zielbits  im  Zieldatenwort  muB  eine  Justierung  (Bitverschiebung)  der  Sourcedaten  im 
Source-Buffer  erfolgen  (das  erste  Bit  des  Quellbitfeldes  soil  ja  mit  dem  ersten  Bit  des  Zielbit- 
feldes  verkniipft  werden  usw.).  Den  Grad  der  Justierung  erfahrt  der  Blitter  aus  dem  SKEW- 
Register  (dazu  spater  mehr). 

1st  das  erste  Quelldatenwort  (nach  entsprechender  Justierung)  mit  dem  ersten  Zieldatenwort 
verkniipft,  werden  die  16  niederwertigen  Bits  im  Source-Buffer  in  die  16  hoherwertigen  Bits 
des  Source-Buffers  ubertragen.  Das  nachste  zu  lesende  Sourcewort  gelangt  in  die  niederwer- 
tigsten  16  Bit  des  Registers.  Es  erfolgt  wieder  die  Justierung  im  Source  Buffer,  dann  die  Ver- 
kniipfung  mit  dem  Zieldatenwort  usw. 

Nun  folgen  noch  die  Brlauterungen  fiir  die  verbleibenden  Flags  und  Register.  Unter  der 
Adresse  $FF  8A3D  findet  man  die  folgenden  Flags  und  Werte: 

SKEW  (Label:  “Skew”)  In  die  vier  niederwertigsten  Bits  an  Adresse  $FF  8A3D 

muB  der  sogenannte  Source-Skew  eingetragen  werden.  Darunter  versteht 
man  die  Zahl  der  notigen  Rechtsverschiebungen,  die  mit  den  Source-Daten 
im  Source  Buffer  (siehe  DatenfluBschema)  durchgefiihrt  werden  mtissen, 
bevor  diese  Daten  mit  den  Halftone-  und  Destination-Daten  verkniipft  wer¬ 
den  diirfen.  Beispieh  Dargestellt  sind  jeweils  die  ersten  beiden  Datenworte 
des  Quell-  und  Zielbitfeldes. 

Datenwort  1  Datenwort  2 


— c 

10000000000000 

)0000000 

-> 

SKEW 

=  6 

<- 

000000000 


Quell- 

bitfeld 


000000000000000- 


Ziel- 

bitfeld 
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Der  Quellbitblock  beginnt  im  Beispiel  bei  Bit  13  im  Datenwort  1  des 
Quellbitfeldes,  wahrend  der  Zielbitblock  erst  bei  Bit  7  im  ersten  Datenwort 
des  Zielbitfeldes  anfangt!  Damit  also  jeweils  die  zusammengehorigen  Bits 
(das  erste  Bit  im  Quellbitblock  korrespondiert  ja  mit  dem  ersten  Bit  im  Ziel¬ 
bitblock  usw.)  miteinander  verkniipft  werden  konnen,  miissen  diese  erst 
“iibereinandergeschoben”  werden. 

Um  wie  viele  Bitpositionen  die  Daten  “geschoben”  werden  miissen,  ist  im 
Skew-Wert  anzugeben. 

FXSR  (Force  Extra  Source  Read)  Ist  das  hochstwertige  Bit  im  Blitter-Register  an 

Adresse  $FF  8A3D  gesetzt,  so  wird  zu  Beginn  einer  jeden  Zeile  ein  zusatzli- 
ches  Datenwort  eingelesen,  um  entsprechend  “Luft”  fiir  Verschiebungen 
im  Source-Buffer  zu  schaffen. 

NFSR  (No  Final  Source  Read)  Wenn  Bit  6  im  Blitter-Register  an  Adresse  $FF 

8  A3D  gesetzt  ist,  wird  das  letzte  Quell-Datenwort  einer  Zeile  nicht  gelesen. 
Bei  einigen  Kombinationen  von  ENDMASK-Inhalten  und  SKEW-Werten 
kann  auf  das  Lesen  des  letzten  Datenwortes  einer  Zeile  des  Quellbitfeldes 
verzichtet  werden. 

Zu  den  FXSR-  und  NFSR-Bits  hier  noch  einige  Erlauterungen: 

Ein  Block  mit  einer  Breite  von  beispielsweise  20  Bits  benotigt  mindestens  zwei  Datenworte/ 
Zeile  zu  seiner  Darstellung.  Je  nachdem,  bei  welchem  Bit  des  ersten  Datenwortes  das  Bitfeld 
beginnt,  konnen  fiir  die  Darstellung  dieses  20  Bit  breiten  Bitfeldes  aber  auch  drei  Datenworte/ 
Zeile  notig  sein!  Es  ist  also  vorstellbar,  daB  im  Quellbitfeld  fiir  die  20  Bits  schon  zwei  Daten- 
worte/Zeile  ausreichend  sind,  wahrend  im  Zielbitfeld  drei  Datenworte  erforderlich  sind.  Der 
umgekehrte  Fall  ist  natiirlich  genauso  denkbar. 

Daraus  folgtdieNotwendigkeit,  evtl.  eine  unterschiedlicheZahl  von  Lese-  und  Schreibzugriffen 
in  einer  Zeile  des  Bit-Blocks  durchftihren  zu  miissen.  Fiir  diese  Steuerung  sind  die  beiden  Bits 
FXSR  und  NFSR  erforderlich. 

Die  folgenden  Beispiele  zeigen,  abhangig  von  der  Lage  der  Quell-  und  Zielbitfelder 
zueinander,  die  jeweils  notige  Einstellung  der  FXSR-  und  NFSR-Bits:  (Die  Bearbeitung  soil 


von  rechts  nach  links  erfolgen!) 

S  =  Sourcebits  D  =  Destin.-Bits  FXSR  NFSR 

- SSSSSSSSSSSS  SSSSSSSS -  0  0 

- ddddddddd  ddddddddddd - 
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S  =  Sourcebits  D  =  Destin.-Bits 


FXSR  NFSR 


- ssssssssssss 

- DD 


ssssssss - 

DDDDDDDDDDDDDDDD  DD' 


0  1 


- s  SSSSSSSSSSSSSSSS  SSS' 

■DDDDDDDDD  DDDDDDDDDDD - 


1  0 


- SSSSSSSSSSSS  SSSSSSSS 

— DDDDDDDDDDDDDD  DDDDDD - 


1  0 


An  Adresse  $FF  8A3C  (Label:  “Line_Num”,  also  dort,  wo  auch  die  Line  Number  zu  finden 
ist)  existieren  noch  die  folgenden  Steuerbits: 

SMUDGE  Dieses  Bit  befmdet  sich  an  der  gleichen  Adresse  wie  die  Line  Number  fiir 
das  Halftone-RAM  ($FF  8A3C).  Ist  es  gesetzt,  bestimmt  nicht  die  Line 
Number,  welches  Datenwort  aus  dem  Halftone-RAM  bei  einer  Halftone- 
Operation  zur  Verknupfung  benutzt  wird,  sondem  die  niederwertigsten  vier 
Bits  der  verschobenen  (ge”SKEW”ten)  Sourcedaten  im  Source-Buffer, 
Das  ergibt  quasi  zufallige  Verkniipfungen  mit  den  Daten  im  Halftone-RAM 
und  kann  fiir  “Schmiereffekte”  benutzt  werden. 

HOG  Hier  wird  die  Betriebsart  des  Blitters  eingestellt.  Bei  geloschtem  Bit  teilen 

sich  CPU  und  Blitter  Zugriffe  auf  den  Bus  zu  gleichen  Teilen  auf .  Jeder  darf 
fur  64  Zyklen  an  den  Bus,  wahrend  der  andere  angehalten  wird! 

-  Ist  das  HOG-Bit  gesetzt,  wird  die  CPU  so  lange  angehalten,  bis  der 
Bit-Block-Transfer  beendet  ist.  Es  darf  aber  durchaus  die  CPU  mal 
den  einen  oder  anderen  Befehl  ausfiihren,  wenn  der  Blitter  zwischen- 
durch  mal  den  Bus  freigibt!  Mit  gesetztem  HOG-Bit  kann  der  Bit- 
Block-Transfer  bis  zu  doppelt  so  schnell  abgewickelt  werden,  als 
wenn  sich  CPU  und  Blitter  den  Bus  im  Verhaltnis  1 : 1  teilen  miissen. 
In  beiden  Betriebsmodi  nimmt  der  Blitter  aber  Rucksicht  auf  den 
DMA-Baustein.  Dieser  hat  namlich  Vorrang! 

-  ATARI  betreibt  den  Blitter  standardmaBig  mit  geloschtem  HOG-Bit 
(CPU  und  Blitter  teilen  sich  Buszugriffe  ftir  jeweils  64  Buszyklen). 
Um  jedoch  nahezu  die  gleiche  Verarbeitungsgeschwindigkeit  wie 
bei  gesetztem  HOG-Bit  zu  erreichen  (ca.  90%  des  HOG-Modus), 
macht  die  CPU  wahrend  “ihrer”  64  Busszyklen  nichts  anderes,  als 
den  Blitter  sofort  wieder  neu  zu  starten,  so  daB  dieser  unmittelbar 
(nach  ca.  sieben  CPU-Buszyklen)  die  Buskontrolle  zuriickbekommt! 
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Progrannbeispiel : 

START: 

lea  Line..NuM,R0 

bset.b  #HOGBIT,CR0) 

j  Pointer  auf  HOG-Register  ->  B0 
:  HOG-Bit  loschen  (Kein  HOG- Modus! ) 

RESTBRT: 

bsel.b  ttBUSYBIT, (BB) 
nop 

bne.s  RESTBRT 

■ 

■ 

j  BUSV-Bil  teslen  u.  setzen  Cstartet 
j  den  BLITTER  sofort  uieder  neu!) 
j  Der  "nop"-Befehl  Hird  noch  ausgefiihrt, 
i  beuor  der  Blitter  neu  startet! 

Abb.  2.16:  Programmbeispiel 


BUSY  Wenn  alle  anderen  Register  des  Blitters  gesetzt  sind,  wird  durch  Setzen  des 

BUSY-Bits  imBlitter  derTransfer  ausgelost.  Der  auf  das  Setzen  des  BUSY- 
Bits  folgende  Befehl  wird  von  der  CPU  in  der  Regel  aber  noch  ausgefiihrt, 
bevor  der  Blitter  das  Regiment  iibemimmt! 

Die  Interrupt-Leitung  zum  MFP,  Port  13  (GPU  done),  ist  direkt  mit  diesem 
Bit  gekoppelt,  Wenn  der  Blitter  fertig  ist,  wird  das  BUSY-Bit  zuriickge- 
setzt,  und  die  GPU-done-Leitung  geht  zuriick  auf  Low. 


Wer’s  gerne  knifflig  mag, 

kann  den  Blitter  ja  direkt  programmieren.  Die  besprochenen  Register  und  Steuerbits  mtissen 
jedoch  alle  vom  Programmierer  vor  dem  Bit-Block-Transfer  selbst  gesetzt  werden!  Die 
Beispiele  fur  SKEW,  NFSR,FXSRusw.warenjanochrelativanschaulich.  WerLusthat,  kann 
sich  ja  mal  iiberlegen,  was  alles  zu  beachten  ist,  wenn  sich  zu  tibertragende  Bitblocke  iiberlap- 
pen  (und  dabei  gibt’s  dann  noch  die  Moglichkeiten,  dal)  die  Sourceadresse  kleiner  oder  groBer 
als  die  Zieladresse  ist)! 

Aber  ATARI  hat  den  Bit-Block-Transfer  in  neueren  TOS-Versionen  “transparent”  fur  den 
Programmierer  ausgelegt.  Das  bedeutet  nichts  anderes,  als  dal)  die  BitBlt-Funktion  die  mit  der 
Line- AFunktion  SA007  aufgerufen  wird,  sowohl  durch  den  Blitter  als  auchin  Softwareemulation 
durch  die  CPU  (wie  gehabt)  ausgefiihrt  werden  kann.  Wenn  der  Blitter  eingebaut  ist,  bietet 
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einem  das  TOS  in  der  Desktop-Mentileiste  unter  dem  Eintrag  “Extras”  die  Moglichkeit,  diesen 
ein-  und  auszuschalten.  Die  gleiche  Funktion  ist  mit  dem  XBIOS-Aufruf  #64  (“Blitmode”) 
moglich.  Sie  kann  auch  benutzt  werden,  um  abzufragen,  ob  der  Blitter  eingebaut  ist.  Naheres 
dazu  in  Teil  I,  Kapitel  1,  in  der  “XBIOS-Referenz”  Zur  hardwaremaSigen  Einbindung  des 
Blitters  sei  auf  die  Abbildung  2.17  verwiesen. 


Wie  dort  zu  sehen,  handelt  es  sich  beim  Blitter  mit  semen  23  AdreB-  und  16  Datenleitungen 
sowie  dem  kompletten  Satz  an  Steuer-  und  Meldeanschlussen  um  einen  vollwertigen  Mikro- 


Abb.  2.17:  Die  Einbindung  des  BLITTERs  in  die  ST -Hardware 


Das  Graf iksy  stem 
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prozessor,  der  sich  in  einem  68000er-System  “zu  Hause”  fiihlt.  Als  eigenstandiges  DMA- 
Device  kann  er  deshalb  in  einem  68000er-System  die  Bussteuerung  ubemehmen. 

DieTaktversorgung  erfolgt  ebenfalls  mit  dem  gleichen  8-MHz-Takt,  wie  ihn  die  CPU  des  ST 
erhalt. 

Auf  die  einzelnen  Steuer-  und  Meldeleitungen  im  einzelnen  einzugehen.wurde  den  Rahmen 
sprengen.  AuBerdem  haben  diese  imPrinzip  die  gleiche  Funktion  wie  bei  einer  68000er-CPU 
(ein  paar  Informationen  finden  sich  auch  in  Teil  II,  Kapitel  I ,  im  Abschnitt  iiber  den  System- 
bus  des  MEGA  ST). 

Die  Anschliisse  BGI  und  BGO  dienen  der  Verkettung  des  Blitters  mit  den  anderen  DMA- 
Einheiten  des  ST.  Das  Signal  BG  (Bus  Grant  =  Bus  Freigabesignal)  gelangt  namlich  von  der 
CPU  an  BGI  (Bus  Grant  In)  des  Blitters  und  von  dessen  BGO- AnschluB  (Bus  Grant  Out)  wieder 
hinaus  anBGIdes  GLUE-Chips  (dereinen  GroBteil  derDMA-Logikdes  ST  enthalt).  Ebenfalls 
wird  das  BGACK-Signal  vom  GLUE  erst  durch  BGKI  -  BGACK  des  Blitters  “gefadelt”,  bevor 
es  dann  als  BGACK-Signal  an  die  CPU  gelangt.  Damit  bekommt  der  Blitter  immer  als  erster 
mit,  wenn  die  DMA-Einheit  des  ST  den  Bus  beansprucht. 
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Die  ST-Computer  konnen  nicht  nurper  MIDI-Schnittstelleaktiv  ins  Musikgeschehen  eingrci- 
fen,  sondern  sind  auch  in  der  Lage,  eigene  Laute  von  sich  zu  geben.  So  wird  z.  B .  der  Keyclick, 
die  akustische  Untermalung  der  Tastaturbedienung,  von  dem  eingebauten  Soundchip  erzeugt. 

Die  Konstrukteure  von  Atari  haben  hierbei  auf  einen  Standard-Chip  zuriickgegriffen,  der  zwar 
nicht  durch  iiberragende  Soundeigenschaften  hervortritt,  aber  wohl  ein  recht  gutes  Kosten-/ 
Leistungsverhaltnis  aufweist.  Zum  Einsatz  kommt  ein  Chip  des  Typs  “YM  2 149”  von  Y amaha 
oder  der  Typ  “AY-3-8910”  von  General  Instruments.  Beide  sind  untereinander  voll  hard-  und 
softwarekompatibel. 

Die  Tonerzeugung  liegt  voll  unter  Programmkontrolle,  alle  wesentlichen  Parameter  sind 
durch  Software  einstellbar.  Der  PSG  (Programmable-Sound-Generator)  wird  mit  einem  aus 
dem  Systemtakt  gewonnenen  2  MHz  Arbeitstakt  versorgt.  Daraus  konnen  mit  Hilfe  von  drei 
programmierbaren  Teilerstufen  Ausgangsfrequenzen  von  30  Hz  bis  1 25  KHz  erzeugt  werden. 
Die  Ausgangssignale  haben  Rechteckform. 


Rauschen  erwiinscht 

Femer  integriert  in  den  PSG-Chip  ist  ein  Rauschgenerator,  dessen  Ausgangssignal  beliebig 
iiber  eine  Mixstufe  mit  den  Ausgangssignalen  der  drei  Tongeneratoren  kombiniert  werden 
kann.  Das  Rauschsignal  ist  ein  Rechtecksignal,  dessen  Pulsbreite  durch  Pseudo-Zufallswerte 
bestimmt  wird. 

Die  CPU  wird  bei  der  Tonerzeugung  nur  wenig  benotigt,  da  der  PSG  ein  gewisses  Mali  an 
Eigenintelligenz  besitzt.  Sind  die  fur  einen  bestimmten  Sound  notigen  Parameter  in  den  Regi- 
stem  des  PSG  eingestellt,  so  liegt  die  eigentliche  ‘  ‘Arbeit”  der  Tonerzeugung  beim  Soundchip. 
Die  CPU  mu8  nur  aktiv  werden,  wenn  der  Sound  verandert  werden  soil. 


Lautstarke  unter  Programmkontrolle 

Zur  Beeinflussung  der  Lautstarke  der  erzeugten  T5ne  steht  fiir  jeden  der  drei  Soundkanale  ein 
elektronischerLautstarke-StellerzurVerfugung.EsbestehtdieMoglichkeit,dieAusgangsam- 
plitude  (Lautstarke)  in  16  Stufen  einzustellen.  Diese  Abstufung  verlauft  nicht  linear,  sondern 
logarithmisch  und  ist  damit  dem  Horempfinden  des  menschlichen  Ohres  besser  angcpaRt. 
Weiterhin  bietet  der  PSG  die  Moglichkeit,  bestimmte  Lautstarkeverlaufe  eines  Tones  abzuru- 
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fen  und  damit  den  Amplitudenverlauf  des  Ausgangssignals  zu  steuem.  Acht  solcher  Hullkurven 
(Envelopes)  sind  berelts  vorprogrammiert  und  konnen  abgerufen  werden. 
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Abb.  3.2  :  Die  Hullkurve  um  ein  Rechtecksignal 


Nicht  nur  Tone  werden  erzeugt 

Zusiitzlich  zu  seinen  Tongeneratoren  besitzt  der  PSG-Chip  noch  zwei  I/O-Ports,  die  zur 
Bedienung  der  parallelen  Schnittstelle,  der  seriellen  Schnittstelle  und  fur  die  Erzeugung  eini- 
ger  Steuersignale  fur  die  Floppy-Disk-Steuerung  benutzt  werden. 

Zur  gesamten  Steuerung  aller  Funktionen  des  PSG  besitzt  dieser  1 6  Register  mit  jeweils  8  Bit 
Breite  (also  Bytezugriffe  erforderlich!). 

Diese  16  Register  sind  jedoch  nicht  direkt  zuganglich,  sprich  an  16  verschiedenen  Adressen 
im  I/O-Speicherraum  des  ST  zu  finden,  sondem  werden  folgendermaBen  angesprochen: 

In  die  Speicherstelle  $FF  8800  (Label:  “giselect”)  wird  die  Nummer  des  Registers  einge- 
schrieben,  das  angesprochen  werden  soil  (Registernummer  0..15). 

-  Soli  der  Inhalt  des  so  ausgewahlten  Registers  verandert  werden,  so  muB  dessen  neuer 
Inhalt  an  Speicherstelle  $FF  8802  (Label:  “giwrite”)  geschrieben  werden. 

—  Den  Inhalt  eines  selektierten  Registers  kann  man  an  Adresse  $FF  8800  (Label:  “giread”) 
auslesen. 
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Diese  Art  von  Zugriff  mag  umstandlich  erscheinen,  ist  jedoch  auf  die  Hardwaregegebenheiten 
des  PSG-Chips  zuriickzufiihren  (Gemultiplexter  AdreB-  und  Datenbus)!  Ein  Vorteil  dieser 
Zugriffsart  liegt  darin,  daB  alle  PSG-Register  fiir  eine  Zugriffsart  (Schreiben  oder  Lesen)  auf 
der  gleichen  Speicherstelle  zu  finden  sind.  So  entfallen  AdreBberechnungen  fiir  Zugriffe  auf 
verschiedene  Register,  Es  wird  so  lange  auf  das  gleiche  PSG-Register  zugegriffen,  bis  ein 
anderes  ausgewahlt  wild. 
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Abb.  3.3:  Die  Register  des  Soundchips 


Nun  zur  Bedeutung  der  einzelnen  Register,  wie  in  Abbildung  3.3  dargestellt: 

R0..R5  Jeder  der  drei  Tongeneratoren  besitzt  zur  Frequenzeinstellung  zwei  8-Bit- 

Register.  Die  oberen  vier  Bits  des  hoherwertigen  Registers  werden  jedoch 
nicht  benutzt,  so  daB  sich  insgesamt  ein  4  +  8  =  12  Bit- Wert  fiir  die  Tonfre- 
quenzsteuerung  ergibt.  Die  Tonerzeugung  geschieht  dabei  nach  foigendem 
Prinzip: 
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Der  Arbeitstakt  des  PSG  (2  MHz)  wird  zunachst  durch  16  geteilt.  Daraus 
ergibt  sich  als  Eingangsfrequenz  fiir  die  drei  Tonerzeugungsstufen  eine 
Frequenzvon  125kHz.DieserTaktgelangtinjederderTonerzeugungsstufen 
auf  eine  Teilerstufe,  deren  Teilerfaktor  durch  den  12-Bit-Wert  im  zugeho- 
rigen  “Tongenerator-Control-Register”  bestimmt  wird.  1st  also  z.  B.  im 
“Periodendauer-Generator-C-Register”  der  Wert  wie  folgt 
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eingetragen  (entspricht  einem  Wert  von  $03E8heju  (=  1000dcz)),  so  ergibt 
sich  daraus  eine  Ausgangsfrequenz  fiir  den  Tongenerator  C  von: 

125  kHz  /  1000  =  0.125  kHz  =  125  Hz 

Je  kleiner  also  der  Wert  im  Tongenerator-Control-Register  ist,  desto  heller 
klingt  der  erzeugte  Ton, 

R6  Die  fiir  den  Rauschgenerator  maxima]  zur  Verfugung  stehende  Frequenz  ist 

ebenfalls  125  kHz.  Diese  Arbeitsfrequenz  gelangt,  analog  zu  der  Ton- 
generator-Steuerung,  auf  eine  mit  dem  “Tonhohe-Rauschen-Register”  zu 
programmierende  Teilerstufe.  Die  daraus  gewonnene  Frequenz  dient  dem 
eigentlichen  Rauschgenerator  als  Eingangsfrequenz.  Auch  hierbei  gilt:  Je 
kleiner  der  Wert  im  Register  6  (Tonhohe  Rauschen),  desto  heller  klingt  das 
Rauschen. 

Bild  7  Durch  entsprechendes  Setzen  bzw.  Loschen  einzelner  Bits  in  diesem 

Register  7  wird  fiir  jeden  der  drei  moglichen  Soundkanale  eingestellt,  ob  ein 
“reiner”TonerzeugtwirdoderobdiesermitRauschenvomRauschgenerator 
unterlegt  wird. 

Die  Steuerung  erfolgt  Low-aktiv,  d.  h.,  bei  geloschtem  Bit  ist  die  entspre- 
chendeFunktion  angewahlt.  IstbeispielsweisenurBit  1  Low,  dann  wird  nur 
das  Signal  des  Tongenerators  B  weiter  verwendet.  Wird  jetzt  noch  zusatz- 
lich  Bit  4  Low,  so  wird  das  Signal  des  Tongenerators  B  mit  dem  Signal  des 
Rauschgenerators  zusammengemischt.  AuGerdem  wird  durch  Register  7 
(Bit  6.  .7)  festgelegt,  ob  die  J/O-Ports  des  PSG  als  Eingange  Oder  Ausgange 


864 


ATARI  Profibuch 


arbeiten.  Es  ist  jedoch  nicht  moglich,  fiir  jeden  Anschlufi  der  PSG-Ports 
separat  (also  bitweise)  die  Datenrichtung  festzulegen! 

R8..R10  Die  Register  R8 . .  R 1 0  steuem  die  “Lautstarkesteller”  des  PSG.  Dabei  sind 

die  Bits  “L0..L3”  die  sogenannten  “Level-Control-Bits”  und  bestimmen 
den  Ausgangspegel  der  drei  Soundkanale. 

Die  Ausgangsamplitude  laBt  sich  mit  diesen  vier  Bits  in  16  Stufen  einstel- 
len.  Ist  das  “M-Bit”  gesetzt,  wird  der  Verlauf  der  Ausgangsamplitude  des 
entsprechenden  Kanals  nicht  durch  die  Level-Control-Bits,  sondem  durch 
den  Hiillkurvengenerator  gesteuert. 

R11/R12  Der  aus  den  2  x  8  =  16  Bit  der  Register  1 1  und  12  des  PSG  gebildete  Wert 

beeinfluBt  die  Periodendauer  der  Hiillkurve.  Die  Form  der  Hiillkurve  wird 
mit  Register  13  ausgewahlt. 

Als  Eingangsfrequenz  steht  hierbei  die  durch  256  geteilte  Taktfrequenz  des 
PSG  (2  MHz/256  =  7,8125  kHz)  zur  Verfiigung,  Diese  wird  entsprechend 
dem  16Bit-Wert  in  Register  11  und  12  weiterheruntergeteilt.Eslassensich 
so  Periodendauern  von  128  uSek.  (Reg.  11  +  12  =  $0000)  bis  ca.  acht  Sek. 
(Reg.  11  +  12  =  $FFFF)  einstellen. 

R13  Mit  den  vier  niederwertigen  Bits  des  Registers  1 3  wird  die  Hiillkurvenform 

eingestellt,  die  durch  den  Hiillkurvengenerator  erzeugt  wird.  Da  nur  ein 
Envelope-Generator  vorhanden  ist,  gilt  der  Verlauf  der  Hiillkurve  fiir  alle 
Soundkanale,  fur  die  das  M-Bit  im  Amplitudenregister  gesetzt  ist.  Es  laBt 
sich  also  leider  nicht  fiir  jeden  Soundkanal  eine  eigene  Hiillkurve  einstel¬ 
len!  Die  oberen  vier  Bits  des  Registers  haben  keine  Funktion. 

R14/R15  Uber  Register  1 4  und  1 5  wird  der  Datentransport  mit  den  beiden  I/O-Ports 

des  PSG  abgewickelt.  Port  A  ist  beim  ST  als  Ausgang  geschaltet  und  kon- 
trolliert  einige  Floppy-Disk-Steuerleitungen  sowie  Steuerleitungen  der 
seriellen  und  parallelen  Schnittstelle  (siehe  Abbildung  3.1). 

Port  B  bedient  die  Datenleitungen  der  parallelen  Schnittstelle. 

Wie  schon  der  Schaltungsauszug  (Abbildung  3.1)  zeigt,  sind  die  drei  Tonausgange  des  PSG 

direkt  miteinander  verbunden. 

Das  Summensignal  der  drei  Soundkanale  gelangt  iiber  einen  Impedanzwandler  an  Pin  1  der 

Monitorbuchse  und  kann  dort  abgenommen  werden. 
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Peri odendauer 
der  Hullkurve 


Abb.  3.4:  Die  Bedeutung  der  Steuerbits  im  Hiillkurvenform-Register  (Reg.  13) 
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Es  besteht  die  Moglichkeit,  ein  extemes  T onsignal  fiber  Pin  5  der  Monitorbuchse  einzuspeisen. 
Dieses  Signal  wird  dann  zu  den  vom  PSG  erzeugten  Signalen  hinzugemischt.  Eine  weitere 
Beeinflussung  des  extemen  zugefiihrten  Signals  ist  nicht  moglich. 

Von  Port  A  des  PSG  sind  die  Ausgange  IOA6  und  10 A7  im  ST  nicht  weiter  benutzt  und  stehen 
dem  Endbenutzer  fur  eigene  Anwendungen  zur  Verfugung  (viele  Erweiterungen  wie  z.  B.  16 
MHz-Beschleunigerkarten  benutzen  diese  freien  Ports).  Die  Ausgange  konnen  eine  Standard- 
TTL-Last  treiben. 

-  I0A6  ist  auf  Pin  3  der  Monitorbuchse  gefiihrt  und  kann  dort  abgegriffen  werden. 
I0A7  ist  nur  im  ST  am  PSG  direkt  abzugreifen  und  nicht  nach  auBen  gefiihrt. 


Betriebssystemunterstutzter  Sound 

Der  PSG  ist  von  den  Systemprogrammierem  bei  der  Programmierung  des  Betriebssystem 
beriicksichtigt  worden.  Fiir  das  Loschen  bzw.  Setzen  einzelner  Bits  in  I/O-Port  A  des  PSG  sind 
die  XBIOS-Funktionen  #29  und  #30  (“Offgibit”  und  “Ongibit”)  vorgesehen.  Mit  der  XBIOS- 
Funktion  #28  (“Giaccess”)  kann  auf  jedes  Register  des  PSG  zugegriffen  werden. 

AuBerdem  ist  ein  Pseudo-Sound-Prozessor  mit  eigenem  Pseudo-Befehlssatz  per  XBIOS- 
Aufruf  (siehe  XBIOS-Funktion  #32,  “Dosound”)  aufrufbar.  Dieser  Auff  uf  erlaubt  das  relativ 
einfache  Programmieren  von  Soundeffekten,  welche  quasi  neben  einem  anderen  Programm 
ablaufen  konnen  (im  Timer  C-Interrupt).  Durch  die  Verwendung  des  Port  A  des  PSG  fiir  die 
Floppy-Disk-Steuerung  ist  das  unmittelbare  Ansprechen  derFloppy-Steuerleitungen  des  PSG 
aus  z.  B..  BASIC  heraus,  durch  PEEK-  und  POKE-Befehle  etwas  schwierig. 

Wahrend  des  VBlank-Interrupts,  also  alle  20  mSek.  bei  Farbbetriebsart  bzw.  alle  14  mSek. 
in  Monochrombetriebsart,  werden  namlich  vom  Betriebssystem  die  angeschlossenen  Disk- 
laufwerke  abgefragt,  um  festzustellen,  ob  der  Motor  noch  lauft.  Wenn  dieser  nicht  mehr  lauft, 
wird  das  entsprechende  Laufwerk  deselektiert.  Um  jedoch  festzustellen,  ob  der  Motor  noch 
lauft,  muB  das  entsprechende  Disklaufwerk  jeweils  selektiert  werden.  Das  erfolgt  fiber  den 
PSG,  Port  A,  Leitung  1  oder  2. 

Es  ist  also  bei  PEEK  und  POKE  aus  BASIC  heraus  ziemlich  wahrscheinlich,  daG  zwischen 
einer  vom  Anwender  erfolgten  Registerauswahl  im  PSG  und  dem  Beschreiben  oder  Lesen  des 
selektierten  Registers  der  VBlank-Interrupt  des  Betriebssystems  dazwischenrutscht. 

Diese  Routine  selektiert  aber  immer  das  Port  A-Register,  um  dort  mit  den  Drive-Select-Lei- 
tungen  “herumzuspielen”.  Leider  ist  diese  Routine  des  Betriebssystems  nicht  so  program- 
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miert,  daft  sie  den  Zustand  des  PSG  nach  Laufwerksselektion  wieder  so  herste]lt,  wie  er  vor 
Laufwerksauswahl  vorgefunden  wurde! 

Deshalb  ist  es  empfehlenswert,  bei  Registerzugriffen  auf  den  PSG-Chip  aus  Hochsprachen 
wie  z.  B..  BASIC  heraus  die  Betriebssystemroutinen  zu  verwenden. 

Hier  als  Beispiel  ein  kleines  OMIKRON.BASIC-Programm  zum  Auslesen  der  Register  des 
ST-Soundchips  unter  Benutzung  der  XBIOS-Funktion  #28,  “Giaccess”: 


100  1  Program  zum  Auslesen  der  16  Register  des  ST-Soundchips 
110  1  durch  Benutzung  der  XBIOS-Funktion  "Giaccess"  (XBI0S  #28) 
120  1 
130  CLS 
140  PRINT 

150  PRINT  TAB  (10);"  Registerinhalte  des  PSG-Chips" 

160  PRINT  TAB  (10)  ■''================================='' 

170  PRINT 

180  PRINT  "  PSG-Register  I  7  I  6  I  5  I  4  I  3  I  2  I  1  I  0  I" 

190  PRINT  "  - — + — + — +-— + — + — +" 

200  FOR  Register*=0  TO  15 
210  USING  "tttttt11 

220  PRINT  "  Register  "{Register*;"  | 

230  Print_Bits(Register*) 

240  NEXT  Register* 

250  END 
260  1 

270  1  Registerinhalt  in  Tabellenfarn  ausgeben 
280  1 

290  DEF  PRDC  Print-Bits (Register*) 

300  XBIOS  (Wert*; 28,0, Register*) 

310  USING  "#0  |  #  |  #  |  #  |  #  |  #  |  #  |  #  |" 

320  PRINT  RIGHTS (  STR$(  VAL(  BINS (Wert*))) ,31) 

330  RETURN 


Abb.  3.5:  Auslesen  der  PSG-Registerinhalte 


Kapitel  4:  Der  Multifunktionsbaustein 
MFP  68901 


Der  MFP  (Multi  Function  Peripheral  -  Peripherie-Baustein  mit  Mehrfach-Funktion)  1st  ein 
“Familienmitglied”  der  MC  68000-Serie  und  arbeitet  deshalb  sehr  eng  mit  der  68000er  CPU 
zusammen.  Im  ATARI  ST  iibemimmt  der  MFP  eine  Reihe  von  Aufgaben. 


USART 

Der  USART  (Universal  Synchronous/Asynchronous  Receiver/Transmitter  =  Universeller 
Synchron-/Asynchron  Empfanger/Sender)  bedient  die  serielle  Schnittstelle  des  ST.  Naheres 
iiber  diese  Funktionseinheit  des  MFP  ist  bei  der  Beschreibung  der  seriellen  Schnittstelle  des 
ST  zu  finden. 


8-Bit-Parallelport 

Der  MFP  besitzt  8 1/O-Anschliisse  (den  General  Purpose  Input/Output  Interrupt  Port =GPIP). 
Jeder  AnschluB  kann  fur  sich  als  Ein-  bzw.  Ausgang  geschaltet  werden.  Beim  ST  stnd  jedoch 
alle  acht  Anschliisse  als  Eingange  programmiert  und  auch  belegt.  AuBerdem  kann  jeder  als 
Eingang  geschaltete  AnschluB  des  MFP  auch  als  Interrupt-Eingang  benutzt  werden.  Durch 
entsprechende  Programmierung  kann  eingestellt  werden,  ob  ein  Interrupt  bei  steigender  oder 
fallender  Eingangs-Signalflanke  ausgelost  werden  soil. 

Der  Parallelport  wird  mit  drei  Registem  zu  je  8  Bit  Breite  gesteuert  (siehe  auch  Ubersichtsbild 
des  MFP-GPIP,  Abbildung  4.1).  Diese  Register  haben  folgende  Funktionen: 


Adresse  Zugriff  Funktion  des  Registers  Label 

SFFFA01  R  GPIP-Data-Register  (GPIP)  “GPIP” 

Das  Auslesen  dieses  Register  liefert  die  log.  Pegel  der  entspre- 
chenden  Eingangsanschliisse. 

Bit  0  stellt  den  Pegel  auf  der  BUSY-Leitung  der  parallelen 
Schnittstelle  des  ST  dar.  Bei  nicht  angeschlossenem  Drucker  ist 
dieses  Bit  gesetzt  (AnschluB  liegt  iiber  Pull-Up-Widerstand  an 
+5V). 
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Adresse  Zugriff  Funktion  des  Registers  Label 


SFFFAOl  R  GPIP-Data-Register  (GPIP)  “GPIP” 

Die  Bits  1,2  und6(-  Inputs  II,  12  und  16)  werden  im  ST  fiir  das 
Handshaking  mit  der  seriellen  Schnittstelle  benutzt. 

Der  Eingang  13  wird  nur  in  STs  mit  Blitter  benutzt.  Er  ist  fur  das 
“GPU-Done”-Signal  vom  Blitter-Chip  vorgesehen,  der  hier  mit 
einem  Low  meldet,  wenn  eine  BitBlt-Operation  abgeschlossen 
wurde. 

Mit  £(74  melden  die  beiden  ACIAs  (Asynchronous-Communi¬ 
cation-Interface-Adapter)  unter  anderem  den  Zeichenempfang 
von  der  Tastatur  oder  der  MIDI-Schnittstelle.  Tritt  ein  Interrupt 
von  den  ACIAs  auf,  wird  die  Leitung  14  auf  Low  gezogen. 

Welcher  ACIA  mit  seiner  ERQ-Leitung  “gelautet”  hat,  wird  vom 
Betriebssystem  durch  Abfrage  der  beiden  ACIA-Statusregister 
ermittelt. 

Port  15  ist  wichtig  fiir  die  Uberwachung  des  Floppy-Disk- 
Controllers.  Durch  Abfrage  des  Bit  5  wird  getestet,  ob  der  Flop¬ 
py-Controller  einen  Befehl  beendet  hat. 

AuBerdem  melden  hieriiber  evtl.  am  ACSI-Bus  angeschlossene 
TARGETS  den  AbschluB  eines  Datenaustauschs  liber  diesen 
schnellen  DMA-Bus. 

Ein  Low  an  diesem  Eingang  signalisiert  also  einen  Interrupt 
durch  den  FDC  oder  den  ACSI-Bus. 

Eingang  17  “lauscht”  an  der  Monochrom-Detect-Leitung  der 
Monitor-Buchse.  Ist  der  Monochrom-Monitor  angeschlossen, 
liegt  Eingang  17  auf  Low-Potential. 

Wird  z.  B.  im  Monochrom-Betrieb  der  Stecker  des  Monitors 
abgezogen  und  ein  Farbmonitor  angeschlossen,  so  wird  dies  vom 
Betriebssystem  im  Vertikal-Blank-Interrupt  festgestellt  und  die 
neue  Betriebsart  eingestellt  (iiber  eine  Neuinitialisierung  des 
Systems). 
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Abb.  4.1:  Der  General-Purpose-HO-Port  (GP1P)  des  MFP  (MC68901 )  im  ATARI  ST 
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Adresse  Zugriff  Funktion  des  Registers  Label 


SFFFA03  R/W  Active-Edge-Register  (AER)  “AER” 

Hiermit  iaBt  sich  einstellen,  wann  durch  einen  der  acht  Eingange 
ein  Interrupt  ausgelost  wird.  Bit  0  ist  hierbei  dem  AnschluB  10 
zugeordnet,  Bit  1  dem  AnschluB  II  usw.  Bei  geloschtem  Bit 
erfolgt  ein  Interrupt  bei  einem  High  ->  Low-Ubergang,  bei  ge- 
selztem  Bit  wird  bei  Low->  High-Ubergang  unterbrochen. 

Die  zugehorigen  Interrupts  werden  mit  den  Namen  der  Ports 
bezeichnet.  Interrupt  II  wird  also  durch  Port  II  ausgelost.  In¬ 
terrupt  12  durch  Port  12  usw.  Zu  der  Interruptbehandlung  des 
MFP  jedoch  spater  mehr. 

$FF  FA05  R/W  Data-Direction-Register  (DDR)  “DDR” 

Im  DDR  wird  festgelegt,  welche  der  acht  I/O-Anschliisse  als 
Eingang  und  welche  als  Ausgang  arbeiten.  Im  Gegensatz  zum 
Soundchip  (PSG)  kann  hier  fur jeden  einzelnen  PortanschluB  die 
Datenrichtung  festgelegt  werden. 

Ein  gesetztes  Bit  bedeutet  hierbei,  daB  der  zugehorige  Port¬ 
anschluB  als  Ausgang  arbeitet.  Bei  einem  geloschten  Bit  ist  also 
der  entsprechende  Port  als  Eingang  programmiert. 

Beim  ST  sind  alle  Ports  als  Eingang  geschaltet.  Alle  Bits  sind 
also  geloscht. 


Timer 

Der  MFP  besitzt  vier  Timer  (Zeitgeber)  zu  je  acht  Bit.  Gesteuert  werden  die  Timer  von  einem 
eigenen  Oszillator.  Man  hat  die  Moglichkeit,  einen  Quarz  zwischen  die  Anschliisse  XTALO 
und  XTAL1  zu  “setzen”  oder  liber  XTALO  einen  Takt  mit  TTL-Pegel  einzuspeisen. 

Die  Timer  konnen  damit  vollig  unabhangig  von  dem  am  CLK-Eingang  des  MFP  anliegenden 
Takt  oder  sonstigen  im  System  verwendeten  Takten  arbeiten.  (Der  CLK-Takt  dient  lediglich 
der  Steuerung  des  intemen  Timing  im  MFP  und  muB  nicht  unbedingt  der  Systemtakt  sein  oder 
zu  diesem  in  Phase  liegen).  Der  Ausgang  des  Timer-Takt-Oszillators  speist  alle  vier  Vorteiler 
der  Timer  des  MFP  mit  einer  Frequenz  von  2,4576  MHz. 
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Abb.  4.2:  Die  Timer  des  MFP  (MC68901 )  im  ATARI  ST 


Fur  jeden  der  vier  Timer  ist  ein  eigener  Interruptkanal  vorgesehen.  Damit  kann  z.B.  nach  einer 
mit  dem  Timer  voreingestellten  Zeitdauer  (=  Zahl  von  Taktzyklen)  ein  Interrupt  ausgeldst 
werden. 

Die  Timer  des  MFP  konnen  in  verschiedenen  Betriebsarten  arbeiten.  Die  Funktionsweisen 
werden  nun  kurz  vorgestellt. 
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Reaktion  mit  Verzogerung  -  Der  Delay  Mode 

Alle  vier  Timer  konnen  als  Verzogerungs-Timer  arbeiten.  In  diesem  Delay  Mode  wechseln 
die  Timer-Ausgange  ihren  log.  Zustand,  wenn  eine  bestimmte,  programmierbare  Zahl  von 
Taktzyklen  nach  Starten  des  Timers  abgelaufen  ist.  AuBerdem  wird  dann  ein  Interrupt  fur  die- 
sen  Timer  ausgelost  (sofem  dieser  aktiviert  ist).  Im  Delay  Mode  arbeiten  die  Timer  nach  fol- 
gendem  Prinzip: 

-  Der  MFP-Timer-Oszillator  liefert  den 2,4576  MHz-Arbeitstakt  an  die  programmierbaren 
Vorteiler.  Die  auf  die  Vorteilerstufen  folgenden  Abwartszahler  erhalten  immer  dann 
einen  Iinpuls  von  der  Vorteilerstufe,  wenn  diese  die  eingestellte  Anzahl  von  Taktzyklen 
“gesehen”  hat.  Bei  einem  Vorteilerverhaltnis  von  1:10  gelangt  also  nach  je  zehn  Takt- 
zyklen  ein  Ausgangsimpuls  zum  Abwartszahler. 

-  Jeder  Impuls  vom  Vorteiler  emiedrigt  den  Zahlerstand  im  Abwartszahler  urn  1 .  Hat  der 
Abwartszahler  einen  Zahlerstand  von  1  erreicht,  wird  durch  den  nachsten  Impuls  vom 
Vorteiler  der  log.  Zustand  des  Timer-Ausgangs  geandert.  Gleichzeitig  wird  der  Abwarts¬ 
zahler  wieder  auf  einen  Anfangszahlerstand  gesetzt  (dieser  Anfangswert  wird  im  Timer- 
Data-Register  eingestellt)  und  ein  Interrupt  fiir  den  entsprechenden  Timer  ausgelost 
(sofem  dieser  zugelassen  ist). 

Dazu  ein  Beispiel: 

Wenn  der  Vorteiler  mit  einem  Teilerfaktor  von  1/64  eingestellt  wird,  erhalt  der  Abwartszahler 
alle  64  Taktzyklen  einen  Impuls.  Bei  einer  Taktfrequenz  von  2,4576  MHz  geschieht  das  somit 
alle  64/2  457  600  =  26,0417  pSek. 

Ist  der  Abwartszahler  tiber  das  Timer-Data-Register  mit  einem  Wert  von  64  geladen  worden, 
so  wechseltderTimerausgang  seinen  Zustand  nach  64  Impulsen  vom  Vorteiler  (=  64  x  26,0417 
pSek.  =  1,6667  mSek.),  und  der  Abwartszahler  wird  wieder  mit  dem  Wert  aus  dem  Timer- 
Data-Register  (im  Beispiel  =  64)  nachgeladen.  Nach  weiteren  64  Impulsen  vom  Vorteiler  (also 
nach  1 ,6667  mSek.)  wechselt  der  Timerausgang  wieder  auf  den  Anfangszustand  zuriick,  so 
daB  eine  voile  Periode  am  Timerausgang  2x1 ,6667  mSek.  =  3,333  mSek.  dauert.  Die  erzeugte 
Ausgangsfrequenz  betragt  dann  1  /  3,333  mSek.  =  300  Hz. 


Grenzwerte  im  Timer-Data-Register 

Gibt  man  dem  Timer-Data-Register  einen  Anfangszahlerstand  von  1 ,  so  wechselt  der  Timer¬ 
ausgang  mit  jedem  Impuls  vom  Vorteiler  seinen  Zustand.  Wird  der  Anfangszahlerstand  dage- 
gen  auf  0  eingestellt,  so  sind  256  Impulse  vom  Vorteiler  erforderlich,  bevor  sich  am  Timeraus¬ 
gang  etwas  “bewegt”. 
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Mit  den  Kombinationsmoglichkeiten,  die  der  Vorteiler  und  der  AbwartszShler  des  MFP  im 
Delay  Mode  bieten,  sind  beim  ST  so  Verzogerungszeiten  von  1 ,6276  uSek.  bis  20,8333  mSek. 
zu  realisieren,  Durch  die“krumme”Quarzfrequenzlassen  sich  insbesondere  diegebrauchlich- 
sten  Taktfrequenzen  fur  die  serielle  Dateniibertragung  einstellen! 


Am  Puls  des  Geschehens  -  Die  Pulsbreitenmessung 

Wahrend  der  Delay  Mode  mit  alien  vier  Timem  moglich  ist,  konnen  die  Timer  A  und  B  noch 
ein  wenig  mehr.  Wie  aus  dem  Ubersichtsbild  ersichtlich  ist  (Abbildung  4.2),  besitzen  diese 
beiden  Timer  zusatzlich  noch  je  einen  extemen  Eingang  TAI  (Timer- A-Input)  bzw.  TBI  (Ti- 
mer-B-Input).  MitHilfe  dieses  Eingangs  lafit  sich  die  Zeitdauer  eines  Ereignisses  feststellen. 

Fiir  die  Dauer  des  Ereignisses  mu 8  ein  entsprechender  “Ein”-Pegel  an  dem  TAI-  oder  TBI- 
Anschluft  anliegen.  Beim  ST  ist  jedoch  lediglich  der  Timer- A-Eingang  (TAI)  ohne  weiteres 
von  aufien  zuganglich.  Erist,  wie  aus  Abbildung  4.2  ersichtlich,  mit  dem  BUS  Y-Anschlu6  (Pin 
11)  der  parallelen  Schnittstelle  verbunden. 

Der  Timer  verhalt  sich  in  der  Betriebsart  “Pulsbreitenmessung”  ahnlich  wie  im  Delay  Mode 
(derprogrammierbare  Vorteiler  liefert  auch  hier  Impulse  an  den  nachfolgenden  Abwartszahler). 
Wahrend  Ein-Pegel  anliegt,  zahlt  der  Abwahrtszahler  im  Timer  A  (bzw.  B)  wie  im  Delay 
Mode  im  Takt  der  vom  Vorteiler  eingehenden  Impulse  herunter.  Geht  der  TAI-Anschlufi 
(bzw.  TBI)  auf  Aus-Pegel,  wird  der  Zahlvorgang  gestoppt. 

Da  man  den  Startwert  des  Abwartszahlers  ja  iiber  das  Timer-Data-Register  zu  Beginn  der  Puls¬ 
breitenmessung  eingestellt  hat,  kann  man  nun  iiber  die  Zahl  der  Impulse,  die  der  Zahler  bis 
zum  Stoppen  heruntergezahlt  hat,  die  Zeit  ermitteln,  fur  die  AnschluB  TAI  (bzw.  TBI)  auf  Ein- 
Pegel  lag. 


Was  ist  fiir  den  Timer  denn  nun  Ein-Pegel? 

Was  am  Timer-Eingang  TAI  (bzw.  TBI)  als  Ein-Pegel  gelten  soli,  wird  durch  Bit  4  (fiir  Timer 
A)  bzw.  Bit  3  (fiir  Timer  B)  im  Aktive-Edge-Register  (Label  “AER”  an  Adresse  $FF  FA03) 
des  MFP  eingestellt.  Ist  das  entsprechende  Bit  gesetzt,  so  wertet  der  Timer-Eingang  ein  High- 
Signal  als  Ein-Pegel,  und  dementsprechend  wird  bei  geloschtem  Bit  ein  Low-Signal  als  Ein- 
Pegel  angesehen. 

Mit  den  Bits  des  AER  wird  ja  sonst  festgelegt,  mit  welcher  Signalflanke  an  den  als  Eingangen 
geschalteten  I/O-Ports  (10.. .17)  des  MFP  ein  Interrupt  ausgelost  werden  soil  (siehe  Beschrei- 
bung  des  8-Bit-Parallelports,  Active-Edge-Register). 
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Die  zugehorigen  Portanschliisse  13  und  14  konnen  in  der  Betriebsart  Pulsbreitenmessung  der 
Timer  A  und  B  als  I/O-Ports  weiterverwendet  werden.  Interrupts  lassen  sich  dariiber  nicht 
mehr  auslosen!  Die  Interruptkanale  14  und  13  reagieren  jetzt  nur  auf  die  Signalflanken  am 
Timer-Eingang  TAI  bzw.  TBI!  Ein  Interrupt  wird  jetzt  ausgelost,  wenn  ein  Flankenwechsel 
an  dem  entsprechenden  Timer-Eingang  von  Ein-  auf  Aus-Pegel  stattfindet.  Hierzu  ein  Bei- 
spiel: 


Timer  A  sei  auf  Betriebsart  “Pulsbreitenmessung”  programmiert. 

-  Der  Vorteiler  A  ist  auf  1/10  eigestellt. 

Timer-A-Data-Register  und  somit  der  Abwartszahler  des  Timers  A  seien  mit  einem 
Startwert  von  200  geladen. 

-  Bit  4  im  Active-Edge-Register  sei  geloscht  (TAI  erkennt  also  Ein-Pegel  bei  Low). 

-  Timer  A  wird  gestartet  durch  Low  an  TAI  (BUS  Y -AnschluB  der  parallelen  Schnittstelle). 

-  Stop  fur  Timer  A  bei  High  an  TAI  und  Auslosung  eines  14-Interrupts  (wenn  dieser  zuge- 
lassen  ist). 

-  Der  Inhalt  des  Timers  A  wird  aus  dem  Timer-A-Data-Register  ausgelesen  und  lautet  bei- 
spielsweise  auf  100  (Stopwert). 


Abb.  43:  Die  Pulsbreitenmessung  mit  Timer  A 
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Die  Zeitdauer,  fur  die  TAI  (der  BUSY-Anschlufi)  auf  Low  war,  betragt  also: 

(Startwert  -  Stopwert)  (200  -  100) 

- =  -  =  407  pSek. 

Vorteiler  x  Taktfreq.  0,1  x  2,4576  MHz 

Man  kann  aber  nun  nicht  nur  Ereignisdauem  erfassen,  die  im  Wertebereich  des  8-Bit- 
Abwartszahlers  liegen.  Sollte  namlich  wahrend  der  Pulsbreitenmessung  der  Abwartszahler 
“durch”  1  zahlen,  so  wird,  genau  wie  im  Delay-Modus,  der  Timerausgang  TAO  (oder  TBO) 
seinen  Ausgangspegel  andem,  der  Abwartszahler  mit  dem  Wert  aus  dem  Timer-Data-Register 
neu  geladen  und  ein  Timer-Interrupt  auf  dem  entsprechenden  Interruptkanal  ausgelost  (sofem 
dieser  aktiviert  ist).  Mit  diesem  Timer-Interrupt  laBt  sich  nun  eine  Interruptroutine  ansteuem, 
die  mitzahlt,  wie  oft  der  Abwartszahler  wahrend  des  Ein-Pegels  an  TAI  (oder  TBI)  (=  Dauer 
des  Ereignisses)  komplett  heruntergezahlt  wurde. 

DieGesamtzahlderZahlimpulse(unddamitdieEreignisdauer),fiirdiederTimer“Ein”geschaltet 
war,  ist  damit  wie  folgt  zu  berechnen: 

(Zahl  der  Timer-Interrupts  x  Anfangswert  des  Timer-Data-Registers) 
plus  (Differenz  aus  Anfangs-  und  Endwert  im  Timer-Data-Register) 


Betrieb  als  Ereigniszahler 

Die  Timer  A  und  B  kennen  noch  eine  weitere  Betriebsart,  den  Event-Count-Mode.  Dabei  wird 
mit  den  Timem  jedoch  keine  Zeit  mehr  gemessen,  sondem  die  Zahl  von  aufgetretenen  Ereig- 
nissen  gezahlt. 

Hierfiir  werden,  wie  bei  der  Pulsbreitenmessung,  die  Timer-Eingange  TAI  bzw.  TBI  bendtigt. 
Die  Interrupts  14  bzw.  13  des  MFP  reagieren  auch  hier  wieder  nicht  auf  die  Signale  an  den 
Parallel-Ports  14 bzw.  13  des  MFP,  sondem,  wie  bei  derPulsbreitenmessung,  auf  Flankenwechsel 
an  den  T  AI-  bzw.  TBI- Anschliissen.  Beim  Betrieb  als  Ereigniszahler  sind  die  Vorteiler  A  bzw. 
B  jedoch  nicht  aktiviert  (es  sollen  ja  auch  keine  Zeitimpulse  gezahlt  werden!). 

Der  Abwartszahler  im  Timer  erhalt  also  seinen  Zahlimpuls  nicht  mehr  vom  Vorteiler,  sondem 
direkt  durch  einen  Pegelwechsel  am  TAI-  bzw.  TBI-AnschluB!  Jeder  Zahlimpuls  emiedrigt 
den  Abwartszahler  im  Timer  um  1 .  Hat  der  Abwartszahler  einen  Zahlerstand  von  1  erreicht, 
so  wird  durch  den  nachsten  Impuls  an  TAI  bzw.  TBI  der  Timerausgang  TAO  bzw.  TBO  seinen 
Pegel  andem  und  ein  entsprechender  Timer  A- bzw.  Timer  B-Interrupt  ausgelost,  wenn  dieser 
freigegeben  ist.  AuBerdem  wird  der  Abwartszahler  des  Timers  wieder  neu  mit  dem  Startwert 
aus  dem  Timer  A-  bzw.  Timer  B-Data  Register  geladen. 
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Ob  der  Zahlimpuls  fiir  den  Abwartszahler  bei  einern  Low/High-  oder  High/Low-Ubergang  am 
Timereingang  erzeugt  wird,  laBt  sich  auch  hier  wieder  durch  Setzen  bzw.  Loschen  des  Bit  4 
bzw.  Bit  3  im  Aktiv-Edge-Register  (Label  “AER”  an  Adr.  $FF  FA03)  festlegen. 

Ein  gesetztes  Bit  4  bzw.  Bit  3  bedeutet,  dafi  ein  Zahlimpuls  erzeugt  wird,  wenn  an  TAI  bzw. 
TBI  ein  Pegelwechsel  von  Low->High  erfolgt.  Bei  geloschtem  Bit  wird  ein  Zahlimpuls  bei 
High/Low-Wechsel  des  Timereingangs  erzeugt.  AuBerdem  wird  mit  jedem  erzeugten  Zahl¬ 
impuls  ein  Interrupt  fiir  den  entsprechenden  Interruptkanal  13  bzw.  14  erzeugt  (sofem  zugelas- 
sen).  Es  ist  aber  sinnvoll,  den  Interrupt  fiir  den  entsprechenden  TAI-  bzw.  TBI-AnschluB  zu 
sperren.  Das  Zahlen  der  Ereignisse  (Low/High- bzw  High/Low-Pegelwechsel)am  Timereingang 
konnte  ja  sonst  gleich  durch  die  Interrupt-Routine  erfolgen  und  nicht  durch  den  Abwartszahler 
im  Timer! 


Timer  B  als  Bildschirmzeilenzahler 

Im  ST  liegt  am  TBI-AnschluB  des  MFP  das  Signal  Display-Enable  an.  Dieses  Signal  geht  so 
lange  auf  High,  wie  eine  Bildschirmzeile  geschrieben  wird.  So  laBt  sich  mittels  Ereigniszahler 
z.  B .  nach  Ablauf  einer  programmierten  Zahl  von  Bildschirmzeilen  ein  Interrupt  auslosen,  um 
dann  eine  Display-Manipulation  durchzufiihren. 


Die  Timer-Register 

Die  Programmierung  der  vier  Timer  erfolgt  iiber  vier  8  Bit  breite  Timer-Data-Register  und 
drei  8  Bit  breite  Timer-Control-Register.  Timer  A  und  B  besitzen  je  ein  eigenes  Control- 
Register.  Fiir  die  Steuerung  von  Timer  C  und  D  reicht  ein  gemeinsames  8-Bit  Control  Register 
aus,  da  diese  Timer  ja  nur  eine  Betriebsart,  den  Delay  Mode,  kennen. 

Adresse  Zugriff  Funktion  des  Registers  Label 


$FFFA1F  R/W  Timer-A-Data-Register  “TADR” 

Beim  Auslesen  erhalt  man  den  augenblicklichen Zahlerstand  des 
Timers  A.  Wird  ein  Wert  in  das  Register  geschrieben,  so  gelangt 
dieser  gleichzeitig  in  den  Abwartszahler.  Dies  gilt  jedoch  nur  fiir 
den  Fall,  daB  der  Timer  gestoppt  ist! 

“Lauft”  dagegen  gerade  ein  Zahlvorgang,  so  gelangt  der  neu 
eingeschriebene  Wert  erst  in  den  Abwartszahler  des  Timers, 
wenn  dieser  durch  1  zahlt. 
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Adresse  Zugriff  Funktion  des  Registers 


Label 


$FF  FA21  RAV 


$FF  FA23  RAV 

$FFFA25  RAV 

$FF  FA  19  RAV 


Timer-B-Data-Register  “TBDR” 

Funktion  wie  bei  Timer  A  fur  Timer  B. 

Timer-C-Data-Register  “TCDR” 

Funktion  wie  bei  Timer  A  fur  Timer  C. 

Timer-D-Data-Register  “TDDR” 

Funktion  wie  bei  Timer  A  fiir  Timer  D. 

Timer-A-Control-Register  “TACR” 

Bit  0..3  dieses  Registers  bestimmen  Betriebsart  des  Timers  A 
und  Teilerverhaltnis  von  Vorteiler  A.  Bits  5. .7:  keine  Funktion. 


Bit-Nr. 

3210 

Funktion 

0000 

Timer  gestoppt  (*) 

0001 

Delay  Mode,  Vorteiler  auf 

1:4 

00  10 

Delay  Mode,  Vorteiler  auf 

1:10 

00  1  1 

Delay  Mode,  Vorteiler  auf 

1:16 

0100 

Delay  Mode,  Vorteiler  auf 

1:50 

0  10  1 

Delay  Mode,  Vorteiler  auf 

1:64 

0  110 

Delay  Mode,  Vorteiler  auf 

1:100 

0  111 

Delay  Mode,  Vorteiler  auf 

1:200' 

1000 

Ereigniszahlung 

1001 

Pulsbreitenmessung,  Vorteiler  auf 

1:4 

10  10 

Pulsbreitenmessung,  Vorteiler  auf 

1:10 

10  11 

Pulsbreitenmessung,  Vorteiler  auf 

1:16 

1  100 

Pulsbreitenmessung,  Vorteiler  auf 

1:50 

1101 

Pulsbreitenmessung,  Vorteiler  auf 

1:64 

1110 

Pulsbreitenmessung,  Vorteiler  auf 

1:100 

nil 

Pulsbreitenmessung,  Vorteiler  auf 

1:200 

(*)=  Zdhlvorgang  wird  unterbrochen.  Der  Inhalt  des  Timer-A-Abwartszahlers  bleibt  erhal- 
ten.  Wird  jetzt  ein  neuer  Wert  ins  T imer-A-Data-Register  geschrieben,  so  gelangt  dieser  auch 
sofort  in  den  Abwartszahler! 
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Adresse  Zugriff  Funktion  des  Registers 


Label 


1st  durch  Einschreiben  in  das  Register  das  Bit  4  gesetzt,  geht  der 
Timer-A-Ausgang  auf  Low-Pegel  und  bleibt  fur  die  Dauer  der 
Schreiboperation  Low, 

Danach  kann  der  Ausgang  abhangig  vom  Zahlvorgang  (Ab- 
wartszahlen  durch  1)  wieder  seinen  Zustand  wechseln. 

SFFFA1B  RAV  Timer-B-Control-Register  “TBCR” 

Die  Funktion  und  Bitbelegung  ist  die  gleiche  wie  ftir  das  Timer- 
A-Control-Register. 

$FFFA1D  RAV  Timer-C/D-Control-Register  “TCDCR” 

Die  Teilerverhaltnisse  fur  die  Vorteiler  C  +  D  werden  durch 
dieses  Register  kontrolliert.  Die  Bits  0..2  steuem  Timer  D,  die 
Bits  4.. 6  den  Timer  C. 


Bit-Nr. 

65  4(C)  Oder 

2  1  0  (D) 

Funktion 

000 

Timer  gestoppt  (*) 

001 

Delay  Mode,  Vorteiler 

1:4 

0  1  0 

Delay  Mode,  Vorteiler 

1:10 

01  1 

Delay  Mode,  Vorteiler 

1:16 

1  00 

Delay  Mode,  Vorteiler 

1:50 

101 

Delay  Mode,  Vorteiler 

1:64 

1  1  0 

Delay  Mode,  Vorteiler 

1:100 

1 1 1 

Delay  Mode,  Vorteiler 

1:200 

(*)=  Zahlvorgang  wird  unterbrochen.  Der  Inhalt  des  Timer-Abwdrtszahlers  bleibt  erhalten. 
Wirdjetzt  ein  neuer  Wert  ins  Timer-Data-Register  geschrieben,  so  gelangt  dieser  auch  sofort 
in  den  Abwdrtszahler! 


Achtung  bei  der  Timerprogrammierung 

Bei  der  Timerprogrammierung  sollte  man  sich  vorher  schon  genau  im  klaren  sein,  was  man 
erreichen  will  und  wie  der  Timer  sich  verhalten  soil.  So  muB  man  z.  B.  mit  falschen  Ergebnis- 


Der  Multifunktionsbaustein  MFP  68901 


881 


sen  rechnen,  wenn  das  Vorteilerverhaltnis  geandert  wird,  wahrend  der  Timer  “lauft”.  Weiter- 
hin  konnen  in  der  Betriebsart  “Pulsbreitenmessung”  und  “Ereigniszahlung”  Interrupts  auftre- 
ten,  wenn  man  die  Flankenbits  im  Active-Edge-Register  andert,  wahrend  der  Timer  arbeitet. 

Bei  der  Betriebsart  “Pulsbreitenmessung”  sollte  man  auch  darauf  achten,  dafi  einem  nicht  der 
Timer  schon  wieder  neu  gestartet  wird  (durch  Ein-Pegel  am  Timer-Eingang),  bevor  man  den 
Wert  im  Abwartszahler  fur  eine  neue  Messung  initialisiert  hat.  Im  Betriebssystem  des  ST  ist 
fiir  das  Setzeo  der  Timerregister  des  MFP  ein  eigener  XBIOS-Aufruf  vorgesehen  (siehe 
XBIOS-Funktion  #3 1 ,  “Xbtimer”).  Damit  wird  die  Timerprogrammierung  wesentlich  verein- 
facht. 

Bevor  nun  auf  die  Interrupt-Bearbeitung  des  MFP  eingegangen  wird,  zunachst  einige 
Erlauterungen  zur  Intenruptbehandlung  durch  die  68000er  CPU. 


Internipt-Steuerung 

Die  im  ST  verwendete  68000er-CPU  besitzt  “von  Haus  aus”  die  Moglichkeit,  Unterbrechun- 
gen  (Interrupts)  sieben  verschiedene  Prioritaten  (Interrupt-Level)  zuzuordnen. 

Interrupts  des  Level  7  besitzen  hochste  Prioritat  und  sind  auch  nicht  maskierbar,  d.  h.,  sie 
konnen  wiederum  durch  einen  Interrupt  der  Prioritat  7  unterbrochen  werden, 

Die  Interrupt-Level  1  ..6  sind  maskierbar  und  konnen  bei  entsprechender  Programmierung  der 
Unterbrechungsmaske  in  der  CPU  (Bits  8..  10  im  Supervisor-Status-Register)  nur  durch  einen 
hoher  priorisierten  Interrupt  unterbrochen  werden. 

Ein  in  Bearbeitung  befindlicher  Interrupt  setzt  die  Unterbrechungsmaske  dabei  automatisch 
auf  seinen  Interrupt-Level,  d.  h.,  er  kann  nur  durch  einen  Interrupt  hdherer  Prioritat  unterbro¬ 
chen  werden. 

Der  Level  0  bedeutet,  dafi  keine  Interrupt- Anforderung  gestellt  wurde. 


Interrupt-Prioritaten  im  ST 

Die  Interrupt-Prioritat  der  unterbrechenden  Einheit  wird  der  CPU  iiber  drei  Interrupt-Priority- 
Levei-Anschliisse  IPL0..IPL2  (low-aktiv)  “mitgeteilt”.  Im  ST  liegt  die  Leitung  IPLO  jedoch 
fest  auf  High,  so  dafi  nur  die  Interrupt-Ebenen  2, 4  und  6  existieren  (Beim  MEGA-ST  sind  die 
Interrupts  3, 5  und  7  auch  moglich.  Sie  konnen  jedoch  nur  iiber  Anschliisse  am  Megabus  ausge- 
lost  werden.  Siehe  auch  Teil  II,  Kapitel  1,  “Die  Zentraleinheit”). 
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Die  Interrupl-Ebene  2  wird  im  ST  durch  den  Horizontal-Blanking-Interrupt  (HBLANK- 
Interrupt)  belegt.  Dieser  Interrupt  tritt  immer  dann  auf,  wenn  eine  Bildschirmzeile  geschrieben 
wurde  und  der  Elektronenstrahl  im  Monitor  fiir  den  Strahlriicklauf  zum  Anfang  einer  neuen 
Zeile  dunkelgetastet  (ge”blanked”)  wird.  Um  jedoch  zu  vermeiden,  dafi  ein  laufendes  Pro- 
gramm  durch  jeden  Horizontal-Blankingimpuls  unterbrochen  und  damit  verlangsamt  wird,  ist 
die  Unterbrechungsmaske  der  CPU  im  ST  im  Normalfall  auf  3  gesetzt.  Der  HBLANK-Inter- 
rupt  ist  somit  maskiert  und  wird  nicht  ausgefiihrt. 

Die  bei  der  Systeminitialisierung  installierte  HBLANK-Interrupt-Routine  macht  nichts 
anderes,  als  die  Unterbrechungsmaske  in  der  CPU  auf  3  zu  setzen,  um  weitere  auftretende 
HBLANK-Interrupt-Anforderungen  unwirksam  zu  machen. 

Programmierer,  die  sich  den  HBLANK-Interrupt  zunutze  machen  wollen,  um  z.  B.  die  Farb- 
registerinhalte  zwischen  zwei  Bildschirmzeilen  zu  andem,  sollten  darauf  achten,  daB  zwi- 
schen  zwei  HBLANK-Interrupts  nur  64  pSek.  (28  pSek.  in  Monochrom-Betriebsart)  liegen. 
Die  Interruptroutine  hat  also  nicht  viel  Zeit,  um  ihre  Aufgabe  zu  erledigen.  Wenn  dann  noch 
der  Systemtimer-Interrupt  “dazwischenrutscht”  (Timer  C  “interrupted”  alle  5  msec.),  kann  es 
zu  einer  zittemden,  unruhigen  Bildschirmdarstellung  kommen. 

Man  kann  sich  mit  dem  Systemtimer-Interrupt  jedoch  dadurch  helfen,  indem  man  fiir  die  Zeit, 
in  der  mit  HBLANK-Interrupts  gearbeitet  wird,  den  Interruptvektor  fiir  den  Systemtimer  zu 
einer  ganz  kurzen  Routine  umleitet,  die  nichts  anderes  macht,  als  die  zwischenzeitlich 
auftretenden  Systemtimer-Interrupts  zu  zShlen. 

Sind  die  HBLANK-Interrupts  dann  wieder  gesperrt,  so  blockiert  man  zunachst  durch  ent- 
sprechende  Maskierung  (Interrupt-Priority-Level  auf  6)  in  der  CPU  alle  weiteren  Interrupts. 
Dann  wird  die  Interrupt-Routine  fiir  den  Systemtimer  so  oft  aufgerufen,  wie  dieser  Interrupt 
wahrend  der  “kritischen”  Zeit  aufgetreten  ist  (die  Anzahl  der  Aufrufe  wurde  ja  in  der  kleinen 
Systemtimer-Interrupt-”Hilfsroutine”  mitgezahlt). 

Die  Interrupt-Ebene  4  ist  fiir  den  Vertical-Blank-Interrupt  (VBLANK-Interrupt)  reserviert. 
Dieser  Interrupt  tritt  in  der  Monochrom-Betriebsart  alle  14  mSek.  und  in  der  Color-Betriebsart 
alle  20  mSek.  auf.  Zu  weiteren  Einzelheiten  beziiglich  dessen  Aufgabe  siehe  Teil  I,  Kapitel 
1,  “Der  Vertical  Blank  Handler”. 


Selbstgemachte  Interrupt-Vektornummern 

Sowohl  bei  dem  HBLANK-  als  auch  dem  VBLANK-Interrupt  handelt  es  sich  um  einen 
sogenannten  Autovektor-Interrupt.  Bei  so  einem  Interrupt  erzeugt  die  CPU  intern,  sozusagen 
“automatisch”,  eine  Interrupt-Vektomummer.  Diese  Autovektor-Nummer  ergibt  sich  dabei 
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aus  der  Prioritat  des  Interrupts.  DaB  ein  Autovektor-Interrupt  aufgetreten  1st,  erfahrt  die  CPU 
durch  ein  Low  liber  den  VPA-AnschluB  (Valid-Peripheral-Address)  wahrend  der  Phase  der 
Unterbrechungsanerkennung.  Aus  dieser  Autovektor-Nummer  wird  dann  die  Interrupt- 
Vektor-Adresse  berechnet  (Autovektor-Adresse=Autovektomummer  *  4).  Unter  derlnterrupt- 
Vektor-Adresse  findet  die  CPU  dann  einen  Zeiger  auf  die  abzuarbeitende  Interruptroutine,  die 
dann  aufgerufen  wird. 

Fur  Interrupts  der  Prioritat  2  (HBLANK-Interrupt)  wird  eine  Vektomummer  von  26  erzeugt. 
Der  Zeiger  auf  die  HBLANK-Interrupt-Routine  befindet  sich  also  an  Adresse  $68.  Der 
VBLANK-Interrupt  (Prioritat  4)  erzeugt  die  Vektomummer  28.  Die  Interrupt- Vektor- Adres¬ 
se  lautet  somit  auf  $70. 


Interrupts  durch  den  MFP-Baustein 

Ein  Interrupt,  der  durch  den  MFP  ausgelost  werden  kann,  liegt  auf  Level  6,  hat  also  int  ST 
nahezu  hochste  Prioritat.  Im  MFP-Baustein  selbst  werden  nochmals  1 6  Interruptkanale  unter- 
schieden,  denen  MFP-intem  16  verschiedene  Priori taten  zugeordnet  sind.  Wie  die  folgende 
T abelle  zeigt,  hat  z.  B .  der  Interrupt  des  I/O-Port  7  (17 ,  Monochrom-Monitor-Detect)  im  MFP 
hochste  Prioritat,  Das  BUSY -Signal  (10)  der  parallelen  Schnittstelle  wurde.ware  der  Interrupt 
im  ST  aktiviert,  dagegen  einen  Interrupt  niedrigster  Prioritat  bei  der  MFP-Logik  auslosen. 


Kanal 
Hr.  : 

Interrupt  durch 

Bedeutung  im  "ST" 

i  IS 

I/O— Port  7  £I?1 

Monochron  Monitor  Detect 

]  « 

I/O— Port  6  £161 

RI  von  ser.  Schnittstelle 

e  13 

T  iner  A 

nicht  benutzt 

r  12 

RCU  Buffer  full 

ser.  Schnittstelle  Empf angerpuf f er  voll 

11 

RCU  Error 

ser.  Schnittstelle  Empf angsf ehler 

**  10 

XMIT  Buff,  empty 

ser.  Schnittstelle  Sendepuffer  leer 

¥  9 

XMIT  Error 

ser.  Schnittstelle  Sendefehler 

e  8 

Timer  B 

Display  Enable-Signal  Zahler 

7 

I /O-Port  5  £151 

FDC-Readg/ACSI-Bus  Steuerung 

t  6 

I/O— Port  4  £141 

IRQ  von  Tastatur/MIDI-ACI A  * s 

5 

T iner  C 

208  Hz  Systentakt 

.2  4 

Timer  D 

ser.  Schnittstelle  Baudraten-Generator 

£  3 

I/O-Port  3  £131 

£BPU-Pone  Signal  von  Blitter-Chi pi 

.2  2 

I/O— Port  2  £121 

CTS  von  ser.  Schnittstelle 

?  1 

I/O-Port  1  £111 

DCD  von  ser.  Schnittstelle 

1  a 

I/O-Port  6  £101 

BUSY  von  par.  Schnittstelle 

Abb.  4.4:  So  sind  die  Interrupt-Kanale  des  MFP  intern  gewichtet 
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Non-Autovektor-Interrupts 

Der  MFP  erzeugt  bei  der  CPU  im  ST  einen  “Non-Autovektor-Interrupt”,  d.  h.,  nicht  die  CPU 
bildet  eine  Vektomummer,  aus  der  dann  die  Lage  des  Interruptvektors  im  Speicher  bestimmt 
wird,  sondem  der  MFP-Baustein  sendet,  nachdem  seine  Unterbrechungsanforderung  von  der 
CPU  bestatigt  wurde,  eine  “eigene”  Vektomummer  zur  CPU.  Die  CPU  “erfahrt”  von  einem 
Non-Autovektor-InterruptdurcheinLowamDTACK-AnschluG(Data-Transfer-Acknowledge) 
wahrend  der  Intermpt-Anerkennungsphase. 


Abb.  4.5:  Das  Prinzip  der  Interrupt-Bearbeitung  CPU<->MFP 
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Aus  dieser  vom  MFP  gelieferten  Vektomummer  berechnet  die  CPU  dann  die  Speicheradresse, 
in  der  ein  Zeiger  auf  den  Anfang  der  Interrupt-Routine  steht.  Beim  ST  liegen  diese  16  Zeiger 
(Unterbrechungsvektoren)  fur  MFP-Interrupts  ab  Adresse  $  100  im  Supervisorspeicherbereich. 
Es  sind  jedoch  vom  Betriebssystem  nicht  alle  16  Interruptkanale  des  MFP  aktiviert. 

Beispielweise  sind  alle  I/O-Port  0..3  (I0..I3)-Interrupts  des  MET  gesperrt,  weil  diese  I/O- 
Anschliisse  nicht  per  Interrupt  bedient  werden,  sondem  evtl.  durch  einfaches  “Polling”.  Das 
bedeutet  nichts  anderes,  als  dab  vom  Betriebssystem  in  einer  Schleife  oder  nach  Ablauf  einer 
bestimmten  Verzogerung  der  Zustand  dieser  als  Eingang  eingestellten  Ports  abgefragt  wird. 

So  erfolgt  z.  B.  die  Zeichenausgabe  an  den  Dmcker  fiber  die  parallele  Schnittstelle  nicht 
interruptgesteuert,  sondem  per  Polling.  Jedesmal  wenn  ein  Zeichen  an  den  Drucker  gesendet 
werden  soli,  wird  “nachgeschaut”,  ob  BUS  Y  (I/O-Port  0)  noch  auf  High  liegt.  1st  der  Drucker 
noch  BUSY  (BUSY  auf  High),  so  wird  eine  Schleife  durchlaufen,  in  der  fortlaufend  der  Zu¬ 
stand  der  BUSY-Leitung  abgefragt  wird  (Polling).  Erst  wenn  BUSY  auf  Low  geht,  gelangt 
das  auszugebende  Zeichen  an  die  parallele  Schnittstelle. 

Es  wird  jedoch  vom  Betriebssystem  eine  “Time  out”-Uberwachung  mittels  Systemtimer 
(Timer  C  des  MFP)  durchgeffihrt,  damit  spatestens  nach  ca.  30  Sek.  erfolglosen  “Wartens  auf 
BUSY”  mit  einer  Fehlermeldung  ins  aufrufende  Programm  zuriickgekehrt  werden  kann. 

Bei  einem  nicht  angeschlossenen  Dmcker  oder  wenn  dieser  “Offline”  geschaltet  ist,  wfirde 
man  sonst  ewig  (na  ja,  bis  zum  RESET)  warten  miissen. 


Adresse 

MFP“  I  n't . 
Hunner t 

Status 

zeigt  auf  Interrupt-Routine  fur* 

Interrupt  durch 

5100 

0 

gesperrt 

BUSV-Anschlufl  der  par.  Schnittst. 

1/O-Port  B  (IB) 

5104 

1 

gesperrt 

PCD— Signal  serielle  Schnittstelle 

I/O-Port  1  (ID 

5108 

2 

gesperrt 

CTS-Signal  serielle  Schnittstelle 

I /0-Port  2  (12) 

S10C 

3 

gesperrt 

CGPU-Done  Signal  pom  Blitter  Chip) 

I/O-Port  3  (13) 

SUB 

4 

gesperrt 

Baudraten-Gen .  ser .  Schnittstelle 

Tiner  D 

5114 

5 

aktiv. 

200  Hz  Systen  Tiner 

Tiner  C 

5118 

6 

aktiv . 

Tastatur/MIDI  (AC1A)  Bedienung 

I/O-Port  4  (14) 

sue 

7 

gesperrt 

FDC-Ready/ACSI-Bus  Steuerung 

X/O-Port  5  (15) 

5120 

8 

gesperrt 

Display  Enable  Signal  CHor.Sync .J 

Tiner  B 

5124 

9 

aktiu . 

Sendef ehler  ser.  Schnittstelle 

XMIT-Error 

5128 

IB 

aktiv . 

Sendepuffer  leer  tser.  Interface) 

XMIT-Buf,  enpty 

512C 

11 

aktiu , 

Enpfangsf ehler  (ser.  Interface) 

RCU-Err or 

5130 

12 

akt i v  » 

Enpf angspuff er  voll  Cser.  Interf) 

RCU-Buffer  full 

5134 

13 

gesperrt 

nicht  benutzt 

T iner  A 

5138 

14 

gesperrt 

Rl-Signal  serielle  Schnittstelle 

I/O-Port  6  ( I G) 

S13C 

15 

gesperrt 

Monochroh  Monitor  Detect 

I/O-Port  7  (17) 

Abb.  4.6:  Die  Lage  der  MFP-Interrupt-Vektoren  im  ATARI  ST-RAM 


886 


ATARI  Profibuch 


Einer  der  aktivierten  Interrupts  ist  jener  fiir  den  schon  mehrfach  erwahnten  200  Hz- 
Systemtimer,  dereine  Art  “innere  Uhr”  im  ST  darstellt  und  unter  anderem  fiirTastenwiederholung 
und  als  Takt  fiir  den  “Pseudo-Soundprozessor”  benutzt  wird. 

Aktiviert  ist  auch  der  Interrupt  fiir  die  beiden  ACIAs,  welche  zur  Kommunikation  mit  der 
Tastatur  und  der  MIDI-Schnittstelle  dienen.  Es  muB  ja  gewahrleistet  sein,  daB  Informationen 
von  der  “Intelligenten  Tastatur”,  wie  Tasten-  Oder  Mausbetatigungen,  laufend  ans  Betriebs- 
system  weitergegeben  werden.  Die  Interrupts  zur  Bedienung  des  Sende-  und  Empfangsteils 
der  seriellen  Schnittstelle  des  MFP  sind  ebenfalls  aktiviert. 


Mit  drei  Steuerregistern  die  MFP-Interrupts  im  Griff 

Zur  Interrupt-Bearbeitung  besitzt  der  MFP  drei  Steuerregister,  die  jeweils  2  *  8  Bit  breit  sind. 


ftdressa. 


SFF  FA07 
* IERA ' 

Port 

*17 

Port 

*16 

Tifter 

ft 

RCU 

Buffer 

full 

RCU 

Error 

XMIT 

Buffer 

ertpty 

XMIT 

Error 

Titter 

B 

-It 

Bit 

7 

8 

5 

4 

3 

2 

l 

0 

SFF  FA09 

Port 

Port 

Timer 

Titter 

Port 

Port 

Port 

Port 

1 IERB1 

15 

£ _ 

14 

c 

D 

13 

* 

13 

■it 

I  1 

10 

Interrupt 
Enable 
Register  ft 


Interrupt 
Enable 
Register  B 


*  =  Diese  Interrupts  sind  in  ST  gesperrt! 


Alle  16  moglichen  Interruptkanale  des  MFP  konnen  einzeln  ein-  bzw.  ausgeschaltet  werden. 
Die  MFP-Logik  registriert  nur  Interrupts  von  Kanalen,  die  auch  eingeschaltet  sind,  und  gibt 
diese  dann  in  Form  von  Unterbrechungsanforderungen  an  die  CPU  weiter.  Ausgeschaltete 
Interruptkanale  werden  nicht  beachtet.  Durch  Setzen  des  entsprechenden  Bits  im  IERA  (Inter¬ 
rupt-Enable-Register  A)  oder  IERB  wird  der  zugehorige  Inteiruptkanal  eingeschaltet. 


ftdresse 
SFF  FA0B 
■  I PRfl ' 

Bit 
SFF  FA0D 
' IPRB" 


Port 

17 

Port 

16 

Titter 

ft 

RC'J 

Buffer 

full 

RCU 

Error 

XMIT 

Buffer 

empty 

XMIT 

Error 

Timer 

B 

7 

6 

5 

4 

3 

2 

i 

0 

Port 

Port 

Titter 

T  itter 

Port 

Port 

Port 

Port 

15 

14 

c 

D 

13 

13 

I  1 

TO 

Interrupt 

Pending 

Register 


ft 


Interrupt 
Pending 
Register  B 


Jedem  Interruptkanal  des  MFP  ist  ein  Bit  im  Interrupt-Pending-Register  A  oder  B  (IPRA  oder 
IPRB)  zugeordnet.  Empfangt  die  MFP-Logik  einen  Interrupt  von  einem  aktivierten  Interrupt- 
Kanal,  so  wird  das  zugehorige  Bit  gesetzt.  Dieser  Interrupt  wird  so  lange  als  noch  nicht  aner- 
kannt = “schwebend”  (pending)  gefuhrt,  bis  die  Unterbrechungsanforderung  von  der  CPU  be- 
statigt  wird. 
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Im  “Non-Autovektor-Interrupt”-Betrieb  des  MFP,  wie  es  im  ATARI  ST  der  Fall  1st,  wird  ein 
gesetztes  Bit  im  IPRA  oder  IPRB  erst  dann  geloscht,  wenn  die  CPU  den  Interrupt  fur  den 
entsprechenden  Kanal  bestatigt  hat  und  der  MFP  die  zugehorige  Vektomummer  an  die  CPU 
sendet. 

Die  IPRA  und  IPRB  konnen  von  der  CPU  jederzeit  gelesen  und  beschrieben  werden,  Es  ist 
auch  moglich,  Bits  des  IPRA  oder  IPRB  per  Software  (durch  Programmbefehl)  zu  loschen. 
Dazu  mul)  fiir  alle  jene  Bits,  welche  nicht  geloscht  werden  sollen,  eine  “  1”  in  das  Register  ge- 
schrieben  werden. 


Die  zu  loschenden  Bits  werden  als  “0”  geschrieben.  Geloschte  Bits  konnen  jedoch  nicht  wieder 
durch  Beschreiben  mit  einer  “  1  ”  gesetzt  werden !  Das  ist  nur  durch  Auslosung  eines  Interrupts 
moglich.  Der  Wert  im  Interrupt-Pending-Register  wird  also  mit  dem  einzuschreibenden  Wert 
UNDiert  und  das  Resultat  im  Register  abgelegt. 

Einzelne  Bits  im  IPRA  bzw.  IPRB  werden  auch  dann  geloscht,  wenn  die  zugehorigen  Inter- 
rupt-Kanale  im  Interrupt-Enable-Register  A  bzw.  B  gesperrt  werden. 


ftdres&e 


$FF  FA13 
■IMRA" 

Port 

17 

Port 

16 

Timer 

rcu 

Buffer 

full 

RCV 

Error 

XMIT 

Buffer 

empty 

XMIT 

Error 

T  imer 

B 

Bit 

:  1 

8 

5 

4 

3 

2 

1 

0 

SFF  FA15 

Port 

Port 

Timer 

Timer 

Port 

Port 

Port 

Port 

1 IMRB1 

IS 

14 

C 

D 

13 

12 

1 1 

ie 

Interrupt 

Mask 

Register  A 


Interrupt 

Mask 

Register  B 


Mit  Hilfe  der  Interrupt-Mask-Register  A  bzw.  B  (IMRA  bzw.  IMRB)  ist  es  moglich,  bestimm- 
te  Interruptkanale  des  MFP  zu  maskieren  (auszublenden). 

Ist  ein  Interrupt-Kanal  zwar  aktiviert,  aber  maskiert,  so  wird  eine  evtl.  Interruptsignalisierung 
zwar  von  der  MFP-Logik  registriert  und  das  zugehorige  “Pending”-Bit  im  IPRA  bzw.  IPRB 
gesetzt.  Es  wird  jedoch  keine  Interrupt- Anforderung  fiir  diesen  Kanal  an  die  CPU  gesendet. 

Die  Maskierung  eines  Interrupt-Kanals  erfolgt  durch  Loschung  des  zugehorigen  Bits.  Durch 
Setzen  eines  Bits  wird  die  Maskierung  fiir  den  zugehbrigen  Kanal  aufgehoben. 

Signalisiert  ein  maskierter  Kanal  einen  Interrupt  zur  MFP-Logik,  so  wird  das  entsprechende 
Bit  des  IPRA  bzw.  IPRB  gesetzt  (pending  Interrupt).  Nach  Beendigung  der  Maskierung  wird 
durch  das  gesetzte  IPRA-  bzw.  IPRB-Bit  die  MFP-Logik  nun  bei  der  CPU  einen  Interrupt  fiir 
diesen,  nun  nicht  mehr  maskierten,  Kanal  anfordem.  Die  Interrupt-Mask-Register  konnen 
jederzeit  beschrieben  und  ausgelesen  werden. 
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Die  im  folgenden  beschriebenen  Register  dienen  weniger  der  Steuerung  als  der  Sigaalisierung 
von  MFP-Interrupts. 


fldresse 


SFF  FA17|V7|U6 

U5  U4|  S  IXlX^fXI 

‘MB’  1 - - 

End-of-Interrupt  Modus  Bit 
High-Nibble  der  Vektornunner 


Wie  bereits  erlautert,  sendet  der  MFP  im  “Non-Autovektor-Interrupt” -Modus  nach  Bestati- 
gung  der  Interrupt- Anforderung  durch  die  CPU  eine  dem  MPP-Interrupt-Kanal  entsprechende 
8-Bit-  Vektomummer  an  die  CPU,  damit  diese  daraus  die  Adresse  des  zugehorigen  Interrupt- 
Vektors  berechnen  kann.  Und  so  ist  diese  Vektomummer  aufgebaut: 

-  Die  unteren  vier  Bits  (Low-Nibble)  der  8-Bit-Vektomummer  stellen  die  Nummer  des 
InteiTupt-Kanals  (0...15)  im  MFP  dar,  der  den  Interrupt  ausgelost  hat. 

-  Die  oberen  vier  Bits  (High-Nibble)  der  Vektomummer  werden  von  der  MFP-  Logik  aus 
dem  Interrupt-Vektor-Register  entnommen.  Es  handelt  sich  dabei  urn  eine  Kopie  der 
oberen  vier  Bits  dieses  Registers.  Im  ST  ist  hierbei  ein  Wert  von  “0100”  fur  die  Bits  7..4 
initialisiert. 

Der  MFP  im  ST  kann  somit  mit  seinen  1 6  Interrupt-Kanalen  die  Vektomummem  “0100  0000” 
(dez.  64)  bis  “0100  1111”  (dez.  79)  erzeugen. 

Das  S-Bit  stellt  denEnd-of-Interrupt-Modus  (EOI-Modus)  ein.  Bei  geloschtem  Bit  arbeitet  der 
MFP  im  Automatic-EOI-Modus.  Der  Software-EOI-Modus  ist  bei  gesetztem  S-Bit  aktiviert. 
Naheres  zum  EOI-Modus  folgt  nun  bei  der  Beschreibung  des  Interrupt-in-Service-Registers. 

Adresse 
SFF  FA8F 
' ISRA 1 

Bit 
$FF  FA11 
' ISRB  * 


Port 

17 

Port 

16 

Titter 

fl 

RCU 

Buffer 

full 

RCM 

Error 

XMIT 

Buffer 

empty 

XMIT 

Error 

Titter 

B 

:  7 

s 

5 

4 

3 

2 

1 

0 

Port 

Port 

T  irter 

Timer 

Port 

Port 

Port 

Port 

IS 

14 

C 

D 

13 

13 

1 1 

10 

Interrupt 
in-Service 
Register  A 


InterruDt 
in-Service 
Register  B 


Dieses  Register  ist  nur  von  Bedeutung,  wenn  das  S-Bit  im  Interrupt-Vektor-Register  geloscht 
ist.  Der  MFP  arbeitet  dann  im  Software-EOI-Modus.  Im  Software-EOI-Modus  muB  die  CPU 
der  MFP-Logik  durch  einen  Befehl  das  Ende  der  Interrupt-Bearbeitung  fur  den  zur  Zeit 
bearbeiteten  Interrupt  mitteilen.  Dieser  Modus  wird  im  ST  benutzt. 
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Die  Interrupt-Bearbeitung  lauft  folgendermaften  ab  (es  soil  noch  keine  Interrupt-  Anforderung 
vorliegen): 

-  Ein  aktivierter  Kanal  meldet  der  MFP-Logik  einen  Interrupt. 

-  Das  zugehorige  Bit  im  Interrupt-Pending-Register  wird  gesetzt.  Der  MFP  sendet  eine 
Interrupt- Anforderung  an  die  CPU. 

-  Die  CPU  bestatigt  die  Anforderung,  und  der  MFP  sendet  der  CPU  die  entsprechende  Vek- 
tomummer.  Gleichzeitig  wird  das  zugehorige  Interrupt-Pending-Bit  geloscht, 

Dafiir  wird  im  Interrupt-in-Service-Register  A  bzw.  B  das  zugehorige  Bit  gesetzt.  Der 
Interrupt  wird  bearbeitet  (der  Interrupt  ist  “in-Service”). 

-  Die  laufende  Interrupt-Bearbeitung  ftir  diesen  Kanal  kann  nur  durch  einen  Interrupt  eines 
hoherwertigen  Kanals  unterbrochen  werden. 

-  Interruptsignalisierungen  von  niedriger  priorisierten  Kanalen  werden  zwar  von  der 
MFP-Logik  registriert  (Setzen  des  entspr.  Bits  in  IPRA  bzw.  IPRB),  fiihren  aber  nicht 
zu  einer  Unterbrechungsanforderung  an  die  CPU. 

Weil  das  Interrupt-Pending-Bit  fur  den  gerade  in  Bearbeitung  befindlichen  Interrupt  ja 
wieder  geloscht  wurde  (aufgrund  der  Interrupt-Bestatigung  durch  die  CPU),  kann  schon 
wieder  eine  neue  Interruptsignalisierung  ftir  diesen  Kanal  von  der  MFP-Logik  registriert 
werden  (Setzen  des  Interrupt-Pending-Bits).  Aber  auch  hier  wird  der  laufende  Interrupt 
nicht  unterbrochen. 

-  Nach  Beendigung  des  laufenden  Interrupts  mu  ft  durch  die  CPU  das  zugehorige  Bit  im 
Interrupt-in-Service  Register  A  bzw.  B  geloscht  werden.  Ein  Bit  wird  geloscht,  indem 
alle  Bits  des  Registers,  bis  auf  das  zu  loschende  Bit,  mit  “1  ”  beschrieben  werden.  Da  Bits 
im  Interrupt-Pending-Register  per  Software  nur  geloscht  und  nicht  gesetzt  werden  kon- 
nen,  werden  Registerinhalte  durch  das  Beschreiben  mit  “1”  nicht  geandert. 

-  Erst  nach  Loschung  des  Interrupt-in-Service-Bits  fur  den  gerade  beendeten  Interrupt 
kann  die  MFP-Logik  wieder  Interrupt- Anforderungen  fur  bereits  signalisierte  (Bits  im 
IPRA  od.  IPRB  gesetzt)  Interrupts  an  die  CPU  stellen. 

Im  Automatic-EOI-Modus  bleibt  das  Interrupt-in-Service-Register  ohne  Funktion.  Auch  hier 
wird  nach  Bestatigung  der  Interrupt- Anforderung  durch  die  CPU  das  entsprechende  Interrupt- 
Pending-Bit  geloscht.  Nachfolgend  auftretende  Interrupts  irgendeines  Kanals  des  MFP  (und 
damit  jeglicher  Prioritat)  fiihren  zu  einer  Interrupt- Anforderung  an  die  CPU,  egal  ob  die 
laufende  Interrupt-Bearbeitung  beendet  ist  Oder  nicht. 
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Wie  schon  fiir  die  Timer  des  MFP  sind  im  Betriebssystem  des  ST  Funktionen  fiir  die  Be- 
handlung  der  MFP-Interrupts  vorgesehen.  Siehe  hierzu  im  Teil  I,  Kapitel  1,  “XBIOS-Refe- 
renz”,  die  XBIOS-Funktionen  #13  (“Mfpint”),  #26  (“Jdisint”)  und  #27  (“Jenabint”). 


So  ein  kleiner  Chip  -  und  doch  so  viele  Moglichkeiten 

Wie  man  sieht,  ist  der  MFP-Chip  im  ST  mit  einer  ganzen  Reihe  von  Aufgaben  betraut. 

Einige  wenige  Anschliisse  und  Funktionen  sind,  wie  bereits  vorher  erwahnt,  noch  nicht 
benutzt.  Hier  bieten  sich  dem  hardwarenahen  Programmierer  und  dem  engagierten  Hobby- 
Elektroniker  noch  einige  Moglichkeiten,  eigene  Vorstellungen  zu  verwirklichen. 
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Kapitel  5:  Die  serielle  Schnittstelle 


Wie  der  Name  schon  sagt,  werden  mit  Hilfe  der  seriellen  Schnittstelle  Daten  Bit  fur  Bit 
nacheinander  (seriell)  iiber  einen  Ubertragungs  weg  ausgetauscht,  Ein  gesetztes  Bit  wird  dabei 
durch  einen  log.  H-Pegel  und  ein  geloschtes  Bit  somit  durch  einen  log.  L-Pegel  dargestellt. 
Filr  jedes  Bit  wird  also  auf  die  Ubertragungsleitung  fur  eine  bestimmte  Zeiteinheit  ein  dem 
Zustand  des  Bits  entsprechender  log.  Pegel  angelegt. 

Die  serielle  Schnittstelle  des  ST  lehnt  sich  dabei  an  den  RS-232C-Standard  an.  Die  Spannungs- 
pegel  entsprechen  den  Vereinbarungen: 

Log.  L=  “Ein”-Zustand  =  +3V..+15V 

Log.  H  =  “Aus”-Zustand  =  -3V..-15V 

Mit  dem  im  ST  fiir  die  Steuerung  der  seriellen  Schnittstelle  zustandigen  Chip  ist  sowohl 
synchrone  als  auch  asynchrone  Dateniibertragung  moglich.  Leider  kann  aber  das  synchrone 
Gleichlaufverfaliren  nicht  benutzt  werden,  da  die  dazu  erforderlichen  Taktleitungen  nicht  am 
Schn ittstel lenanschlufi  zur  Veifiigung  stehen! 

Nachfolgend  eine  kurze  Erlauterung  zu  diesen  beiden  Gleichlaufverfaliren. 


Synchrone  Betriebsart 

Bei  synchroner,  serieller  Ubertragung  arbeiten  die  beteiligten  Dateniibertragungseinheiten 
(Sende-  und  Empfangseinheit)  standig  exakt  im  gleichen  Takt  (synchron).  Dazu  ist  eine 
genaue  Ubereinstimmung  zwischen  Sender-  und  Empfangertakt  erforderlich.  An  der  Schnitt¬ 
stelle  zum  Dateniibertragungsgerat  sind  deshalb  Leitungenfiir  den  Sende-  undEmpfangstakt 
erforderlich. 

Durch  die  zusatzlich  vorhandenen  Taktleitungen  ist  gewShrleistet,  daft  bei  einer  Dateniibertra- 
gungsverbindung  beide  Seiten  bitsynchron  arbeiten!  Also  sind  beide  Seiten  auch  synchron, 
wenn  gar  keine  Nutzdaten  iibertragen  werden.  Damit  die  Gegenstelle  “merkt”,  da8  nun  Nutz- 
daten  iibertragen  werden  und  wo  diese  Zeichen  beginnen,  mufi  sie  das  an  bestimmten  Marken 
im  Bitstrom  erkennen  konnen. 

Dazu  wird  das  sogenannte  Synchronzeichen  verwendet.  Es  dient  dazu,  die  Empfangsstelle  in 
die  Zeichensynchronisation  zu  bringen.  Sende-  und  Empfangseinheit  miissen  natiirlich  die 
“gleiche  Sprache  sprechen”  (das  gleiche  Synchronzeichen  benutzen). 
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Einesynchrone  Dateniibertragung  beginntimmermitderAussendungeinesSynchronzeichens. 
Die  Empfangseinheit  “sucht”  zunachst  im  empfangenen  seriellen  Bitstrom  nach  dem  typi- 
schen  Bitmuster  des  vereinbarten  Synchronzeichens.  Dabei  werden,  je  nach  Vereinbarung, 
zum  Start  der  EFbertragung  ein  Oder  zwei  Synchronzeichen  gesendet.  Erst  wenn  von  der  Emp¬ 
fangseinheit  ein  (oder  zwei)  Synchronzeichen  erkannt  wurde(n),  “rastef '  diese  ein  und  beginnt 
die  nachfolgenden  seriellen  Daten  im  so  gefundenen  Rhythmus  zu  decodieren. 


Asynchrone  Betriebsart 

Die  (in  der  ST/PC-Welt)  gelaufigere  Art  der  seriellen  Dateniibertragung  und  deshalb  vom  TOS 
standardmaBig  unterstiitzt,  ist  die  asynchrone  Betriebsart.  Asynchron  deshalb,  weil  nur  fiir  die 
Dauer  eines  Zeichens  Gleichlauf  zwischen  Sender  und  Empfanger  herrschen  muB!  Die  sen- 
dende  Einheit  gibt  nur  Datenbits  aus,  wenn  auch  ein  (Nutz-)  Zeichen  zur  Ubertragung  vorliegt. 

Da  in  diesem  Fall  Pausen  auftreten  konnen,  wdhrend  der  Sender  und  Empfanger  aus  der  Syn¬ 
chronisation  laufen  konnten  (und  das  auch  tun),  muB  eine  Synchronisationsinformation  mit 
jedem  iibertragenen  Zeichen  mitgefiihrt  werden.  Deshalb  wird  jedem  Zeichen  ein  Startbit 
(log.  L)  vorangestellt,  damit  der  Empfanger  informiert  wird,  daB  nun  wieder  ein  Zeichen  iiber- 
tragen  werden  soil.  Die  Empfangseinheit  beginnt  mit  dem  Empfang  des  Startbits,  den  seriellen 
Bitstrom  im  Takt  der  eingestellten  Ubertragungsrate  abzutasten. 

Am  Ende  eines  Zeichens  werden  dann  noch  ein  Oder  zwei  Stopbits  (log.  H)  angehangt,  um  den 
Empfanger  iiber  das  Ende  der  Zeicheniibertragung  zu  informieren.  Wenn  der  Empfanger  also 
dasStartbitunddievereinbarteZahlvonStopbitskorrekterkannthat.kann  die  Empfangseinheit 
davon  ausgehen,  daB  auch  das  eigentliche  Zeichen  korrekt  empfangen  wurde. 

Der  Taktgleichlauf  zwischen  Sender  und  Empfanger  ist  also  nur  fiir  einen  relativ  kurzen  Zeit- 
raum  (namlich  fiir  die  IJbertragungsdauer  eines  Zeichens  +  Start-  und  Stopbits)  erforderlich 
und  deshalb  einigermafien  genau  zu  realisieren.  Bei  jedem  neuen  Zeichen  hat  der  Empfanger 
mit  dem  Empfang  des  Startbits  die  Gelegenheit,  sich  neu  zu  synchronisieren. 


Serielle  Dateniibertragung  mit  dem  ST 

Wie  ja  bereits  zu  Eingang  des  Kapitels  erwahnt,  besitzt  der  ST  eine  serielle  Schnittstelle  in 
Anlehnung  an  den  RS-232C-Standard.  Der  ST  ist  dabei  als  Datenendeinrichtung  (DEE)  zu 
betrachten.  fiber  eine  TXD-Leitung  (Transmitted  Data)  werden  die  Daten  seriell  ausgegeben; 
am  RXD-AnschluB  (Received  Data)  erwartet  der  ST  die  Empfangsdaten,  Fiir  den  reibungs- 
losen  Ablauf  der  Dateniibertragung  stellt  die  serielle  Schnittstelle  des  ST  fiinf  Handshake- 
Signale  zur  Verfiigung. 


Die  serielle  Schnittstelle 
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Anschlufi 

Bezeichnung 

ser.  Port 

Bedeutung 

RTS 

Pin  4 

Request  to  send  (Sendeteil  einschalten) 

Der  AnschluB  geht  auf  “Ein”,  wenn  das  Datenendgerat  (der  ST) 
etwas  senden  will.  Mit  “Aus”-Pegel  wird  signalisiert,  wenn 
nicht  gesendet  werden  soli. 

CTS 

Pin  5 

Clear  to  send  (Sendebereitschaft) 

Riickmeldung  der  DUE  (Daten-Ubertragungs-Einheit  =  Mo¬ 
dem),  daB  deren  Sendeteil  eingeschaltet  ist  und  die  zu  senden- 
den  Daten  iiber  die  TXD-Leitung  vom  ST  ausgegeben  werden 
konnen  (bei  “Ein”-Signal  dilrfen  Daten  vom  ST  gesendet  wer¬ 
den,  sonst  nicht!) 

DCD 

Pin  8 

Data  carrier  detect  (Empfangssignalpegel  liegt  vor) 

Die  DUE  meldet  mit  “Ein”  an  den  ST,  daB  sie  Signale  mit  aus- 
reichendem  Pegel  von  der  Gegenstation  empfangt. 

DTR 

Pin  20 

Data  terminal  ready  (DEE  betriebsbereit) 

Der  ST  signalisiert  der  DUE  mit  “Ein”-Pegel  an  diesem  An¬ 
schluB  Betriebsbereitschaft. 

RI 

Pin  22 

Ring  indicator  (Ankommender  Ruf) 

Die  DUE  meldet  dem  ST  einen  “  Anruf  ’  von  der  Gegenstation. 
Das  ist  die  “Telefohklingel”,  mit  der  dem  ST  mitgeteilt  wird, 
daB  die  Gegenseite  einen  Datenaustausch  durchfiihren  will. 
Das  Signal  wird  eigentlich  nur  bei  Modems  benutzt,  die  in  ei- 
nem  als  Mailbox  arbeitenden  Computer  installiert  sind. 

Der  ST  besitzt  zwar  unter  seinen  Peripheriebausteinen  zwei  sogenannte  ACIAs  ( Asynchronous- 
Communications-Interface-Adaptor  =  Interface  fiir  asynchrone  Dateniibertragung),  jedoch 
werden  diese  nicht  fiir  die  Bedienung  der  herausgeftihrten  seriellen  Schnittstelle  benutzt.  Sie 
versorgen  die  MIDI -Schnittstelle  und  die  “intelligente”  Tastatur, 


Arbeitsteilung  am  RS232-Port 

Wie  auch  bei  der  parallelen  Schnittstelle  teilen  sich  bei  der  “Betreuung”  der  seriellen  Schnitt¬ 
stelle  des  ST  der  PSG-  (Programmable-Sound-Generator)  und  der  MFP-Chip  (Multi-Function- 
Peripheral)  die  Arbeit. 
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Die  Parallel/Seriell-Wandlung  der  zu  sendenden  bzw.  empfangenden  Daten  nimmt  der  MFP 
vor,  weleher  neben  anderen  interessanten  Schnittstelien  und  Funktionseinheiten  (Timer), 
auch  einen  USART  (Universal  Synchronous/  Asynchronous  Receiver/ Transmitter  =  Univer- 
selle  Synchron/Asynchron  Sende-/Empfangseinheit)  besitzt. 

Die  Datenttbertragungsrate  (Zahl  der  ubertragenen  Bits/Sek.)  wird  dabei  durch  die  T  aktfrequenz 
an  den  Anschliissen  TC  (Transmitter  Clock  =  Sendetakt,  Pin  7)  und  RC  (Receiver  Clock  = 
Empfangstakt,  Pin  10)  bestimmt,  welche  beim  ST  direkt  miteinander  verbunden  sind.  Gelie- 
fert  wird  der  T akt  vom  Anschluft  TDO  (Timer-D-Output,  Pin  1 6)  des  MFP.  Sender  und  Emp- 
fangerarbeiten  also  immerauf  der  gleichenTaktfrequenz(gleicheDatenubertragungsgeschwin- 
digkeit)! 


Abb.  5.1:  So  ist  die  serielle  Schnittstelle  des  ST  realisiert 


Die  serielle  Schnittstelle 
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Der  Sender  im  USART  des  MFP  besitzt  ein  Senderegister  (Sendepuffer),  in  den  das  zu 
sendende  Zeichen  (maximal  8  Bitbreit!)  eingeschrieben  wird.  Von  dort  gelangt  das  Zeichen 
in  ein  Sendeschieberegister,  das  die  Daten  Bit  fur  Bit  im  Takt  der  Ubertragungsrate  am  SO- 
Ausgang  des  MFP  (Pin  8)  ausgibt. 

Die  Ubergabe  des  Zeichens  vom  Sendepuffer  ins  Sendeschieberegister  geschieht  automatisch 
dann,  wenn  das  vorherige  Zeichen  aus  dem  Sendeschieberegister  komplett  “hinausgescho- 
ben”  wurde.  Der  Status  der  Senderichtung  kann  aus  dem  Transmitter-Status-Register  ausge- 
lesen  werden. 

Genau  umgekehrt  ist  der  Ablauf  im  Empfangsteil  des  USART.  Die  seriellen  Daten  werden  Bit 
fiir  Bit  iiber  den  SI-AnschluB  des  MFP  (Pin  9)  im  Takt  der  vereinbarten  Ubertragungsrate  in 
das  Empfangsschieberegister  “hineingeschoben”.  Wenn  die  fur  ein  Zeichen  vereinbarte  Zahl 
von  Bits  empfangen  ist,  wird  der  Inhalt  des  Empfangsschieberegisters  in  das  Empfangsregister 
(Empfangspuffer)  iibertragenundkann  von  dort  ausgelesen  werden.  Der  Status  derEmpfangs- 
richtung  wird  iiber  ein  Receiver-Status-Register  signalisiert. 

Damit  die  Dateniibertragung  interruptgesteuert  durchgefiihrt  werden  kann  (die  CPU  greift  nur 
ein,  wenn  ein  Zeichen  komplett  empfangen  wurde  und  ausgelesen  werden  mu 8  oder  wenn  ein 
neues  Zeichen  in  den  Sendepuffer  gebracht  werden  mu8  oder  wenn  ein  Fehler  in  der 
Ubertragung  aufgetreten  ist),  besitzt  der  USART  des  MFP  fiir  jede  Datenrichtung  zwei  Inter- 
rupt-Kanale. 

Ein  RCV-Buffer-full-Interrupt  (Prioritat  12  bei  MFP-Interrupts)  signalisiert  die  Bereitstellung 
eines  Zeichens  im  Empfangspuffer.  Der  Empfangspuffer  sollte  nun  ausgelesen  werden.  Ge¬ 
schieht  das  nicht  rechtzeitig,  und  wurde  ein  weiteres  Zeichen  bereits  empfangen  (steht  im 
Empfangsschieberegister  bereit),  so  wird  ein  RCV-Error-Interrupt  (Prioritat  11  bei  MFP- 
Interrupts)  ausgelost.  Weitere  Bedingungen  fiir  RC V -Error-Interrupts  werden  bei  der  Bespre- 
chung  der  USART-Register  erlautert. 

Ein  XMIT -Buffer-empty -Intermpt  (Prioritat  1 0  bei  MFP-Interrupts)  wird  ausgelost,  wenn  das 
im  Sendepuffer  befmdliche  Zeichen  in  das  Sendeschieberegister  iibertragen  wurde  und  der 
Sendepuffer  wieder  gefiillt  werden  sollte.  Wird  das  Senderegister  nicht  nachgeladen,  bevor 
das  Sendeschieberegister  vollkommen  geleert  ist,  so  tritt  ein  XMIT-Error-Intermpt  (Prioritat 
9  bei  MFP-Interrupts)  auf. 


Die  Register  des  MFP-US  ART 


Fiir  die  Kontrolle  des  Sende-  und  Empfangsteils  des  MFP-US  ART  exis  tieren  fiinf  Register  mit 
jeweils  8  Bit  Breite. 
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Register  Adresse  Zugriff  Bedeutung  Label 

SCR  $FF  FA27  R/W  Synchronous-Character-Register  “SCR” 

Hier  steht  das  Synchronzeichen,  welches  als  Hilfszeichen  fur  die  Dateniibertragung  bei  syn- 
chroner  Betriebsart  verwendet  wird  (zur  Herstellung  der  Zeichensynchronisation  mit  der 
Gegenstelle). 

UCR  $FF  FA29  R/W  USART-Control-Register  “UCR” 

Durch  Setzen  bzw.  Rticksetzen  von  einzelnen  Bits  werden  verschiedene  Betriebsmodi  der 
seriellen  Schnittstelle  eingestellt. 

Even-/Odd-Parity  Bit 


7  _ 6  5  4  3  2  1  Q 


0  tte 

UI.X 

UL  0 

SIX 

sr  0 

PE 

E/Q 

0 

Bei  gesetztem  Bit  arbeitet  der  USART  mit  gerader  Paritat  (Even  Parity  =  Das  zusatzlich  in 
einem  Datenwort  enthaltene  Paritatsbit  wird  so  gesetzt,  daB  sich  eine  gerade  Anzahl  von  Eins- 
Bits  im  Datenwort  ergibt),  sonst  mit  ungerader  Paritat  (Odd  Parity  =  Zahl  der  Eins-Bits  eines 
Datenwortes  wird  durch  das  Paritatsbit  auf  ungerade  erganzt). 

Parity  Enable  Bit 


76543210 


Clk 

UI.X 

m. « 

PE 

E/i\ 

it 

Bei  gesetztem  Bit  findet  die  Dateniibertragung  mit  Paritatsbit  statt.  Es  wird  also  am  Ende  des 
zu  iibertragenden  Zeichens  ein  zusatzliches  Bit  angehangt,  welches  entsprechend  der  gewahl- 
ten  Art  der  Paritat  (Even/Odd)  gesetzt  wird.  Siehe  hierzu  auch  die  Erlauterung  des  E/O-Bits. 

Format  Control 


76543218 


im 

tilAi 

ST1 

STB 

PE 

E/0 

0 

Einstellung  der  Betriebsart  und  bei  asynchroner  Betriebsart  die  Zahl  der  Start-  /Stop-Bits. 


Die  serielle  Schnittstelle 
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Register  Adresse  Zugriff  Bedeutung  Label 

UCR  $FF  FA29  R/W  USART-Control-Register  “UCR” 


ST1 

STO 

Start 

Bits 

Stop 

Bits 

Format 

0 

0 

— 

— 

Synchron 

0 

1 

1 

1 

Asynchron 

1 

0 

1 

1,5 

Asynchron 

1 

1 

1 

2 

Asynchron 

Der  Betrieb  mit  1,5  Stopbits  ist  nur  moglich,  wenn  mit  Vorteiler  (Ubertragungsrate  ist  1/16 
des  Taktes  am  TC/RC-AnschluB)  gearbeitet  wird  (Clk-Bit  gesetzt)! 

Word  Length 


7654321B 


CAk 

HLJ. 

rm 

ST.t 

SX  0 

PE 

e  zo 

it 

Die  Bitkombinadon  legt  fest,  aus  wie  vielen  Bits  ein  zu  iibertragendes  Zeichen  besteht. 


WLl 

WLO 

Wortlange 

0 

0 

8  Bits 

0 

1 

7  Bits 

1 

0 

6  Bits 

1 

1 

5  Bits 

Clock  Mode 

76543210 


Clk 

ui.i 

m. 

six 

PE 

E/il 

Q 

Hiermit  laBt  sich  einstellen,  in  welcher  Beziehung  Dateniibertragungsrate  und  USART-Takt 
stehen.  Bei  gesetztem  Bit  arbeitet  der  US  ART  in  der  sogenannten  “Vorteiler-Betriebsart”.  Die 
an  den  TC/RC-Anschliissen  liegende  Taktfrequenz  wird  in  einem  Vorteiler  des  US  ART  durch 
16  dividiert  und  bildet  erst  dann  die  Taktfrequenz  fur  die  serielle  Dateniibertragung.  Bei 
geloschtem  Bit  stimmen  Taktfrequenz  und  Obertragungsrate  iiberein. 
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Register  Adresse  Zugriff  Bedeutung  Label 

RSR  $FF  FA2B  R/W  Receiver-Status-Register  “RSR” 

DerUSARTmeldetdurchSetzen/Rucksetzeneinzelner  Bits  den  Status  einesZeichenempfangs. 
AuBerdem  lafit  sich  durch  Setzen/Loschen  einigerBits  das  Verhalten  des  Empfangers  steuem. 

Receiver  Enable 


7 

6 

5 

4 

r 

3 

2 

1 

0 

Er 

OE 

PE 

?-  e 

© 

H 

©3© 

m 

EmpfangerEin/Aus.BeiriickgesetztemBitistderEmpfangerimUSARTgesperrt.  AuBerdem 
werden  alle  Flags  im  RSR  geloscht. 

Synchronous  Strip  Enable 


0 


bf 


be 


PE 


F  E 


H 

© 

©3© 

SS 


PE 


Nur  bei  Synchronbetrieb  von  Bedeutung.  Bei  geloschtem  Bit  werden  die  empfangenen  Syn- 
chronzeichen  erst  gar  nicht  in  den  Empfangspuffer  iibertragen. 

Es  gelangen  somit  nur  alle  “Nutz-Zeichen”  in  den  Empfangspuffer! 

Match/Character  in  Progress 


7 

G 

5 

4 

r 

1 

i 

0 

BF 

BE 

PE 

EE 

©V© 

© 

es 

j 

BE 

Synchronbetrieb:  Match 

Ein  gesetztes  Bit  signalisiert  den  Empfang  eines  Synchron-Zeichens. 


Die  serieile  Schnittstelle 
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Register  Adresse  Zugriff  Bedeutung  Label 


RSR  $FFFA2B  R/W  Receiver-Status-Register  “RSR” 

Asynchronbetrieb:  Character  in  Progress 

Es  wird  aus  dem  gerade  empfangenen  Bitstrom  ein  Zeichen  “zusammengebaut”.  Mit  Erken- 
nung  des  Startbits  auf  der  Empfangsleitung  wird  das  Bit  gesetzt  und  mit  Empfang  des  letzten 
Stopbits  eines  Zeichens  wieder  geloscht.  Also  eine  Art  “BUSY”-Fiag. 

Found/Search  bzw.  Break 


76543210 


r 

H 

SF 

os-: 

PP. 

F  E 

L 

PP. 

B 

£3  P 

v>v> 

j 

Synchronbetrieb:  Found/Search 

Durch  Riicksetzen  dieses  Bits  wird  der  Empfanger  auf  “Suchen”  geschaltet.  Der  eintreffende 
Datenstrom  wird  auf  Synchronzeichen  untersucht.  (Der  Wortlangenzahler  ist  dabei  ausge- 
schaltet,  so  daB  die  erste  Bitfolge,  die  mit  dem  Zeichen  im  SCR  (Synchronous-Character- 
Register)  tibereinstimmt,  als  Synchronzeichen  erkannt  wird).  Wurde  ein  Synchronzeichen 
erkannt,  so  wird  das  Bit  gesetzt,  ein  RCV-Error-Interrupt  (siehe  auch  Teil  II,  Kapitel  4, 
“Interrupts  durch  den  MFP-Baustein”)  ausgeldst  und  der  Wortlangenzahler  eingeschaltet. 

Asynchronbetrieb:  Break  Detect 

Eine  Pause  in  der  Dateniibertragung  wird  durch  ein  gesetztes  Bit  signalisiert.  Es  wird  eine 
laufende  Folge  von  “0-Bits”  ohne  Stopbit  empfangen.  Das  Zeichen  im  Empfangspuffer  ist  ein 
“Break”-Zeichen  (alles  Nullen),  Ein  RCV-Error-Interrupt  wird  ausgeldst.  Nach  einem 
“Break”  wird  dieses  Bit  erst  wieder  geloscht,  wenn  mindestens  ein  “1  -Bit”  empfangen  und  das 
RSR  gelesen  wurde  (Quittierung). 

Frame  Error 


76543210 


— r 

f-VS 

FE 

L 

8 

Ein  gesetztes  Bit  signalisiert  einen  “Rahmenfehler”:  dem  im  Asynchron-Betrieb  empfange¬ 
nen  (Nicht  Null!)-Zeichen  folgt  kein  Stop-Bit.  Das  Bit  wird  geloscht,  wenn  ein  korrekt  “um- 
rahmtes”  Zeichen  empfangen  wurde.  (Hierfiir  wird  kein  RCV-Error-Interrupt  ausgeldst!) 
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Register  Adresse  Zugriff  Bedeutung  Label 

RSR  $FFFA2B  R/W  Receiver-Status-Register  “RSR” 


Parity  Error 


7  6  5  4  3  2 

-  T .  i  ~ 


r 

fVS 

H 

8F 

QE 

PE 

Ft: 

- n 

e 

£  2  P 

1  O 


Ein  gesetztes  Bit  zeigt  an,  da 6  ein  im  Empfangspuffer  befindliches  Zeichen  einen  Parity- 
Fehler  aufweist.  Dieser  Fehler  lost  auch  einen  RCV-Error  Interrupt  aus.  Das  Bit  wird  geloscht, 
sobald  ein  neues  Zeichen  ohne  Parity-Fehler  in  den  Empfangspuffer  ubertragen  wird. 


Overrun  Error 


7 

6 

5 

4 

3 

2 

1 

0 

BF 

OE 

PE 

Ft: 

— 

f'/S 

1) 

N 

esp 

OO 

4 

BE 

Das  Bit  wird  gesetzt,  wenn  ein  gerade  eingetroffenes  Zeichen  in  den  Empfangspuffer  gebracht 
werden  soil,  dieser  aber  noch  nicht  ausgelesen  wurde.  Der  Empfangspuffer  wird  jedoch  nicht 
iiberschrieben.  Weitere  eintreffende  Zeichen  werden  nicht  beachtet,  bis  das  Bit  durch  Lesen 
des  RSR  geloscht  wurde  (Quittierung).  Ein  RCV-Error-Interrupt  wird  ausgelost. 

Buffer  Full 


7 

6 

5 

4 

r 

1 

T _ 

0 

□ 

BE 

PE 

Ft: 

l 

8 

Mam 

BE 

Das  Bit  wird  gesetzt,  sobald  ein  empfangenes  Zeichen  in  den  Empfangsbuffer  ubertragen 
wird.  Geloscht  wird  durch  Auslesen  des  Empfangsbuffers  (UDR  =  USART-  Data-Register). 
Ein  RCV-Buffer-Full-Interrupt  wird  ausgelost. 

TSR  $FF  FA2D  R/W  Transmitter-Status-Register  “TSR” 

Die  Bits  des  TSR  steuem  den  Sendeteil  des  USART  und  liefem  Informationen  iiber  den  Status 
des  Sendeteils. 


Die  serielle  Schnittstelle 
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Register  Adresse  Zugriff  Bedeutung  Label 

TSR  $FFFA2D  R/W  Transmitter-Status-Register  “TSR” 
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Bei  gelbschtem  Bit  ist  der  Sender  aufier  Betrieb.  Als  Foige  davon  ware  das  “END-Bit”  gesetzt 
und  das  “UE-Bit”  geloscht.  Ein  Setzen  des  Bits  gibt  den  Sender  frei.  Bis  zur  Aussendung  des 
ersten  Zeichens  ist  der  Ausgang  des  Senders  auf  High-  bzw.  Low-Pegel  Oder  Hochohmig 
(abhangig  von  der  Bitkombination  der  “High  and  Low-Bits”). 

High  and  Low 
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Die  Bitkombination  dieser  beiden  Bits  legt  den  Zustand  des  Senderausgangs  (AnschluB  SO 
des  MFP)  fest,  wenn  der  Sendeteil  gesperrt  ist  oder  gerade  erst  freigegeben  wurde. 
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Schleife 

Bei  “Schleife”  wird  der  Senderausgang  intern  mit  dem  Empfangereingang  verbunden.  Ebenso 
werden  Sende-  und  Empfangstakt  miteinander  gekoppelt.  Die  Anschliisse  RC  (Receiver 
Clock)  und  SI  (Serial  Input)  werden  in  diesem  Fall  nicht  mehr  benutzt. 


Break 
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Im  Asynchron-Betrieb  wird  bei  gesetztem  Bit  ein  “Break”  gesendet,  sobald  das  Senderegister 
leer  ist. 
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Register  Adresse  Zugriff  Bedeutung  Label 


TSR  $FF  FA2D  R/W  Transmitter-Status-Register  “TSR” 

Wahrend  “Break”  gesendet  wird,  erfolgt  an  jeder  Zeiehengrenze  ein  “XMIT -  Error-Interrupt” 
mit  gesetztem  “END-Bit”.  Sobald  das  “Break-Bit”  geloscht  wird,  erfolgt  wieder  normaler 
Sendebetrieb. 

End  of  Transmission 


76543210 


mi 

im 

0 

H 

L 

TE 

Dieses  Bit  wird  gesetzt,  sobald  der  Sender  gesperrt  wird  (TE-Bit).  Ein  XMIT-Error-Interrupt 
wird  ausgelost. 

Befindet  sich  zum  Zeitpunkt  der  Sperre  des  Sendeteils  gerade  noch  ein  Zeichen  im  Sende- 
schieberegister,  so  geht  das  “END-Bit”  erst  auf  “  1  ”,  wenn  das  Zeichen  komplett  ausgesendet 
wurde. 

Auto  Turnaround 
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Bei  gesetztem  Bit  wird  der  Empfanger  automatisch  erst  dann  freigegeben,  wenn  der  Sender 
gesperrt  und  das  letzte  zu  sendende  Zeichen  komplett  ausgesendet  wurde  (bei  Halbduplex- 
Betrieb  ganz  sinnvoll). 


Underrun  Error 
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Bit  gesetzt:  Ein  Zeichen  ist  komplett  gesendet  worden,  bevor  ein  neues  Zeichen  in  den  Sende- 
puffer  eingeschrieben  wurde.  Ein  XMIT-Error-Interrupt  wird  ausgelost.  Dieses  Bit  wird  mit 
dem  Lesen  des  TSR  oder  durch  Sperren  des  USART-Sendeteils  (Loschen  des  TE-Bits)  wieder 
zuriickgesetzt. 


Die  serielle  Schnittstelle 
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Register  Adresse  ZugrifT  Bedeutung  Label 

TSR  $FFFA2D  R/W  Transmitter-Status-Register  “TSR” 

Buffer  Empty 
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Sobald  das  Zeichen  aus  dem  Sendepuffer  ins  Senderegister  gelangt,  wird  das  Bit  gesetzt.  Ein 
XMIT-Buffer-empty -Interrupt  wird  ausgelost.  MitEinschreiben  eines  neuenZeichens  in  den 
Sendepuffer  wird  das  Bit  zuriickgesetzt. 

UDR  SFFFA2F  RAV  USART-Data-Register  “UDR” 

Bei  einem  Schreibzugriffgehngt  das  eingeschriebene  Byte  in  den  Sendepuffer.  EmLesezugriff 
liefert  das  Byte  aus  dem  Empfangspuffer.  Aus  der  Vielzahl  der  Steuermoglichkeiten  und 
Riickmeldungen  des  USART  laBt  sich  ersehen,  wie  flexibel  die  serielle  Schnittstelle  des  ST 
bedient  werden  kann. 

Standardeinstellungen  sind  schon  vorgesehen 

Die  Ubertragungsrate  der  seriellen  Schnittstelle  des  MFP  wird  zwar  durch  Timer  D  bestimmt, 
jedoch  sind  im  Betriebssystem  schon  Voreinstellungenfur  die  gebrauchlichstenDateniibertra- 
gungsraten  vorgesehen.  Diese  lassen  sich,  zusammen  mit  anderen  Einstellungen,  durch  die 
XBIOS-Funktion  #15  (“Rsconf ’)  abrufen. 

Leider  hatdieXBIOS-Funktion  “Rsconf’  zwei  Bugs  (die  von  AT  ARI  aus  “Kompatibilitatsgriin- 
den”  auch  in  neueren  TOS-Versionen  nicht  behoben  wurden): 

-  Die  Ubertragungsgeschwindigkeiten  50  und  75  Bit/s  werden  vom  TOS  falsch  eingestellt 

(falsche  Werte  fur  das  Timer-D-Data-Register)!  Will  man  mit  “Rsconf’  auf  50  Bit/s  ein- 
stellen,  lauft  die  serielle  Schnittstelle  in  Wirklichkeit  mit  80  Bit/s.  Bei  einer  Einstellung 
auf  75  Bit/s  ergibt  sich  in  Wirklichkeit  eine  Geschwindigkeit  von  120  Bit/s. 

Durch  einen  falschen  AdreBdistanzwert  in  der  “Rsconf ’-Routine  werden  nicht  -  wie 
gefordert  -  die  beim  Aufruf  giiltigen  Einstellungen  der  USART-Register  SCR,  UCR, 
RSR,  und  TSR  in  CPU-Register  DO  zuriickgeliefert  (SCR-Wert  im  hochstwertigen  Byte, 
TSR- Wert  im  niedrigstwertigen  B  yte  des  Langworts),  sondem  die  Werte  fur  UCR,  RSR, 
TSR  und  UDR! 
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Mit  “Rsconf  ’  lassen  sich  auGerdem  zwei  verschiedene  Handshaking-Methoden  anwahlen.  Es 
ist  sowohl  Hardware-Handshake  mittels  RTS/CTS-Signalen  mdglich  als  auch  Software- 
Handshake  mit  XON/XOFF-Betrieb. 

Im  Betriebssystem  des  ST  ist  unter  anderem  auch  fur  den  Datenaustausch  iiber  die  serielle 
Schnittstelle  ein  Pufferspeicher  fur  die  zu  ubertragenden  Daten  vorgesehen. 

Zu  sendende  Daten  gelangen  zunachst  in  einen  Puffer  und  werden  dann  (interruptgesteuert) 
zeichenweise  an  die  serielle  Schnittstelle  “weitergereicht”.  Ahnlich  ergeht  es  empfangenen 
Zeichen,  welche  per  Interruptroutine  aus  dem  USART-Data-Register  (UDR)  in  einen  Emp- 
fangspuffer  transferiert  werden. 


Protokolle  sind  manchmal  wichtig 

Wird  mit  Hard-  oder  Software-Handshake  gearbeitet,  so  werden  die  “Fiillstande”  der  Puffer¬ 
speicher  mit  einer  sogenannten  “High-  bzw.  Low-water  mark”  verglichen. 

Werden  die  empfangenen  Zeichen  schneller  in  den  Empfangspufferspeicher  eingeschrieben, 
als  sie  durch  z.  B.  ein  Programm  von  dort  ausgelesen  werden  konnen,  wird  der  “Fullstand” 
irgendwann  die  “High-water  mark”  erreichen. 

Tritt  dieser  Fall  ein,  wird  dem  Sender  der  Gegenseite  iiber  EIN-Signal  (+12V)  am  RTS- 
AnschluB  des  ST  (bei  Hardware-Handshake)  bzw.  durch  Senden  eines  “Ctrl-S”-Zeichens  = 
XOFF-Zeichen  (bei  Software-Handshake)  signalisiert,  die  weitere  Aussendung  von  Zeichen 
zu  unterbrechen. 

Sinkt  der  “FUllstand”  des  Empfangspufferspeichers  durch  Auslesen  von  Zeichen  dann  wieder 
unter  die  “Low-water  mark”,  so  wird  die  Gegenseite  per  AUS-Signal  (-12V)  an  RTS  (bei 
Hardware-Handshake)  bzw.  Senden  eines  XON-Zeichens =“Ctrl-Q”  (bei  Software-Handshake) 
dariiber  informiert,  dal)  der  ST  wieder  bereit  ist,  Daten  aufzunehmen. 

Friihere  TOS-Versionen  (bis  zum  Blitter-TOS  1.02)  erwarteten  bei  RTS/CTS-Handshake 
nach  der  Ausgabe  jedes  Zeichens  ein  Quittungssignal  (kurzes  “Ein”)  iiber  die  CTS-Leitung. 
AuKerdem  wurde  vom  ST  die  RTS-Leitung  nach  dem  Empfang  eines  jeden  Zeichens  fiir  die 
Dauer  der  Verarbeitung  auf  “Aus”  und  erst  anschlieflend  wieder  auf  “Ein”  gesetzt! 

In  der  TOS-Version  1.04  funktioniert  der  RTS/CTS-Handshake  dann  endlich  wie  gedacht, 
wenn  er  sich  nur  einschalten  lieBe!  Die  dazu  notige  XBIOS-Routine  #15  (Rsconf)  hat  einen 
Bug,  der  das  Einschalten  des  RTS/CTS-Handshakes  nicht  erlaubt.  Der  Fehler  liiBt  sich  aber 
mit  einem  von  ATARI  gelieferten  Autoordner-Programm  (TOS14FTX.PRG)  beheben. 


Die  serielle  Schnittstelle 
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Bei  neueren  TOS-Versionen  (im  MEGA  STE  und  im  TT!)  hat  ATARI  diesen  Bug  nicht  mit 
iibemommen.  Der  RTS/CTS-Handshake  laGt  sich  jetzt  zwar  mittels  Rsconf-Aufruf  setzen. 
Leider  plaziert  die  Rsconf-Routine  des  TOS  die  Handshake-Parameter  an  eine  S  telle  in  der 
IOREC-Struktur,  die  iiberhaupt  nicht  von  den  entsprechenden  Interrupfcroutinen  bei  der  Fest- 
ste1IungdergewunschtenHandshake-Betriebsartausgewertetwird(Rsconftragt  die  Handshake- 
Art  mittels  Wordzugnff  in  die  IOREC-Struktur  ab  Byte  32  ein,  getestet  wird  die  Handshake- 
Art  aber  in  den  Interrupt-Routinen  mit  By/ezugriffen  auf  Byte  33)!  Auch  hier  kann  man  sich 
dann  nur  wieder  mit  entsprechenden  Patch-Programmen  helfen. 
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Kapitel  6:  Die  parallele  Druckerschnittstelle 


Die  ST-Computer  besitzen  eine  Schnittstelle  far  den  Anschlufl  eines  Druckers  mit  Centronics- 
Interface. 

Die  Centronics-Schnittstelle  erlaubt  gegeniibcr  einer  seriellen  Schnittstelle  relativ  hohe 
Dateniibertragungsraten,  weil  jeweils  ein  komplettes  Byte  fiber  acht  parallele  Datenleitungen 
an  den  Drucker  ausgegeben  wird.  Fur  die  Darstellung  der  Informationszustande  (Bit-High 
Oder  -Low)  auf  den  Leitungen  werden  TTL-Pegel  verwendet. 


Abb.  6.1 :  Timing-Diagramm  der  Centronics-Schnittstelle 


Eine  STROBE-Leitung  signalisiert  dabei  dem  Drucker  durch  einenkurzen  Low-Impuls,  wann 
die  auf  dem  8-Bit-Bus  liegenden  Daten  giiltig  sind.  Die  Daten  werden  bei  der  steigenden 
Flanke  des  STROBE-Impulses  vom  Drucker  ubemommen. 

Da  der  Computer  in  der  Regel  mit  der  Datenausgabe  schneller  ist,  als  der  Drucker  die  Zeichen 
aufs  Papier  bringen  kann,  ist  ein  weiteres  Handshaking-Signal  zur  storungsfreien  Dateniiber- 
tragung  erforderlich.  Uber  die  BUSY-Leitung  zeigt  der  Drucker  dem  Computer  mit  einem 
High-Pegel  an,  wenn  er  noch  bescMfdgt  (busy)  ist  und  noch  keine  neuen  Daten  aufnehmen 
kann.  Ublicherweise  stellen  Drucker  mit  Centronics-Schnittstelle  noch  mindestens  ein  soge- 
nanntes  ACKNLG-Signal  (Acknowledge  =  Empfangsbestatigung)  zur  Verfugung,  welches 
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durch  Low-Impuls  die  korrekte  Dateniibemahme  bestatigt.  Dieses  Signal  wird  jedoch  von  den 
ST-Computem  nicht  ausgewertet. 


Drucken  mit  Musik? 

Auch  wenn  fur  die  parallele  Schnittstelle  der  Soundchip  benutzt  wird,  der  ST  macht  wahrend 
des  Druekvorgangs  keine  Musik,  um  eventuell  das  nervtotende  Gerausch  eines  sagenden 
Matrixdruckers  zu  iibertdnen.  Vielmehr  wird  der  PSG-Chip  (Programmable-Sound-Genera¬ 
tor)  des  ST  fur  die  Datenausgabe  auf  den  Drucker  mitbenutzt. 

Wie  der  kurze  Ausschnitt  aus  der  ST-Schaltung  zeigt,  kommen  die  Interfaceleitungen  fiir  die 
Parallel-Schnittstelle  von  zwei  verschiedenen  Chips  des  ST-Computersystems. 
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Abb.  6.2:  So  ist  die  Centronics-Schnittstelle  des  ST  aufgebaut 


Die  parallele  Druckerschnittstelle 
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Der  Port  B  des  PSG-Chips  1  iefert  die  Signale  fiir  die  acht  Datenleitungen.  An  Port  A,  AnschluB 
IOA5,  wird  das  STROBE-Signal  generiert.  Die  Statusabfrage  der  BUSY -Leitung  erfolgt  iiber 
den  MFP-Baustein  (Multi-Function  Peripheral)  an  dessen  Eingang  10. 

Fiir  den  AnschluB  eines  Druckers  kann  einhandelsiibliches  Druckerkabel  mit  DB  25S-Stecker 
auf  der  Seite  zum  Computer  und  36pol.  AMP-Stecker  zum  Drucker  verwendet  werden  (wird 
auch  fiir  AnschluB  von  Druckem  mit  Centronics- AnschluB  an  PC-kompatible  Computer  be- 
nutzt). 

Die  Zeichenausgabe  an  die  Parallelschnittstelle  wird  natiirlich  voll  vom  Betriebssystem 
unterstiitzt  (siehe  auch  BIOS-Funktionen  #1 ,  #2  und  #3  (“Bconstat”,  “Bconin”,  “Bconout”)). 
Die  Datentransferrate  liegt  bei  ca.  4000  Bytes/Sek.  (War  das  toll,  wenn  der  Drucker  da  mit- 
kame),  wobei  die  Ausgange  jeweils  eine  Standard-TTL-Last  treiben  konnen. 

Beim  AnschluB  von  alteren  Druckem  mit  Centronics-Interface  sollte  man  darauf  achten,  daB 
die  Druckereingange  eine  nicht  zu  hohe  Belastung  fiir  die  PSG- Ausgange  darstellen.  Ursache 
sind  in  der  Regel  zu  niederohmige  Pull-up-Widerstande  im  Drucker,  die  offene  Eingange  auf 
High-Pegel  ziehen  sollen.  Nachmessen  kann  man  die  Stromaufnahme  der  Eingange,  indem 
man  bei  eingeschaltetem  Drucker  einen  Dateneingang  des  Centronics-Anschlusses  iiber  ein 
Milliampere-Meter  oder  VielfachmeBgerat  im  mA-Bereich  mit  Masse  verbindet.  Der  sich 
dann  einstellende  Strom  ist  auch  jener  Strom,  den  der  PSG  an  seinen  Ausgangen  liefem  konnen 
mufi.  Mit  mehr  als  3  mA  sollte  man  den  PSG  nicht  belasten. 


Keine  EinbahnstraBe! 

Nun  sind  aber  die  Ports  des  PSG  sowohl  als  Aus-  wie  auch  als  Eingange  verwendbar.  Mit  der 
BIOS-Funktion  #2  (“Bconin”)  mit  dem  Parallelport  als  Eingabeeinheit  (Char.  Device  #0) 
konnen  iiber  die  parallele  Schnittstelle  Daten  eingelesen  werden! 

Man  kann  dabei  den  ST  als  “Drucker”  betrachten,  der  mit  Daten  von  z.  B .  einem  anderen  Com¬ 
puter  beschickt  wird.  Uber  die  STROBE-Leitung  des  Parallelports  meldet  der  empfangende 
ST,  ob  er  empfangsbereit  (High-Pegel)  oderbeschaftigt  (Low-Pegel)  ist.  Uber  den  BUSY -An¬ 
schluB  erhalt  der  empfangende  ST  die  Signalisierung,  daB  die  anliegenden  Daten  giiltig  sind 
(bei  Low-Pegel). 


Vorsicht  ist  geboten! 

Man  sollte  bei  der  Benutzung  des  Parallelports  als  Eingang  beachten,  daB  beim  “Power-Up” 
des  ST  der  Port  B  zunachst  als  Ausgang  konfiguriert  wird!  Die  Datenleitungen  liefem  so  im 
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Ruhezustand  ein  Low.  Eine  an  den  ST  sendende  Einheit  sollte  also  erst  Daten  (sprich 
Logikpegel)  auf  die  Datenleitungen  des  Parallelports  legen,  wenn  der  empfangende  ST  den 
Port  B  auch  auf  “Eingang”  geschaltet  hat.  Das  ist  am  besten  daran  erkennbar,  daft  der 
STROBE-Anschluft  des  empfangenden  ST  auf  High  geht. 

Sonst  konnte  es  geschehen,  daft  zwei  verschiedene  Pegel  aufeinandertreffen  (das  Low  vom 
empfangenden  ST  und  ein  eventuelles  High  vom  sendenden  Computer!).  Diese  Tatsache 
konnte  der  Soundchip  iibelnehmen  und  sich  verabschieden! 

Die  bidirektionale  parallele  Schnittstelle  des  ST  wird  von  einigen  Zubehor-Anbietem  ausge- 
nutzt.  So  sind  z.  B.  EPROM-Programmiereinrichtungen  und  Sound-Sampler  erhaltlich,  die 
iiber  die  parallele  Schnittstelle  arbeiten. 


Ereigniszahlung  iiber  den  Druckerport 

Ein  weiteres  Detail,  welches  bei  der  Betrachtung  des  Schaltungsauszugs  auffallt,  ist  die  gleich- 
zeitige  Verbindung  der  BUSY -Leitung  des  Parallelports  mitdem  Eingang  10  des  MFP  und  mit 
dem  Anschluft  TAI  (Timer-A-Input) !  Somit  kann  Timer  A  des  MFP,  welcher  vom  TOS  nicht 
gebraucht  wird,  z.  B.  als  Ereigniszahler  Oder  zur  Pulsweitenmessung  benutzt  werden. 

AuBerdem  ist  der  Eingang  10  des  MFP,  an  welchem  die  BUSY -Leitung  der  parallelen  Schnitt¬ 
stelle  auflauft,  ja  ebenfalls  als  Interrupt-Eingang  zu  betreiben.  Damit  kann  man  einen  Interrupt 
auslosen  lassen,  wennBUSY  vom  Drucker  wiederauf  Low  gesetztwird.  Damit  wird  jasignali- 
siert,  daB  ein  weiteres  Zeichen  an  den  Drucker  ausgegeben  werden  kann.  Die  zugehorige 
Interruptroutine  kann  nun  ein  weiteres  Zeichen  aus  einem  Pufferspeicher  holen  und  ausgeben. 
In  diesem  Pufferspeicher  werden  sinnvollervveise  alle  Zeichen  gesammelt,  die  von  den  Druck- 
ausgaberoutinen  des  Betriebssystems  sonst  direkt  an  den  Drucker  gesendet  werden. 

Druckausgaben  von  Programmen  fiillen  also  schnell  diesen  Pufferspeicher  und  blockieren 
nicht  lange  die  Arbeit  mit  dem  ST,  weil  dieser  warten  muB,  bis  der  Drucker  alle  Zeichen  aufs 
Papier  genadelt  hat.  Durch  Ausnutzen  des  BUSY-Interrupts  laBt  sich  also  ein  effektiver 
Druckerspooler  programmieren  (so  z.  B.  im  STMagazin  4/88,  “Drucken  ohne  Zeitverlust”, 
beschrieben),  weil  wirklich  die  CPU  nur  dann  mit  Zeichenausgaben  an  den  Drucker  “bela- 
stigt”  wird,  wenn  dieser  bereit  ist,  ein  neues  Zeichen  zu  verarbeiten! 

Man  sieht  also,  daft  mit  der  parallelen  Schnittstelle  des  ST  noch  einiges  mehr  anzufangen  ist, 
als  sie  als  simplen  Druckeranschluft  zu  gebrauchen.  Besonders  dem  Hardware-Bastler  bieten 
sich  hier  noch  einige  interessante  Moglichkeitcn. 
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Kapitel  7:  Die  ACIAs  im  ST 


Im  ST  sind  zwei  Asynchrone-Communications-Interface- Adapter  (ACIA)  des  Typs  6850 
eingesetzt.  Sie  helfen  der  CPU  beim  Datenaustausch  mit  der  MIDI-Schnittstelle  und  der 
“intelligenten  Tastatur”.  Das  “Innenleben”  eines  ACIAs  soil  die  Abbildung  7.1  veranschau- 
lichen. 

Jeder  ACIA  stellt  einen  kompletten  Kanal  (Sende-  und  Empfangsteil)  fur  die  serielle  Daten- 
iibertragung  nach  der  RS-232-Spezifikation  zur  Verfiigung. 

Sender  und  Empfanger  konnen  dabei  mit  unterschiedlichen  Taktfrequenzen  gespeist  werden 
(iiber  die  AnschliisseTxCLK  und  RxCLK)  und  daher  mit  unterschiedlichen  Dateniibertragungs- 
geschwindigkeiten  (in  diesem  Fall  gleich  der  Baudrate,  da  Verwendung  binarer  Signale) 
arbeiten. 

Beim  ST  werden  die  beiden  ACIAs  jedoch,  sowohl  fur  die  Sender-  als  auch  die  Empfangerseite, 
mit  der  gleichen  Taktfrequenz  (500  kHz)  gespeist. 

Der  ACIA  fiir  die  MIDI-Schnittstelle  arbeitet  (It.  MIDI-Spezifikation)  mit  einer  Dateniibertra- 
gungsrate  von  3 1250  Bit/s,  der  ACIA  fiir  die  “intelligente  Tastatur”  mit  78 13,5  Bit/s.  Wie  aus 
dem  Blockschaltbild  hervorgeht,  verfiigt  jeder  ACIA  iiber  vier  Register  mit  einer  Breite  von 
8  Bit. 

Die  empfangenen  seriellen  Daten  (iiber  AnschluR  RxDATA)  werden  zunachst  in  einem 
Empfangs-Schieberegister  gesammelt.  1st  ein  Zeichen  aus  dem  empfangenen  seriellen 
Bitstrom  “zusammengebaut”,  wird  es  ins  Empfangsregister  iibertragen  und  zur  Signalisierung 
im  Statusregister  das  Bit  0  (RDRF-Bit  =  “Receive  data  register  fulT-Bit)  gesetzt.  Wenn  der 
Empfanger-Interrupt  zugelassen  ist,  wird  auch  gleichzeitig  ein  Interrupt  ausgelost. 

Die  zu  sendenden  Informationen  miissen  dem  ACIA  iiber  das  Senderegister  eingegeben 
werden.  Es  kann  nur  beschrieben  werden.  Ein  zu  sendendes  Zeichen  wird,  nachdem  es  ins 
Senderegister  eingeschrieben  wurde,  von  dort  ins  Sende-Schieberegister  iibertragen  und  im 
Takt  der  Ubertragungsggeschwindigkeit  B  it  fiir  Bit  “ins  Freie”  geschoben  (iiber  den  AnschluR 
TxDATA). 

Zur  Signalisierung,  daB  das  Senderegister  geleert  wurde,  also  ein  neues  Zeichen  eingeschrie¬ 
ben  werden  kann,  wird  im  Statusregister  das  Bit  1  (TDRE-Bit  =  “Transmitter  data  register 
empty”-Bit)  gesetzt.  Ist  der  “Sender-Interrupt”  ffeigegeben,  wird  ein  Interrupt  ausgelost, 
wenn  das  Senderegister  wieder  “nachgeladen”  werden  muR. 
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Abb.  7.1 :  Das  Blockschaltbild  des  AC1A  6850 


ACIA-Steuerregister 

Nur  Schreiben  erlaubt!  Bit  fur  Bit  lassen  sich  bestimmte  Betriebsweisen  des  ACIA  einstellen. 
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Bit  1 

BitO 

1  Funktion 

0 

0 

Baudrate  ist  gleich  Taktfrequenz 

0 

1 

Baudrate  ist  1/16  der  Taktfrequenz  (MIDI-Port) 

I 

0 

Baudrate  ist  1/64  der  Taktfrequenz  (Tastatur) 

1 

1 

Riicksetzung  des  ACIA  (Master-Reset) 

Die  Neuinitialisierung  eines  ACIAs  muG  softwaremaBig  erfolgen.  Das  geschieht  durch  Setzen 
der  beiden  niederwertigen  Bits  im  Steuerregister. 

Die  Bits  2.4  des  Steuerregisters  bestimmen  das  Zeichenformat  fur  die  Dateniibertragung. 


Bit-Nr.: 

4  1 

3 

2 

Funktion 

0 

0 

0 

7  Datenbits,  gerade  Paritat,  2  Stop-Bits 

0 

0 

1 

7  Datenbits,  ungerade  Paritat,  2  Stop-Bits 

0 

1 

0 

7  Datenbits,  gerade  Paritat,  1  Stop-Bit 

0 

1 

1  1 

7  Datenbits,  ungerade  Paritat,  1  Stop-Bit 

1 

o 

0 

8  Datenbits,  keine  Paritat,  2  Stop-Bits 

1 

0  ! 

1 

8  Datenbits,  keine  Paritat,  1  Stop-Bit 

] 

1 

0 

8  Datenbits,  gerade  Paritat,  1  Stop-Bit 

1 

1 

1  ! 

8  Datenbits,  ungerade  Paritat,  1  Stop-Bit 

Die  Bits  5  und  6  im  Steuerregister  dienen  zur  Steuerung  des  Sendeteils. 


Bit  6 

Bit  5 

Funktion 

0 

o 

RTS  auf  Low,  TxINT  gesperrt 

0 

1 

RTS  auf  Low,  TxINT  freigegeben 

1 

0 

RTS  auf  High,  TxINT  gesperrt 

1 

1 

RTS  auf  Low,  TxINT  gesperrt.  Break  senden 

“Break  senden”  bedeutet  nichts  anderes  als  die  Sendeleitung  bis  auf  weiteres  auf  Low-Pegel 
zu  halten,  also  wird  eine  laufende  Folge  von  0-Bits  gesendet. 

Durch  Setzen  des  Bit  7  des  Steuerregisters  wird  der  “Empfanger-Interrupt”  (RxINT)  einge- 
schaltet.  So  wird  immer  dann  ein  Interrupt  ausgelost,  wenn  das  Empfangsregister  voll  ist  und 
ein  Zeichen  ausgelesen  werden  soil. 

Weiterhin  fiihrt  ein  Low/High-Wechsel  am  DCD-AnschluB  (Data  Carrier  Detect)  oder  ein 
Empfangsfehler  (Receiver  Overrun  Error)  zum  Interrupt. 
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ACIA-Statusregister 

Dieses  Register  liefert  Informationen  iiber  den  Zustand  einer  Dateniibertragung.  Alle  acht  Bits 
signalisieren  wieder  verschiedene  Betriebszustande  Oder  Fehler. 

Bit  0  =  “Receive  Data  Register  Full”  (RDRF-Bit) 

Wird  gesetzt,  sobald  das  Empfangsregister  voll  ist,  also  ein  Zeichen  ausgelesen  warden  muG. 
Dieses  Bit  wird  geloscht,  wenn  das  empfangene  Zeichen  aus  dem  Empfangsregister  ausge¬ 
lesen  oder  ein  Master-Reset  durchgefiihrt  wird. 

Bit  1  =  “Transmit  Data  Register  Empty”  (TDRE-Bit) 

Geht  auf  Log.  1 ,  wenn  der  Sender  wieder  mit  dem  nachsten  zu  sendenden  Zeichen  “nachge- 
laden”  werden  muG. 

Bit  2  =  “Data  Carrier  Detect”  (DCD-Bit) 

Wird  gesetzt,  wenn  der  DCD-AnschluG  auf  High  geht  (Modem  signalisiert:  “Es  wird  kein  Da- 
ten-Tragersignal  empfangen”).  1st  derRxINT  freigegeben,  wird  auch  ein  Intemipt  ausgelost! 
Das  Bit  wird  erst  geloscht,  wenn  das  Status-  und  damn  das  Empfangsregister  “bedient”,  d.  h. 
ausgelesen  wurden.  Bleibt  danach  derDCD-AnschluB  weiterhin  High,  so  wird  zwar  ein  evtl. 
Interrupt  geloscht,  das  DCD-Bit  bleibt  aber  weiter  gesetzt,  bis  derDCD-AnschluB  wieder  auf 
Low  geht.  Im  ST  wird  dieses  Bit  nicht  verwendet,  weil  der  DCD- AnschluB  fest  auf  Low  (Mas¬ 
se)  liegt! 

Bit  3  =  “Clear  To  Send”  (CTS-Bit) 

Dieses  Bit  zeigt  den  Zustand  des  CTS-Anschlusses  an.  Ist  der  CTS-Anschlufi  High  (Sender 
nicht  bereit),  bleibt  auch  das  TDRE-Bit  (Bit  1)  unwirksam,  da  ja  keine  Daten  gesendet  werden 
konnen.  Ein  Master-Reset  beeinfluBt  dieses  Bit  nicht!  Im  ST  wird  dieses  Bit  nicht  verwendet, 
weil  der  CTS-AnschluB  fest  auf  Low  (Masse)  liegt! 

Bit  4  =  “Framing  Error”  (FE-Bit) 

Ein  gesetztes  Bit  signalisiert  einen  Empfangsfehler.  Es  wurde  ein  “Nicht-Null”-Zeichen  emp¬ 
fangen,  dem  aber  “das  Ende”,  d.  h.  ein  Stopbit  fehlt. 

Bit  5  =  “Receiver  Overrun”  (OVRN-Bit) 

Wird  gesetzt,  wenn  ein  empfangenes  Zeichen  im  Empfangsregister  “vergessen”  worden  ist. 
Das  nachste  bereits  empfangene  Zeichen  hat  das  noch  im  Empfangsregister  vorhandene  Zei- 
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chen  “iiberrannt”,  d,  h.  uberscbrieben,  bevor  es  ausgelesen  wurde.  1st  der  RxINT  zugelassen, 
erfolgt  auch  eine  Interrupt-Signalisierung.  Ein  gesetztes  OVRN-Bit  wird  durch  Lesen  des 
Empfangsregisters  Oder  einen  Master-Reset  geldscht. 

Bit  6  =  “Parity  Error”  (PE-Bit) 

Wenn  Dateniibertragung  mit  ParitStspriifung  durchgefiihrt  wird,  signalisiert  ein  gesetztes  PE- 
Bit,  dab  die  Zahl  der  l  -Bits  des  empfangenen  Zeichens  nicht  mit  der  gewahlten  Paritat  (gerade 
oder  ungerade  Anzahl  von  1-Bits)  iibereinstimmt. 

Bit  7  =  “Interrupt  Request”  (IRQ-Bit) 

Geht  bei  einem  Interrupt  auf  log.  1  (der  TRQ-AnschluJi  wird  bei  einem  Interrupt  Lowl). 


Einbindung  in  die  ST-Hardware 

Aufgrund  der  besonderen  Registeranordnung  (Zwei  “Nur  Lesen”-  und  zwei  “Nur  Schreiben”- 
Register)  benotigt  jeder  ACIA  nur  zwei  Adressen  im  I/O-Bereich  eines  Computersystems  (so 
auch  im  ST). 

Im  ST  sind  das  die  folgenden  Adressen: 


Adresse 

Device 

Register 

Zugriff 

Label 

$FF  FCOO 

Tastatur 

Steuerregister 

Statusregister 

Write 

Read 

“keyed” 

SFFFC02 

Tastatur 

Senderegister 

Empfangsregister 

Write 

Read 

“keybd” 

$FF  FC04 

MIDI-Port 

Steuerregister 

Statusregister 

Write 

Read 

“midictl” 

SFFFC06 

MIDI-Port 

Senderegister 

Empfangsregister 

Write 

Read 

“midi” 

Die  Register  sind  nur  8  Bit  breit  (also  keine  Wortzugriffe!).  Auf  welches  Registerpowr  zuge- 
griffen  wird,  hangt  vom  Zustand  des  RS-Anschlusses  (Register  Select)  des  ACIA-Chips  ab. 
Uber  die  R/W-Leitung  wird  dann  das  entsprechende  Register  angewahlt. 


RS 

R/W 

ausgew.  Register 

Zugriffsart 

0 

0 

Steuerregister 

Schreiben 

0 

I  1 

[  Statusregister 

Lesen 
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RS 

R/W 

ausgew.  Register 

Zugriffsart 

1 

f - 

0 

Senderegister 

Schreiben 

1 

1 

Empfangsregister 

Lesen 

Soviel  zum  Innenleben  des  ACIA.  Jetzt  zum  Einsatz  der  ACIA-Chips  im  ST. 


Die  MIDI-Schnittstelle 

MIDI  ist  die  Abkiirzung  fur  Musical-Instruments-Digital-Interface,  was  auf  deutsch  wohl  mit 
“Digitale  Schnittstelle  fur  Musikinstrumente”  libersetzt  werden  kann. 

Musikinstrumente  und  Effektgerate,  die  ihre  Klange  auf  digitalem  Wege  erzeugen  oder  die 
Klangerzeugung  digital  steuem  konnen  (z.  B.  Synthesizer,  elektronisehe  Orgeln,  Rhyth- 
musgerate,  Mischpulte),  besitzen  meist  eine  MIDI-Schnittstelle.  Uber  diese  Schnittstelle  las- 
sen  sich  diese  Gerate  nun  “fembedienen”. 

Um  also  mehrere  Synthesizer  und  Effektgerate  simultan  spielen  zu  konnen,  braucht  man  nur 
ein  Mastergerat,  welches  iiber  nur  einen  Ausgang  (MIDI-out)  bis  zu  16  Einheiten  (Slaves) 
bedienen  kann. 

Ist  ein  Computer  mit  seiner  groBen  Speicherkapazitat  und  Verarbeitungsgeschwindigkeit  als 
Master  angeschlossen,  so  kann  dieser  als  Sequenzereingesetzt  werden,  d.  h.,  er  versorgt  pro- 
grammgesteuert  die  angeschlossenen  Gerate  mit  Einstellungen  oder  kompletten  Melodien. 
Die  Instrumente  werden  sozusagen  vom  Computer  gespielt. 

Weiterhin  kann  der  Computer  als  digitale  Bandmaschine  arbeiten  und  z.  B.  iiber  ein  Keyboard 
gespielte  Melodien  aufzeichnen.  Es  ware  aber  nun  wenig  sinnvoll,  wenn  per  Tastendmck  am 
Mastergerat  standig  alle  angeschlossenen  Slaves  (Synthesizer,  Rhythmusmaschinen)  reagie- 
ren  wiirden. 

Man  kann  deshalb  auch  mit  nur  einem  Ausgang  am  Master,  iiber  eine  durchgeschleifte  Ver- 
bindung  (bei  den  Slaves  in  MIDI- in  rein  und  bei  MIDI-Thru  wiederraus  zum  nachsten  Slave) 
an  mehrere  angeschlossene  Einheiten  verschiedene  Informationen  senden.  Diese  Informatio- 
nen  miissen  nur  entsprechend  “adressiert”  werden.  Folgende  Betriebsarten  sind  moglich: 

Der  OMNI -Modus  ist  die  einfachste  Betriebsart.  Nach  einem  RESET  befinden  sich  alle  Gerate 
in  diesem  Modus.  Alle  Instrumente,  die  an  einem  Bus  hangen,  spielen  parallel  und  mehrstimmig 
(polyphon).  Es  existiert  also  eigentlich  nur  ein  Kanal,  und  das  gezielte  Ansprechen  eines  ein- 
zelnen  Gerats  ist  nicht  moglich. 
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Per  POLY-Modus  lassen  sich  verschiedene  Gerate  separat  ansteuem.  Jeder  Slave  bekommt 
eine  Kanalnummer  zugeordnet,  die  fur  ihn  gultig  ist.  Das  Gerat  hat  nur  auf  Kommandos  zu 
reagieren,  die  auf  “seinem”  Kanal  empfangen  werden,  also  mit  seiner  Kanalnummer  adres- 
siert  sind.  So  konnen  dann  mit  beliebig  vielen  Instrumenten  maximal  1 6  verschiedene  Melo- 
dien  (auf  jedem  Kanal  eine  andere)  gespielt  werden. 

Der  MONO-Modus  ist  die  komplexeste  Betriebsart.  Man  kann  damit  einzelnen  Stimmen  eines 
Synthesizers  getrennte  Kanale  zuordnen  und  so  unabhangig  voneinander  beeinflussen.  Jede 
Stimme  kann  nun  wie  ein  einzelner  einstimmiger  (monophoner)  Synthesizer  angesprochen 
werden.  Verfiigt  ein  16stimmiger  Synthesizer  iiber  die  Mono-Betriebsart,  kann  also  auf  die- 
sem  mit  nur  einem  Sequenzer  ein  Orchester  mit  bis  zu  16  monophonen  Instrumenten  gespielt 
werden! 

Man  unterscheidet  bei  der  MIDI-Datentibertragung  die  beiden  groBen  Gruppen  Statusbytes 
und  Datenbytes.  Die  Datenby tes  enthalten  die  Daten  zu  einem  Kommando  und  folgen  einem 
Statusby  te.  Das  Statusby  te  “sagt”,  was  gemacht  werden  soli,  wahrend  die  Datenbytes  die  noti- 
gen  Informationen  beinhalten,  mit  denen  die  angesprochene  Einheit  eingestellt  werden  soil 
(z.  B.  Schalter-bzw.  Reglerstellung).  Einem  Statusbyte  folgen  normalerweise  zwei  Datenbytes. 

-  MIDI-Statusbytes  unterscheiden  sich  von  den  Datenbytes  durch  ein  gesetztes  achtes 
Datenbit.  Sie  lassen  sich  unterteilen  in: 

-  Kanalkommandos 

Hierzu  gehoren  die  sogenarmten  Voice-Commands,  welche  zur  Steuerung  und 
Programmierung  von  einzelnen  Instrumenten-Stimmen  dienen.  Mit  ihnen  werden 
Tone  ein-  oder  ausgeschaltet,  Tonhohen  eingestellt  Oder  Informationen  iiber  Tasten- 
Anschlagsdynamik  (“attack  velocity”  bzw.  Tasten-LoslaBdynamik  (“release  velo¬ 
city”)  und  iiber  den  Tastendruck  (“after  touch”)  gegeben.  AuBerdem  konnen  bis  zu 
32  Regler  und  32  Schalter  zur  Klangeinstellung  betatigt  werden.  Die  Schalter-/  Reg- 
lemummer  und  die  Schalter-/  Reglerstellung  sind  in  den  Datenbytes  enthalten. 

Die  zweite  Gruppe  der  Kanalkommandos  sind  die  Modus-Kommandos.  Mit  ihnen 
wird  einem  Instrument  mitgeteilt,  in  welcher  Betriebsart  gearbeitet  werden  soil 
(Omni-,  Poly-  oder  Mono-Mode).  Weiterhin  lafit  sich  damit  z.  B.  die  Tastatur  eines 
Synthesizers  abschalten,  so  daB  er  nur  liber  MIDI  gespielt  werden  kann. 

-  Systemkommandos 

Diese  gelten  nicht  fur  einenbestimmten  Kanal.  Man  unterscheidet  bei  den  Systemkom¬ 
mandos  drei  Gruppen: 
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Daten- 
Byte  1 

Daten- 
Byte  2 

Bedeutung 

8B..8F 

9 

BB.. 7F 

NBTE  OFF  (nit  Kanalnr.)  gefolgt 
von  Hotennr.  und  VELOCITY  (0B=Note  Off, 
Bi=pianissino,  7F=fortissimo) 

9B..9F 

1  1 

BB..7F 

NOTE  OH  (nit  Kanalnr.)  gefolgt 
von  Hotennr.  und  VELOCITY 

60. .flF 

BB..7F 

00.. 7F 

POLYPRESSURE  (nit  Kanalnr.)  gefolgt 
von  Hotennr.  und  PRESSURE  VALUE 

BB..BF 

BB. .IF 

08.. ?F 

CONTROL  CHANGE  (nit  Kanalnr.)  gefolgt 
von  CONTRQLLER-Hr.  (I. .32,  CTL.-Hr.i=0B) 
und  CONTROLLER-UflLUE-MSB  £1 . ,128) 

11  II 

20., 3F 

00.. 7F 

CONTROL  CHANGE  (nit  Kanalnr.)  gefolgt 
von  CONTROLLER-Nr.  (1..32,  CTL.-Nr.l=20) 
und  CONTROLLER-VALUE-LSB  (1. .128) 

II  II 

4B..5F 

BB..7F 

SWITCH  CHANGE  (nit  Kanalnr.)  gefolgt 
von  SWITCH-Nr.  (1. .32,  SW.-Nr.i=B8) 
und  SWITCH-POSITION  (80=Off,  7F=0n) 

CB..CF 

B0..7F 

PROGRAM  CHANGE  (nit  Kanalnr.)  gefolgt 
von  PROGRAM-Nr. 

B0..7F 

CHANNEL  PRESSURE  (nit  Kanalnr.)  gefolgt 
von  PRESSURE-VALUE 

EB..EF 

0B..7F 

0B..7F 

PITCH  WHEEL  CHANGE  (nit  Kanalnr.)  gefolgt 
von  UALUE-LSB  und  UALUE-MSB 

Abb.  7.2:  Voice  Commands 


Common  Commands  haben  EinfluB  auf  alle  angeschlossenen  Gerate  und  werden 
benutzt,  um  einen  bestimmten  Song  Oder  eine  Sequenz  oder  eine  bestimmte  Stim- 
mung  auszuwahlen  oder  um  ein  System-Reset  auszufiihren. 

RealT ime  Commands  dienen  zur  Synchronisation  der  Instrumente.  Mit  ihnen  werden 
Rhythmusmaschinengestartet,gestopptodergetaktet.IhnenfolgenkeineDatenbytes. 
Sie  konnen  auch  zwischen  Datenbytes  anderer  Kommandos  gesendet  werden. 

Exclusive  Commands  sind  herstellerspezifische  Informationen  fiir  Sonderfunktionen, 
die  nicht  von  jedem  Gerat  beherrscht  werden.  Sie  konnen  beliebig  viele  Datenbytes 
hinter  sich  herziehen. 
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wamm 

Daten- 
Byte  1 

Daten- 
Byte  2 

Bedeutung 

B0..BF 

70 

BB  /  7F 

LOCAL  KEYBOARD  CONTROL  (nit  Kanalnr.) 
gefolgt  von  1 7ft*  und  SHITCH-VOLUE 
(OB  =  LOC,  KBO.  off,  7F  =  LOG,  KBD.  on) 

II  1! 

78 

00 

ALL  NOTES  OFF  (nit  Kanalnr.) 

II  II 

7C 

— 

OMNI  MODE  OFF  (nit  Kanalnr.) 

II  II 

7D 

BB 

OMNI  MODE  ON  (nit  Kanalnr.) 

II  li 

MONO  MODE  ON  /  POLY  MODE  OFF  (nit  Kanal¬ 
nr.)  gefolgt  von  *  7E'  und  Bnzahl  der 
nonophon  gespielten  VOICES  (BO  =  alle 
VOICES  des  Instruments)) 

II  II 

I  7F 

POLY  MODE  ON  t  MONO  MODE  OFF 
(nit  Kanalnunner) 

Abb.  7.3:  Mode  Commands 


Die  technische  Realisierung  der  MIDI-Schnittstelle 

Die  MIDI-Schnittstelle  arbeitet  nach  dem  Stromschleifen-Prinzip  (gearbeitet  wird  mit  einer 
Standardstromstarke  von  ca,  5  mA),  d.  h.,  “Strom”  und  “kein  Strom”  sind  die  Aussagen  fiir 
eine  logische  0  oder  I .  Dieses  Prinzip  ist  bei  groOeren  Leitungslangen  wesentlich  unempfind- 
licher  gegeniiber  Storungen  als  die  Dateniibertragung  mit  Spannungspegeln. 

Die  Dateniibertragungsrate  liegt  nach  der  MEDI-Spezifikation  bei  31,25  kBit/s.  Ein  Zeichen 
ist  8  Bitbreit,  umrahmt  von  einem  Start-  und  Stopbit.  Ein  Bit  ist  also  32  pSek.  lang;  die  Ubertra- 
gung  eines  Zeichens  dauert  somit  320  pSek.  Optokoppleran  den  Eingangen  (MIDI-in)  sorgen 
fiireinePotentialtrennungderangeschlossenenEinheitenundverhindemsoMasseverschleifun- 
gen  und  Brummstbrungen. 

Der  serielle  MIDI-Bus  hat  fiir  jede  Datenrichtung  eine  eigene  Leitung.  An  MIDI-in  werden 
Daten  empfangen,  iiber  MIDI-out  ausgesendet.  Beim  ST  werden  die  empfangenen  Daten  von 
MIDI-in  nach  MIDI-out  durchgeschleift.  So  wird  die  Funktion  MIDI-Thru  realisiert, 

Den  Empfang  von  seriellen  Daten  melden  sowohl  der  MIDI-  als  auch  der  T astatur-ACLA  iiber 
ein  Low-Signal  auf  der  IRQ-Leitung.  Beide  ACIA-IRQ-Anschliisse  sind  miteinander  verbun- 
den  (Open-Collector-Ausgange)  und  laufen  am  Eingang  14  des  MEP  auf. 
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Status- 

Byte  Bedeutung 


Connon  Infornations 


nicht  definiert  ! 

S0HB-P0SITI0H  (die  beiden  folgenden  Oatenbytes  enthal- 
ten  LSB  und  MSB  der  S0H6  POSITION.  (I  Count  =  6  MIDI- 
Clocks)) 


SONG  SELECT  (das  folgende  Datenbyte  enthalt  die  SONG- 
NUMBER) 


F4..F5  nicht  definiert  ! 


TUNE  REQUEST 


SYSTEM  RESET 


Real  Tine  Infornationsl 


TIMING  CLOCK  (24  Clockinpulse  /  Viertel-Note) 


nicht  definiert  ! 


START  (setzt  SOHG  POSITION-Pointer  zuriick!) 


nicht  definiert  ! 


ACTIVE  SENSING  (Nird  in  Pausen  alle  300  ns  gesendet,  un 
Enpfanger  bereit  zu  halten!) 


Systen  Exclusive  Infornations 


SYSTEM  EXCLUSIVE  (das  folgende  Datenbyte  enthalt  die 
Herstelleridentifikationj  beliebig  viele  Datenbytes 
konnen  folgen!) 


END  OF  SYSTEM  EXCLUSIVE  (zeigt  Ende  der  SYSTEM  EXCLU- 
SIV-Daten  an) 


Abb.  7.4:  System  Commands 
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Welcher  ACIA  (Tastatur  oder  MIDI)  “interrupted”  hat,  muB  dann  in  der  Interruptroutine  fiir 
den  Port  14  des  MFP,  durch  Abfrage  der  beiden  ACIA-Statusregister  ennittelt  werden. 

Auch  am  MIDI -in  Eingang  des  ST  findetman  natiirlich  den  MIDI-typischen  Optokoppler  zur 
Potentialtrennung  (siehe  Abbildung  7.5).  Das  empfangene  MIDI-Signal  wird  gleich  wieder 
an  die  MIDI-out  Buchse  (Pin  3  +  1)  durchgeschleift  (MIDI-Thru-Funktion). 


Fiir  die  Wandlung  von  log.  Pegeln  des  ACIA- Ausgangs  TxDATA  auf  die  Stromsteuerung  der 
MIDI-Schnittstelle  sorgen  die  Inverter,  gebildet  mit  TTL-Chips  des  Typs  “LS04”  und  “LS05”. 


Abb.  7.5:  Die  MIDI-Schnittstelle  des  ST 


922 


ATARI  Profibuch 


Die  “LS05”-Inverter  besitzen  dabei  Open-Collector-Ausgangsstufen  und  schalten  damit  nur 
den  Strom  im  Ausgangskreis  ein  bzw.  aus.  Da  es  bei  MIDI  keinen  hardwaregesteuerten  Hand¬ 
shake  gibt,  sind  die  entsprechenden  Anschlusse  des  ACIA  (RTS,  CTS,  DCD)  unwirksam  ge- 
schaltet. 

Softwaremaflig  wird  die  Programmierung  der  MIDI-Schnittstelle  vom  TOS  durch  die  XBIOS- 
Funktionen  #12  (“Midiws”)  und  #14  (“Iorec”)  unterstiitzt,  “Iorec”  arbeitet  jedoch,  im  Gegen- 
satz  zur  Datenubertragung  iiber  die  RS232-Schnittstelle,  bei  MIDI-Betrieb  nur  mit  einem 
Empfangspuffer. 


Die  Tastatur 

Die  iippig  ausgelegte  Tastatur  des  ST  (95  Tasten)  hilft  dem  Anwender  dabei,  sich  dem 
Betriebssystem  “bemerkbar”  zu  machen.  Ein  Tastendruck  mu8  dabei  in  ein  entsprechendes 
Zeichen  umgeformt  und  dem  TOS  ubergeben  werden.  AuBerdcm  ist  laufend  zu  iiberwachen, 
was  der  Anwender  mit  der  Maus  und/oder  evtl,  einem  angeschlossenen  Joystick  anstellt.  Um 
die  CPU  dabei  moglichst  wenig  mit  dieser  eintonigen  Tatigkeit  (die  groBte  Zeit  vergeht  dabei 
mit  dem  Warten  auf  einen  Tastendruck  Oder  eine  Mausbewegung)  zu  belasten,  wurde  fiir  diese 
Aufgabe  ein  eigener  Mikrocontroller  herangezogen. 

Damit  dieser  sich  wahrend  des  Wartens  auf  irgendwelche  Reaktionen  nicht  zu  sehr  langweilt, 
darf  er  sich  auch  noch  gleichzeitig  als  Uhr  bctatigen.  Mittels  einer  zusatzlichen  Batterie  oder 
eines  Akkus  kann  man  den  IKBD-Chip  (Intelligent-KeyBoarD-Chip)  auch  dann  mit  Energie 
versorgen,  wenn  der  ST  ausgeschaltet  ist.  So  erh ait  man  eine  Uhr,  die  immer  richtig  geht  (siehe 
auch  Bauanleitung  in  68000er  3/87)! 


Ein  eigener  Computer  fiir  die  Tastatur 

Fiir  diese  Aufgabe  wurde  ein  Single-Chip-Mikrocomputer  der  6800-Familie  eingesetzt,  der 
“6301V1”.  Er  enthalt  in  einem  normalen  40pol,  DIL-Gehause  eine  8-Bit-CMOS  CPU, 
4KByte  ROM,  128  Bytes  RAM,  einen  16-Bit-Timer,  eine  serielle  Schnittstelle  und  vier  I/O- 
Ports  mit  insgesamt  29  Portleitungen!  Abbildung  7.6  gibt  einen  Einblick  in  das  Innenleben  des 
IKBD-Chips. 


Die  Denkzentrale 

Die  CPU  des  IKBD-Chips  enthalt  zwei  8-Bit- Akkumulatoren  A  und  B,  die  auch  zusammen 
als  ein  16-Bit-Akku  D  arbeiten  konnen.  Weiterhin  existiert  noch  ein  16-Bit-Index-Register 


Mehrere  Betriebsarten  zur  Auswahl 

Im  Blockschaltbild  findet  sich,  neben  bekannten  Funktionsblocken,  wie  man  sie  von  anderen 
Mikrocontrollem  kennt,  auch  ein  sogenannter  Mode-Control-Block.  Dieser  Mode-Control- 
Block  wirdbeieinem  Reset  benutzt.umfestzustcllen,  in  welcherBetnebsartdcrMikrocontroller 
arbeiten  soil. 
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Adr.  $0003 

Daten-Bits  von  Port  2 

Mode-Bits  (werden  nach  einem  Reset 
von  P20..P22  eingelesen) 

Im  ST  arbeitet  der  6301  im  Single-Chip-Modus  (Mode  7).  Aile  Ports  werden  dabei  fur  I/O- 
Zwecke  benutzt.  Der  Expanded-Multiplex-Mode  (Mode  0, 2, 4  oder  6)  wird  benutzt,  uni  den 
AdreBraumdes  6301  mitextemen  ROMs/RAMs  auf  bis  zu  64  KBytes  zu  erweitem.  Port  3  wird 
dabei  zu  einem  gemultiplexten  Daten-/AdreBbus  umfunktioniert. 

Weitere  acht  AdreBleitungen  konnen  an  Port  4  zur  Verfiigung  gestellt  werden. 

Im  Expanded-Non-Multiplexed-Mode  (Mode  1  und  5)  kann  der  6301  ebenfalls  bis  zu  64 
KByte  adressieren.  Port  3  wirddann  fur  den  Datenbus,  Ports  1  und  4  fur  den  AdreBbus  benutzt. 
AuBerdem  kann  der  6301  in  diesem  Modus  Peripherie-Bausteine  der  6S00-Familie  direkt 
(ohne  Adressen-Zwischenspeicherung)  ansprechen.  Welcher  Modus  gewiinscht  ist,  erfahrt 
der  6301  bei  einem  RESET  iiber  die  Portleitungen  P20..P22  von  “auBen”. 

SoftwaremaBig  lafit  sich  der  Modus  dann  nicht  mehr  andem. 

Wie  man  aus  dem  Schaltbild  der  ST-Tastatur  (siehe  Abbildung  7.7)  ersehen  kann,  liegen  die 
drei  Anschliisse  P20...P22  beim  ST  iiber  Pull-up-Widerstande  auf  High  (drei  “111”  ergibt 
Mode  7!).  Man  kann  beim  ST  jedoch  einen  anderen  Modus  einstellen,  indem  man  bei  einem 
RESET  des  ST  eine  oderbeideMaustasten  gedriickthalt.  Damit  “zieht”  man  denEingangP21 , 
P22  oder  beide  auf  Low-Pegel  und  setzt  im  Mode-Register  einen  Modus  von  1,  3  oder  5. 

Das  fiihrt  aber  nur  dazu,  daB  man  mit  der  Tastatur  und  der  Maus  nicht  mehr  arbeiten  kann,  da 
der  Tastaturprozessor  ja  von  Atari  als  Single-Chip- Anwendung  (Modus  7)  konzipiert  ist. 

Weil  Modus  5  und  7  nahezu  identisch  sind,  darf  man  jedoch  beim  Einschalten  seines  STs  ruhig 
die  linke  Maustaste  gedriickt  halten! 

Das  Gedachtnis  des  Tastaturchips 

Die  Funktionsblocke  RAM  und  ROM  brauchen  eigentlich  keine  weitere  Erlauterung.  Die  128 
Bytes  RAM  werden  bei  der  ST-Tastatur  fur  die  Zwischenspeicherung  von  Tastencodes  und 
Mausaktionen  sowie  fur  einige  Pointer,  den  Stack,  Uhrzeitdaten  usw.  benutzt.  Im  ROM  ist  das 
“Betriebssystem”  des  IKBD-Chips  untergebracht. 
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$0000 
» 

$00  IF 

’  nicht  benutzbar 


interne 

Register 


$0080 


$00FF 


nicht  benutzbar 


$F000 


$FFEE 

$FFF0 

$FFF2 

$FFF4 

$FFF6 

$FKF8 

$FFFA 

$FFFC 

$FFFE 


internes 
ROM 
(4  KBytes) 

TRAP-Int.  Vektor 
SCI-Inter.  Vektor 
TOF-Inter.  Vektor 
OCF-Inter.  Vektor 
iCF-Inter.  Vektor 
IRQ1-  Int.  Vektor 
Software  Inter. 
NMI-Inter.  Vektor 
RESET-Int.  Vektor 


internes 

RAM 

(128  Bytes) 


Memory  Map  des  6301  im  Mode  7  (Single-Chip-Modus) 


Wie  spat  ist  es? 

Der  Timer-Block  des  Tastaturprozessors  enthalt  einem  freilaufenden  16-Bit-Zahler.  Dieser 
Zahler  wird  mit  1/4  der  Systemtaktfrequenz  (das  entspricht  dem  Takt  des  E-Anschlusses) 
hochgezahlt.  Im  ST  arbeitet  der  6301  mit  4  MHz  Systemtakt,  so  da8  der  16-Bit-Zahler  des  Ti¬ 
mers  mit  1  MHz  gefahren  wird.  Der  Zahler  kann  jederzeit  ausgelesen  werden.  Ein  Beschrei- 
ben  mit  einem  neuen  Startwert  ist  ebenfalls  mbglich,  dabei  sind  jedoch  Doppel-Byte-Schreib- 
zugriffe  zu  verwenden  (16-Bit-Register!). 
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16  Bit-Free-Running-Counter  (FRC) 

Adr.  $0009  Adr.  $000A 

XXXXXXXX  XXXXXXXX 

High-Byte  Low-Byte 

Es  konnen  IRQ2~Interrupts  durch  den  Timer  ausgelost  werden,  sobald  ein  bestimmter  Zahler- 
stand  erreicht  ist  oder  sobaid  dieser  von  $FFFF  ->  $0000  zahlt  (Timer  Overflow).  Auch  durch 
ein  Triggerereignis  von  aufien  kann  der  augenblickliche  Zahlerstand  “eingefangen”  und  so  der 
Timer  fur  Zeitmessungen  benutzt  werden. 


16  Bit-Output-Compare-Register  (OCR) 

Adr.  $000B  Adr.  $OOOC 

XXXXXXXX  XXXXXXXX 

High-Byte  Low-Byte 

Erreicht  der  FRC  den  im  OCR  eingestell  ten  Wert,  kann  iiber  P2 1  ein  Ausgangsimpuls  abgege- 
ben  und  ein  Interrupt  ausgelost  werden. 


16  Bit-Input-Capture-Register  (ICR) 

Adr.  $000D  Adr.  $000E 

XXXXXXXX  XXXXXXXX 

High-Byte  Low-Byte 

Durch  Flankenwechsel  an  P20  kann  der  augenblickliche  FRC-Zahlerstand  im  ICR  “einge¬ 
fangen”  werden.  Gleichzeitig  kann  ein  Interrupt  ausgelost  werden. 


8  Bit-Timer-Control/Status-Register  (TCSR) 


L 


ICF  OCF  TOF  EICI  EOCI  ETOI  IEDG  OLVL 


Adr.  $0008 


ICF  (Input-Capture-Flag).  Gesetzt,  sobald  ein  entsprechend  dem  IEDG-Bit  eingestellter 
Flankenwechsel  stattgefunden  hat. 

OCF  (Output-Capture-Flag).  High,  sobald  Wert  im  OCR  mit  FRC  iibereinstimmt. 

TOF  (Timer-Overflow-Flag).  Gesetzt  bei  $FFFF  ->  $0000-l)bergang  des  Free-Running- 
Counters  (FRC). 
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EICI  (Enable-Input-Capture-Interrupt).  Bei  gesetztem  Bit  kann  eine  Interrupt-Anforde- 
rung  dutch  entsprechenden  Flankenwechsel  an  P20  ausgelost  werden. 

EOCl  (Enable-Output-Capture-Interrupt).  Freigabe  der  Interrupt- Anfordenmg  bei  Uber- 
einstimmung  von  OCR  und  FCR. 

ETOI  (Enable-Timer-Overflow-Interrupt).  Bei  gesetztem  Bit  wird  ein  Interrupt  bei  Timer 
Overflow  ($FFFF  ->  $0000-Obergang)  ausgelost. 

1EDG  (Input-Edge).BeigesetztemBiterfolgt“Input-Capture”(“Einfangendesaugenblick- 
lichenFRC-Wertes”)  bei  ansteigender  Flanke  anP20.  “Input-Capture”  auf  fallender 
Flanke  erfolgt  bei  geloschtem  Bit,  Der  P20-AnschluB  muB  natiirlich  als  Eingang  pro- 
grammiert  sein. 

OLVL  (Output-Level).  Tritt  “Output-Capture”  ein  (Ubereinstimmung  zwischen  OCR  und 
FRC),  wird  der  OLVL-Bit-Wert  am  Port  P21  priisentiert  (natiirlich  nur,  wenn  der 
P21-Port  als  Ausgang  programmiert  ist). 


Daten  im  Gansemarseh 

Der  SCI-Block  enthalt  das  sogenannte  Serial-Communications-Element,  die  serielle 
Schnittstelle  des  6301 .  Es  handelt  sich  hierbei  um  eine  Vollduplex-Schnittstelle,  mit  der  dem 
ST  die  Informationen  flber  betatigte  Tasten,  Mausbewegungen,  Mausclicks  und  Uhrzeit  iiber- 
mittelt  werden.  Das  Datenformat  betragt  dabei  acht  Datenbits  mit  einem  vorangestellten  Start- 
bit  und  zur  Signalisierung  des  Zeichenendes  ein  Stopbit. 

Es  gibt  auch  hier,  wie  schon  bei  den  ACIAs,  ein  Sende-  und  ein  Empfangsregister.  In  einem 
Rate/Mode  Control-Register  wird  die  Datenubertragungsrate  (im  ST  wird  mit  Systemtakt/5 12 
=  E/128  =  1  MHz/128  =  78 12,5  Bit/s  gearbeitet)  eingestellt  und  ausgewahlt,  ob  der  erforder- 
liche  Takt  von  einer  externen  Taktquelle  kommt  oder  intern  erzeugt  wird. 

Ein  Tx/Rx-Control-/Statusregister  gibt  Auskunft  iiber  evtl.  Fehler  bei  der  Datenubertragung 
und  ob  Daten  empfangen  wurden  und  zur  Weiterverarbeitung  ausgelesen  werden  sollen  oder 
ob  neue  Daten  ins  Senderegister  geschrieben  werden  konnen. 

Senderegister  Empfangsregister 

Adr.  $0013  Adr.  $0012 


xxxxxxxx 


xxxxxxxx 
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Transmit/Receive-Control  and  Status-Register  (TRCSR) 


RDRF 

ORFE 

TDRE  |  RIE 

RE 

TIE 

TE 

Adr.  $0011 


RDRF  (Receive-Data-Register-Full).  Gesetzt,  sobald  ein  empfangenes  Zeichen  aus  dem 
Empfangsregister  abgeholt  werden  kann. 

ORFE  (Over-Run-Framing-Error).  Gesetzt,  wenn  ein  Framing-Error  oder  ein  Uberlauf 
(empfangenes  Zeichen  wurde  nicht  rechtzeitig  aus  Empfangsregister  ausgelesen) 
aufgetreten  ist. 

TDRE  (Transmit-Data-Register-Empty).  Wird  gesetzt,  sobalddas  Senderegister“nachgela- 
den”  werden  kann. 


R1E  (Receive-Interrapt-Enable).  Durch  Setzen  dieses  Bits  wird  der  Empfanger-Interrupt 
freigegeben,  der  bei  RDRE=1  od.  ORFE=l  ausgelost  wird. 

RE  (Receiver-Enable).  Mit  Setzen  des  Bits  wird  Port  P23  zum  EmpfangsanschluB  des 
SCI.  Der  Empfangsteil  ist  eingeschaltet.  (Im  ST  realisiert.) 

TIE  (Transmit-Interrupt-Enable).  Bei  gesetztem  Bit  ist  der  Sender-Interrupt  freigegeben, 

der  bei  TDRE=1  ausgelost  wird. 

TE  (Transmit-Enable).  Mit  Setzen  dieses  Bits  wird  Port  P24  als  Senderausgang  geschal- 

tet.  Der  Sendeteil  des  SCI  ist  eingeschaltet.  (Im  ST  realisiert.) 

WU  (Wake-Up).  Wird  dieses  Bit  gesetzt,  so  werden  Empfangsdaten  so  lange  ignoriert, 
bis  zehn  1-Bits  empfangen  werden.  Mit  einer  Folge  von  zehn  1-Bits  wird  also  der 
Empfanger  erst  “aufgeweckt”. 


Rate-  and  Mode-Control-Register  (RMCR) 


1 

-  i  - !  cci 

ccoj 

[ssT 

sso| 

i 

0 

I 

0- 

0 

1_ 

1 

0- 

1 

1  - 

Adr.  $0010 
Baudrate  =  E/16 

■  Baudrate  =  E/128  (im  ST  verwendet) 
Baudrate  =  E/1024 
•  Baudrate  =  E/4096 
(E=l/4  des  Systemtakts) 


0  0  keine  Funktion 

0  1  intemer  Takt  (im  ST  verwendet) 

1  0  intemer  Takt  an  P22  herausgefiihrt 

1  1  extemer  Takt  von  P22 
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Die  Verbindung  zur  Aufienwelt 

Die  vier  Ports  mit  ihren  insgesamt  29  Portleitungen  werden  bei  der  “intelligenten  Tastatur” 
des  ST  iiberwiegend  benutzt,  urn  eine  Tastaturmatrix  zu  bilden  und  dann  “Kurzschltisse”  (Ta- 
stenbetatigungen)  in  dieser  Matrix  zu  entsprechenden  Tastaturcodes  umzuwandeln.  Maus- 
bewegungen  und  Joystick-Betatigungen  werden  ebenfalls  in  dieser  Matrixabfrage  beriick- 
sichtigt,  Lediglich  die  Fire  Buttons/Maustasten  sind  nicht  in  die  Matrix  eingebunden  und  wer¬ 
den  direkt  an  zwei  Ports  des  6301  abgefragt. 

Beim  6301  kann  im  Single-Chip-Mode  jeder  PortanschluB  individuell  als  Ein-  Oder  Ausgang 
programmiert  werden.  Dazu  existiert  fiir  jeden  Port  ein  Datenrichtungsregister  (Bit  auf  High 
=  zugehoriger  PortanschluB  ist  als  Ausgang  eingestellt). 


Port 

# 

Adresse 

Bitbelegung 

Bedeutung 

1 

$0002 

P17  P16  P15  P14  P13  P12  Pll  P10 

Port-Datenregister 

1 

$0000 

P17  P16  P15  P14  P13  P12  Pll  P10 

Datenrichtung 

2 

$0003 

PC2  PCI  PC0  P24  P23  P22  P21  P20 

Port-Datenregister 

2 

$0001 

P24  P23  P22  P21  P20 

Datenrichtung 

3 

$0006 

P37  P36  P35  P34  P33  P32  P31  P30 

Port-Datenregister 

3 

$0004 

P37  P36  P35  P34  P33  P32  P31  P30 

Datenrichtung 

4 

$0007 

P47  P46  P45  P44  P43  P42  P41  P40 

Port-Datenregister 

4 

$0005 

P47  P46  P45  P44  P43  P42  P41  P40 

Datenrichtung 

Eine  Sonderstellung  nimmt  der  Port  2  im  ST  ein.  Port  P23  ist  als  Empfangsport  fur  serielle 
Daten  geschaltet.  Die  serielle  Ausgabe  von  Daten  erfolgt  iiber  Port  P24.  Im  ST  sind  diese  bei- 
den  Ports  mit  den  TxDATA-  und  RxDATA-Anschliissen  des  Tastatur-ACIAs  verbunden. 
Immer  wenn  ein  Zeichen  von  der  Tastatur  vorliegt,  welches  dem  TOS  bekanntgemacht  wer¬ 
den  sollte,  wird  dieses  zum  Tastatur-ACIA  im  ST  gesendet.  Dieser  lost  einen  Interrupt  iiber 
Port  4  des  MFP  aus  und  informiert  so  das  Betriebssystem  iiber  das  Eintreffen  eines  Tastatur- 
zeichens. 

Port  P21  fragt  im  ST  die  linke  Maustaste  bzw.  den  Fire-Button  von  Joystick  #0  ab.  Die  rechte 
Maustaste  bzw.  Fire-Button  von  Joystick  #1  wird  iiber  Port  P22  erkannt.  Die  Tasten  schlieBen 
bei  Betatigung  einen  Kontakt  nach  Masse,  so  daB  bei  Betatigung  ein  Low  am  entsprechenden 
PortanschluB  anliegt. 
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Abb.  7.7;  Der  Anschlufi  der  intelligenten  Tastatur  an  den  ST 
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Und  so  funktioniert  die  Tastaturdekodierung: 

Der  T astaturprozessor  legt  nacheinander  an  jeden  Port  P3 1  ..P47  ein  Low-Signal.  Jede 
Spalte  der  Tastaturmatrix  bekommt  also  einmal  ein  Low  angeboten. 

-  Wird  eine  Taste  gedriickt,  gelangt  dieses  Low  an  einen  der  Portanschlusse  P10...P17, 
welche  als  Eingang  programmiert  sind.  Aus  der  Information,  welche  Spalte  gerade  ein 
Low  erhalt  und  welche  Zeile  dieses  Low  weitergibt,  kann  die  gedruckte  Taste  in  der 
Matrix  ermittelt  werden.  Der  entsprechende  Tastencode  (Make-Code)  wird  zum  Tasta- 
tur-ACIA  gesendet. 

Wenn  die  Taste  wieder  losgelassen  wird,  wird  fiir  die  Taste  ein  sogenannter  “Break- 
Code”  gesendet  (Break-Code  =  Make-Code  .or.  $80). 


Was  macht  die  Maus? 

Port  P20  ist  im  ST-Keyboard  als  Ausgang  programmiert.  Bei  jedem  Low  an  diesem  Portaus- 
gang  wird  iiber  den  8fach-Bustreiber  (74LS244,  siehe  Abbildung  7.7)  der  Zustand  der  Maus- 
bewegungssensoren  (oder  Richtungsinformationen  von  den  Joysticks)  an  die  als  Eingang  pro- 
grammierten  Ports  P40..P47  gelegt. 

Die  so  gelieferten  Daten  der  Mausbewegungssensoren  werden  mit  den  Daten  aus  der  letzten 
Mausabfrage  verglichen.  Aus  dem  Unterschied  zur  vorhergegangenen  Abfrage  wird  so  die 
Bewegungsrichtung  der  Maus  ermittelt.  Die  Richtungsinformation  von  den  Joysticks  (deren 
Richtungskontakte  schliefien  gegen  Masse)  wird  ebenfalls  iiber  Port  P40..P47  abgeffagt. 

Die  Tastatur  des  1 040  ST  unterscheidet  sich  ein  klein  wenig  von  der  Tastatur  der  260ST-  und 
520STM-Computer.  Zum  einen  wird  die  Verbindung  zu  den  beiden  Joystick-  und  Mausports 
nicht  iiber  eine  Steckverbindung  auf  der  Hauptplatine  hergestellt,  sondem  direkt  iiber  zwei 
getrennte  Verbindungsstecker.  Weiterhin  ist  eine  zusatzliche  Leuchtdiode  fiir  das  eingebaute 
Disklaufwerk  (Floppy-Select-Indicator)  vorhanden. 

Ebenso  unterscheidet  sich  die  Tastatur  der  MEGA-STs  ein  wenig  von  der  Tastatur  der  anderen 
STs.  Sie  ist  ja  nun  nicht  mehr  in  das  Gehause  des  Computers  eingebaut,  sondem  davon  abge- 
setzt  und  iiber  ein  flexibles  Spiralkabel  mit  der  Haupteinheit  verbunden. 

Wie  der  Schaltplanauszug  fiir  den  AnschluB  der  MEGA-ST-Tastatur  verdeutlicht,  werden 
auBer  den  Leitungen  fiir  die  Stromversorgung  (+5V  und  Masse)  nurnoch  die  TXD-  (Transmit 
Data)  und  RXD-Leitung  (Receive  Data)  benotigt.  Die  RESET-Leitung  zum  IKBD-Chip  ist 
entfallen.  Maus  und  Joysticks  werden  jetzt  an  der  abgesetzten  MEGA-ST-Tastatur  ange- 
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schlossen.  Durch  die  fehlende  RESET-Leitung  vom  ST  zum  IKBD-Chip  kann  man  nun  eine 
“abgestiirzte”  MEGA-Tastatur  nur  noch  durch  einen  Kaltstart  (Computer  ausschalten  -  etwas 
warten  -  Computer  wieder  einschalten)  zur  korrekten  Funktion  bewegen. 


+5G 

an  Tastatur 

GND 


ST  und  Tastatur 

CAnsicht  auf ) 
Cdie  Buchse  ] 


Abb.  7.8:  So  wird  die  Tastatur  an  den  MEGA-ST  angeschlossen 


Ein  flinkes  Tierchen  am  ST  -  Die  Maus 

Erwiihnt  wurde  sie  ja  schon  bei  der  Beschreibung  der  intelligenten  Tastatur  -  die  Maus.  Ohne 
sie  ware  das  Arbeiten  nur  halb  so  komfortabel  (besonders  bei  Zeichen-  und  CAD-ahnlichen 
Programmen). 

Die  Atari-Maus  arbeitet  nach  dem  opto-mechanischen  Prinzip.  Die  Bewegungsinformation 
wird  iiber  eine  Vollgummikugel  auf  zwei  in  Kugellagem  laufende  Walzen  iibertragen.  Die 
Walzenachsen  sind  rechtwinklig  zueinander  angeordnet.  Eine  Walze  wird  also  bei  Bewegung 
in  horizontaler  Richtung  (X-Richtung)  und  die  andere  bei  vertikaler  Bewegung  (Y-Richtung) 
angetrieben.  Auf  jeder  Walze  sitzt  nun  eine  Lochscheibe,  welche  bei  Bewegung  zyklisch  den 
Lichtstrom  zweier  Lichtschranken  unterbricht.  Die  beiden  Lichtschranken  sitzen  sich  auf  der 
Lochscheibe  genau  gegeniiber. 
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Abb.  7.9:  Die  optische  Abtastung  der  Bewegung  bei  der  Maus 


In  der  Lochscheibe  befindet  sich  aber  eine  ungerade  Zahl  von  Lochem,  so  dab  beide  Licht- 
schranken  nie  gleichzeitig  unterbrochen  werden.  Tastet  man  nun  die  Ausgange  der 
Lichtschranken  laufend  ab,  so  kann  aus  der  Information  welche  der  beiden  Schranken  einer 
Achse  zuerst  unterbrochen  wird,  die  Drehrichtung  der  Achse  erkannt  werden.  Die  Haufigkeit 
der  Lichtstrahl-Unterbreehungen  in  einem  Zeitintervall  ist  ein  Mab  fur  die  Geschwindigkeit 
der  Mausbewegung.  Mit  dieser  verhaltnismabig  einfachen  Mechanik  und  Elektronik  erzielt 
die  Atari-Maus  immerhin  eine  Auflosung  von  ca.  vier  Schritten/mm.  Bewegungsgeschwindig- 
keiten  bis  zu  250  mm/Sekunde  werden  nochkorrekt  erfabt.  In  Abbildung  7. 10  ist  die  Schaltung 
der  verhaltnismabig  einfachen  Mauselektronik  dargestellt.  Die  Versorgungsspannung  wird 
vom  ST  geliefert  und  ist  in  der  Maus  nochmals  extra  mit  Glattungselkos  gesiebt. 

Die  von  den  Fototransistoren  gelieferten  Impulse  werden  tiber  die  als  Schmitt-Trigger 
geschalteten  Komparator-Stufen  in  “vemiinftige”,  steilflankige  Rechteckimpulse  umgewan- 
delt,  mit  denen  der  IKBD-Chip  etwas  anfangen  kann. 

Als  einziges  “aktives”  Bauelement  (neben  den  LEDs  und  Fototransistoren)  findet  man  in  der 
Maus  nur  einen  4fach-Komparator  (Spannungsvergleicher)  des  Typs  “339”,  allerdings  in  sei¬ 
ner  “niedlichsten”  Form,  namlich  in  der  SMD-Atisfiihrung  (wie  iibrigens  auch  die  verwende- 
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Abb.  7.10:  Ohne  sie  lauft  am  ST  nicht  vie 1:  die  Maus 


ten  Widerstande!  Ja,  ganz  recht,  was  auf  der  Unterseite  der  Mausplatine  so  aussieht  wie  “Mau- 
sedreck”,  sind  die  SMD-Widerstande). 

(SMD  =  Surface-Mounted-Device  =  zu  deutsch  etwa:  direkt  mit  der  Platinenflache  verbun- 
denes  Bauelement;  SMDs  werden  ohne  AnschluBdrahte  direkt  auf  die  Platinenoberflache 
gelotet,  was  eine  sehr  kompakte  Bauform  ermoglicht.) 

In  Abbildung  7,11  sind  zur  Verdeutlichung  noch  die  Ausgangssignale  der  Komparatoren  auf- 
gefiihrt.  Man  erkennt  deutlich,  daB  bei  positiver  Bewegungsrichtung  der  XA-  (YA)-Ausgang 
eher  High  wird  als  der  XB-  (YB)-Ausgang.  Bei  negativer  Bewegungsrichtung  ist  es  dann 
genau  andersrum.  So  erkennt  der  Tastaturprozessor  dann  die  Bewegungsrichtung  der  Maus. 
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XA 

CVAl 


XB 

CVB3 


■4 —  posi  t  ive 


Richtung 


negative  Richtung 


Richtungs- 

mcchsel 


Abb.  7.11:  Die  Ausgangssignale  der  Mausbewegungssensoren 


Programmierung  des  IKBDs 

Der  IKBD-Chip  im  ST  kommuniziert  mit  seiner  Umwelt,  wie  bereits  weiter  vom  gesehen, 
fiber  eine  eigene  serielle  Schnittstelle  und  kann  darfiber  auch  Daten  empfangen. 

Kommandos  an  den  IKED  kann  man  sehr  leicht  mittels  der  XBios-Funktion  “Bcbdws”  fiber- 
tragen.  Mit  dem  Empfangen  der  Daten  ist  es  schon  erheblich  komplizierter.  Dazu  muB  man 
sich  zunacbst  mittels  der  XBios-Funktion  “Kbdvbase”  die  Adresse  der  Tabelle  der  IKBD- 
Routinen  besorgen.  Jenachdem,  obmanUhrzeit-,  Maus-,  Joystick-,  Tastatur-  oder  Statusinfor- 
mationen  abfragen  will,  muB  man  an  der  entsprechenden  Stelle  seine  eigene Empfangsroutine 
einsetzen.  Nur  so  ist  es  beispielsweise  moglich,  die  IBKD-Uhrzeit  im  1-Sekunden-Takt  abzu- 
fragen,  denn  XBios  wirft  bei  der  eigenen  Abfrage  jeweils  das  unterste  Bit  weg,  urn  auf  das  MS/ 
DOS-  und  GEMDOS-spezifische  Datumsformat  zu  kommen, 

Daten  werden  auf  zwei  verschiedene  Arten  empfangen.  Da  waren  zunachst  die  Meldungen 
fiber  das  Drucken  und  Loslassen  von  Tasten,  fur  die  die  Werte  0  bis  1 1 7  (+128  beim  Loslassen 
der  Taste)  reserviert  sind  (die  IKBD-eigenen  Codes,  auch  Scancodes  genannt,  frnden  Sie  im 
Anhang).  Weitere  Codes  leiten  jeweils  ein  sogenanntes  “Datenpaket”  ein,  das  mehrere  Bytes 
umfassen  und  verschiedenste  Informationen  enthalten  kann.  Nun  jedoch  zu  den  einzelnen 
IBKD-Funktionen: 


Reset  (IBKD  $80,  $01) 

Schaltet  den  IKBD-Chip  in  den  Anfangszustand  zurfick.  Dabei  geht  die  Uhrzeit  nicht  verloren 
(das  passiert  nur  bei  Unterbrechung  der  Stromzufuhr).  AuBerdem  wird  ein  Keyboard-Selbst- 
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test  durchgefiihrt,  dessen  Erfolg  durch  den  Wert  $F1  zuriickgemeldet  wlrd,  Dabei  wird  die 
angeschlossene  Tastatur  auf  Funktionstiichtigkeit  getestet.  So  wird  dann  fur  jeden  geschlos  - 
senenTastenkontaktangenommen,  dab  die  betreffende  Taste  defektist.  Fiiralle  solcheTasten 
wird  der  Break-Code  gesendet  (das  heiBt,  es  wird  ein  Loslassen  dieser  Taste  gemeldet) .  Dieser 
Selbsttest  wird  in  der  momentanen  Version  von  TOS  ignoriert. 

Set  mouse  button  action  (IKBD  $07,  Modus) 

Mitdiesem  Kommandokann  man  festlegen,  wie  die  beiden  Tasten  der  Maus  behandelt  werden 
sollen.  Dabei  kann  man  einerseits  die  Maustasten  wie  “Alt/Insert”  und  “Alt/ClrHome”  behan- 
deln  lassen  oder  festlegen,  ob  eine  Meldung  bei  Driicken  oder  Loslassen  der  Maustaste  gesen¬ 
det  werden  soil  (die  beiden  untersten  Bits  sind  nur  im  absoluten  Modus  relevant,  der  Standard- 
wert  fiir  Modus  ist  0): 

Modus  =  4:  Maustasten  wie  Tastatur  behandeln 
Modus  =  2:  Loslassen  der  Maustaste  melden 
Modus  =  1 :  Driicken  der  Maustaste  melden 

Set  relative  mouse  position  reporting  (IKBD  $08) 

Schaltet  den  relativen  Mausbewegungsmodus  ein,  der  auch  der  vom  AES  benutzte  Standard- 
modus  ist.  In  dieser  Betriebsart  wird  immer  dann  ein  Mausereignis  gemeldet,  wenn  die  Maus 
um  einen  mittels  “Set  mouse  threshold”  festlegbaren  Betrag  bewegt  oder  eine  der  Maustasten 
gedruckt  wurde.  Geliefert  werden  Status-Pakete  folgender  Form: 

typedef  struct 
{ 

har  header;  /*  0xF8  bis  OxFB  -  die  beiden  untersten  Bits 
geben  den  Status  der  Maustasten  an  */ 
char  dx,dy;  /*  Relative  Position,  zwischen  -128  und  127  */ 

}  RELMAUS; 

Sollte  der  Darstellungsbereich  von  -128  bis  1 27  fiir  die  erfolgte  Mausbewegung  nicht  ausrei- 
chen,  dann  wird  ein  weiteres  Paket  geschickt. 


Set  absolute  mouse  positioning  (IKBD  $09,  xmax,  ymax) 

Schaltet  auf  den  absoluten  Mausbewegungsmodus.  In  dieser  Betriebsart  meldet  der  IKBD,  der 
Mausposition  entsprechend,  absolute  Koordinaten.  Dazu  rnub  man  in  den  beiden  1 6-Bit- Wer- 
ten  xmax  und  ymax  die  Maximalzahl  fur  die  beiden  Koordinatenrichtungen  angeben.  Bewe- 
gungen  unterhalb  der  Nullposition  und  oberhalb  der  angegebenen  Grenzen  werden  ignoriert. 
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Set  mouse  keycode  mode  (IBRD  $A,  dx,  dy) 

In  dieser  Betriebsart  kann  man  mit  der  Maus  das  Driicken  der  Cursor-Tasten  emulieren  (das 
bietet  sich  bei  alien  TOS-Applikationen  mit  Cursor-Steuerung  an.  Aus  einem  biederen  Screen- 
Editor  wird  damit  ein  rasantes  Mausprogramm!).  Als  Parameter  muB  man  die  Anzahl  von 
horizontalen  bzw.  vertikalen  Koordinatenschritten  angeben,  die  je  einem  Tastendruck  ent- 
sprechen  sollten  (10  ist  dafiir  ein  brauchbarer  Wert). 

Set  mouse  threshold  (IKBD  $B,  x,  y) 

Setzt  die  Ansprechschwelle  fur  Mausbewegungen  fur  beide  Richtungen  separat  (nur  fur  den 
relativen  Modus  relevant).  Standardwertnach  RESET  ist  1. 

Set  mouse  scale  (IKBD  $C,  x,  y) 

Hiermit  kann  die  Maus-Skalierung  fur  beide  Richtungen  gesetzt  werden.  Man  legt  fest,  am 
wieviel  die  Maus  bewegt  werden  muB,  damit  die  IKBD-intemen  Positionszahler  urn  1  erhoht 
bzw.  vermindert  werden.  Dieser  Befehl  kann  nur  fiir  den  absoluten  Modus  benutzt  werden. 

Interrogate  mouse  position  (IKBD  $D) 

Im  absoluten  Modus  kann  hiermit  die  Position  der  Maus  abgeffagt  werden.  Der  IKBD  liefert 
ein  Statuspaket  folgenden  Formats  zuriick: 

typedef  struct 
{ 


char  header; 

/* 

0xF7  =  absolute  mouse  position  header  */ 

char  buttons; 

/* 

Status  der  Mausknopfe  */ 

int  x; 

/* 

X-Koordinate  */ 

int  y; 

/* 

Y-Koordinate  * / 

}  ABSMMJS; 

In  “buttons”  werden  die  untersten  vier  Bits  folgendermaBen  benutzt: 

Bit  0:  rechter  Knopf  seit  letzter  Abfrage  gedriickt 
Bit  1:  rechter  Knopf  seit  letzter  Abfrage  losgelassen 
Bit  2:  linker  Knopf  seit  letzter  Abfrage  gedriickt 
Bit  3:  linker  Knopf  seit  letzter  Abfrage  losgelassen 

Load  mouse  position  (IKBD,  $E,  $0,  x,  y) 

Im  absoluten  Modus  kann  man  mit  diesem  Kommando  die  intemen  Koordinaten-Zahler  des 
IBKD  setzen  (x  und  y  sind  16-Bit- Werte!). 
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Set  Y=0  at  bottom  (IKBD  $F) 

Setzt  die  Orientierung  der  Y-Achse  (Y  vermindert  sich,  wenn  die  Maus  vom  Anwender 
zuriickgezogen  wird). 

Set  Y=0  at  top  (IKBD  $10) 

Setzt  die  Orientierung  der  Y -Achse  auf  den  Standardized  (Y  erhohl  sich,  wenn  die  Maus  “nach 
unten”  gezogen  wird). 

Resume  (IKBD  $11) 

Mit  diesem  Kommando  kann  der  Datentransfer  vom  IKBD  wieder  gestartet  werden,  nachdem 
er  mittels  “Pause  output”  gestoppt  worden  war. 

Da  der  IKBD  sowieso  bei  Erhalt  eines  Kommandos  die  Datenubertragung  startet,  ist  “Re¬ 
sume”  eigentlich  nur  ein  NOP-Befehl  (No  Operation). 

Disable  mouse  (IKBD  $12) 

Schaltet  die  Mausabfrage  ab,  die  mit  “Set  relative  mouse  position  reporting",  “Set  absolute 
mouse  positioning”  oder  “Set  mouse  keycode  mode”  wieder  gestartet  werden  kann. 

Pause  output  (IKBD  $13) 

Stoppt  die  Datenubertragung  vom  IKBD  zum  ST,  bis  ein  neues  giiltiges  Kommando  (wie  zum 
Beispiel  “Resume”)  empfangen  wird.  So  weit  es  die  Buffer  im  IKBD  zulassen,  werden  alle 
Meldungen  gebuffert  und  dann  bei  der  Fortsetzung  der  Ubertragung  gesendet. 

Set  joystick  event  reporting  (IKBD  $14) 

Schaltet  den  Joystick-Ereignis-Modus  ein  (Standardeinstellung).  In  diesem  Modus  wird  je- 
desmal,  wenn  ein  Joystick-Kontakt  geoffnet  oder  geschlossen  wurde,  ein  entsprechendes  Sta- 
tuspaket  gesendet. 

typedef  struct 

{ 

char  header;  /*  SFE  Joystick  0,  $FF  Joystick  1  */ 

char  val;  /*  Bits  0-3  fur  die  vier  Bewegungsrichtungen, 

Bit  7  fur  den  Feuerknopf  */ 


}  JOYEVEN'T; 
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Set  joystick  interrogation  mode  (IKBD  $15) 

Schaltet  die  automatische  Meldung  von  Joystick-Ereignissen  ab.  In  diesem  Modus  muG  man 
fur  jede  Joystickabfrage  ein  spezieiles  Kommando  (“Joystick  Interrogation”)  senden. 

Joystick  interrogation  (IKBD  $16) 

Diese  Funktion  kann  in  beiden  Joy  stick- Abfrage-Modi  benutzt  werden  und  liefert  ein  Joy- 
stick-Statuspaket 

Set  joystick  monitoring  (IKBD  $17,  rate) 

In  diesem  Betriebsmodus  wird  in  bestimmten  Zeitabstanden  (berechnet  sich  zu  Rate/100  in 
Sekunden)  der  Status  der  Joysticks  gemeldet.  AUe  anderen  Aktivitaten  werden  gestoppt.  Die 
Statuspakete  von  zwei  Bytes  Lange  haben  folgende  Form: 

1.  Byte:  BitO:  Feuerknopf  Joystick  1 

Bit  1 :  Feuerknopf  Joystick  0 

2.  Byte:  Bit  0-3:  Richtungen  Joystick  1 

Bit  4-7 :  Richtungen  Joystick  2 

Set  fire  button  monitoring  (IKBD  $18) 

In  diesem  Modus  wird  permanent  der  Status  des  Feuerknopfs  von  Joystick  1  gemeldet.  Die 
Daten  werden  in  gepackter  Form  in  Bytes  gesendet  (also  immer  acht  Werte  innerhalb  eines 
Bytes),  Die  Abfragerate  ist  ungefahr  so  groG,  daB  in  derselben  Zeit,  in  der  auch  ein  Byte 
gesendet  wird,  wieder  acht  neue  Werte  abgefragt  werden.  Daher  sollte  man  die  ankommenden 
Bytes  moglichst  in  konstanten  Abstanden  abrufen. 

Set  joystick  keycode  mode  (IKBD  $19,  rx,  ry,  tx,  ty,  vx,  vy) 

In  diesem  Betriebsmodus  wird  mit  Joystick  0  (also  einem  Joystick,  der  im  Mausport  steckt) 
die  Cursor-Tastatur  emuliert.  Dabei  handelt  es  sich  bei  den  sechs  Parametern  urn  Zeitangaben 
in  1/10  Sekunden  fiir  die  beiden  Richtungen,  Mit  Schlieften  eines  Joystick-Kontakts  beginnt 
ein  intemer  Zahler  zu  laufen.  Die  Arbeitsweise  sei  an  folgendem  Beispiel  fiir  die  X-Richtung 
veranschaulicht  (r=6,  t=2,  v=l): 

Zeit  (1/10  sec)  Tastendruck 


0 

1 


(1)  <-  Intervalle  von  t/10 
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Zeit  (1/10  sec) 

Tastendruck 

2 

(2) 

3 

- 

4 

(3) 

5 

- 

6 

(4)  <-  Ablauf  von  r/10,  nun  lntervalle  von  v/10 

7 

(5) 

8 

(6) 

9 

(7) 

10 

(8) 

So  lafit  sich  sehr  leicht  eine  Autorepeat-Funktion  erreichen.  1st  dieser  Effekt  nicht  erwiinscht, 
dann  kann  man  “rx”  bzw.  “ry”  auf  0  setzen. 

Disable  joysticks  (IKBD  $1A) 

Joystickabfrage  beenden.  Sie  kann  mit  irgendeinem  giiltigen,  den  Joystick  betreffenden 
Kommando  wieder  in  Gang  gesetzt  werden. 

Time-of-day  clock  set  (IKBD  $1B,  jahr,  monat,  tag,  stunde,  minute,  sec) 

Setzt  die  Uhr  im  IKBD-Chip.  Jeder  der  sechs  Parameter  1st  eine  zweistellige,  gepackte  BCD- 
Zahl. 

Beispiel:  tag=31  fur  den  31.  eines  Monats 

Jeder  einzelne  Wert  wird  separat  auf  Plausibilitat  gepriift.  Gibt  man  beispielsweise  fur  den 
Monat  eine  13  an,  wird  das  Monatsfeld  nicht  geandert.  Akzeptiert  wird  dagegen  ein  Datum 
wie  der  30.02.1987! 

Interrogate  time-of-day  clock  (IKBD  $1C) 

Fragt  die  Uhrzeit  des  IKBD-Chips  ab.  Als  Resultat  wird  ein  Statuspaket  folgender  Art 
gesendet: 

typedef  struct 

{ 

char  header;  /*  $FC,  Uhrzeit-Statuspaket  */ 
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char  jahr; 
char  monat; 
char  tag; 
char  stunde; 
char  minute; 
char  sec; 

}  TIMEOFDAY; 


/*  Jahreszahl  in  gepackter  BCD-Form  */ 

/*  Monatszahl  in  gepackter  BCD-Form  */ 

/*  Tageszahl  in  gepackter  BCD-Form  */ 

/*  Stundenzahl  in  gepackter  BCD-Form  */ 
/*  Minutenzahl  in  gepackter  BCD-Form  */ 
/*  Sekundenzahl  in  gepackter  BCD-Form  */ 


Memory  load  (IKBD  $20,  adresse,  anzahl,  (daten)) 

Mit  dieser  Punktion  kann  man  das  RAM  des  IKBD  beschreiben  (der  RAM-Bereich  “erstreckt” 
sich  iiber  den  Bereich  von  $80  und  $FF).  Dazu  iibergibt  man  in  “adresse”  (16  Bit)  die  ge- 
wiinschte  Adresse  und  in  “anzahl”  die  Zahl  der  zu  ubertragenden  Bytes.  Es  folgen  dann  die 
einzelnen  Bytes,  wobei  der  Zeitabstand  zwischen  den  einzelnen  Datenbytes  maximal  20ms 
betragen  darf.  (Null-Bytes  konnen  wegen  eines  Fehlers  im  KBD-Betriebssystem  nicht  iiber- 
tragen  werden!) 

Memory  read  (IKBD  $21,  adresse) 

Mit  dieser  Funktion  kann  man  den  Speicher  des  IKBD  auslesen.  AIs  Parameter  iibergibt  man 
die  gewiinschte  Anfangsadresse  als  1 6-Bit-Wert,  Der  IKBD  liefert  daraufhin  folgendes  Daten- 
paket: 

typedef  struct 
{ 

char  headerl;  /*  $F6  -  Header  fur  Statuspakete  */ 

char  header2;  /*  $20  -  Header  fiir  Memory  read  */ 

char  data [6];  /*  6  Bytes  Speicherinhalt  ab  adresse  */ 

}  MElMEtEAD; 

Controller  execute  (IKBD  $22,  adresse) 

Startet  ein  Unterprogramm  (beginnend  bei  “adresse”,  16-Bit)  im  IKBD.  Um  diesen  Befehl  zu 
nutzen,  miiGte  mannatiirlich  das  Betriebssystem  des  IKBD  kennen  oder  selbst  ein  Programm 
in  den  “freien”  Speicher  iibertragen  haben... 


Status  inquiries  (IKBD  $87-$9A) 

Mit  Hilfe  der  Statusabfrage-Kommandos  kann  man  den  IKBD  auffordem,  jeweils  den  Status 
verschiedener  Betriebszustande  zuriickzumelden.  Das  Kommando  entspricht  jeweils  einem 
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der  betreffenden  SET-Komrnandos  mit  gesetztem  achten  Bit.  Als  Resultat  liefert  der  IKBD 
immer  ein  8-Byte-Paket  folgender  Form: 

typedef  struct 
{ 

char  header;  /*  0xf6  =  status  inquiry  header  */ 

char  vals[7];  /*  Funf  weitere  Werte  */ 

}  IKBDSTAT; 

Das  erste  Byte  dieser  Datenstruktur  ist  immer  das  Headerbyte  $F6.  Die  Bedeutung  der  restli- 
chen  sieben  Bytes  ist  fur  die  einzelnen  Abffage-Kommandos  jeweils  verschieden.  Sollten 
weniger  als  sieben  Bytes  belegt  sein,  dann  wird  mit  Nullen  aufgefiillt. 

Das  Statuspaket  ist  so  geformt,  da6  die  eingegangene  Statusmeldung  (unter  Weglassen  des 
Header-Bytes)  direkt  wieder  an  den  IKBD  geschickt  werden  kann.  Eventuell  abschliefiende 
Nullen  werden  dabei  vom  IKBD  ignoriert,  Im  folgenden  wird  jeweils  die  Belegung  des  vals[]- 
Arrays  angegeben. 

Request  mouse  button  action  (IKBD  $87) 

Fragt  den  Maustastenmodus  ab.  Liefert  { 7,  Modus,  0,  0, 0,  0, 0  } . 

Request  mouse  mode  (IKBD  $88,  IKBD  $89,  IKBD  $8A) 

Fragt  den  aktuellen  Mausbewegungsmodus  ab. 

Im  relativen  Modus:  {8, 0,0,0, 0,0,0} 

Im  absoluten  Modus:  (9,xmax  (MSB),xmax  (LSB),ymax  (MSB),ymax  (LSB),0,0} 

Im  Keycode-Modus:  { 10,dx,dy,0,0,0,0) 

Wie  man  sieht,  kann  man  die  sieben  Bytes,  die  man  nach  dem  Statusbyte  erhalt,  direkt  als 
Kommando  fiir  den  IKBD  “recyceln”. 


Request  mouse  threshold  (IKBD  $8B) 

Fragt  die  Ansprechschwelle  fiir  Mausbewegungen  im  relativen  Modus  ab.  Liefert 
{ ll,x,y,0,0,0,0). 

Request  mouse  scale  (IKBD  $8C) 

Fragt  die  Maus-Skalierung  ab.  Liefert  {12,x,y,0,0,0,0}. 
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Request  mouse  vertical  coordinates  (IKBD  $8F,  IKBD  $90) 

Liefert  {  15, 0, 0, 0, 0, 0, 0  }  fur  Y=0  am  unteren  Rand  und  (  16, 0, 0, 0, 0, 0, 0  )  fur  Y=0  am 
oberen  Rand. 

Request  mouse  availability  (IKBD  $92) 

Liefert  {  0,  0,  0,  0, 0,  0, 0  }  bei  eingeschalteter  Maus  und  sonst  (  18,0,  0,  0,  0,  0, 0  ) . 

Request  joystick  mode  (IKBD  $94,  IKBD  $95,  IKBD  $99) 

Fragt  den  aktuellen  Joystick-Modus  ab.  Liefert  [20,0,0,0,0,0,0}  fur  den  normalen  Modus 
(“event  reporting”),  {21,0,0,0,0,0,0}  fur  den  Nachfrage-Modus  (“joystick  interrogation 
mode”)  oder  {25,rx,ry,tx,ty,vx,vy }  fur  den  Keycode-Modus. 

Request  joystick  availability  (IKBD  $9 A) 

Liefert  {0,0, 0,0, 0,0,0}  bei  eingeschalteter  Joystick-Abfrage  und  sonst  (26,0,0,0,0,0,0). 

Wer  sich  genauer  mit  dem  Innenleben  des  Tastaturprozessors  auseinandersetzen  will,  sei  auf 
die  Artikelserie  “Licht  in  die  Geheimnisse  des  Tatstaturprozessors”  in  der  ST-Computer  3/ 
90.. 5/90  hingewiesen.  Beim  Autor  Sieghard  Schafer  (Hallo  Sieghard!  Hat  mir  gut  gefallen  die 
Serie)  kann  man  auch  ein  disassembliertes  und  kommentiertes  Listing  vom  IKBD-Betriebs- 
system  erhalten. 
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Kapitel  8:  Das  Floppy-Disk-Interface 


Die  ATARI  ST-Computer  haben  alle  notige  Hardware  zur  Steuerung  von  Floppy -Disk- 
Laufwerken  bereits  im  Grundgerat  integriert.  Bei  den  Computem  des  Typs  ATARI  1040STF 
und  den  MEGA  STs  ist  auBerdem  ein  Disklaufwerk  eingebaut. 

SerienmaBig  werden  von  ATARI  fiir  die  ST-Computer  3,5-Zoll-DiskIaufwerke  verwendet. 
Diese  Laufwerke  ermoglichen  heute  eine  Speiclierkapazitat  von  mindestens  720  KByte  je 
Disk  bei  einer  kleinen,  kompakten  und  gegen  auBere  Einfliisse  relativ  gut  geschiitzten 
Bauform  (unbeabsichtigtes  Verknicken  und  Verschmutzen  und  Beschadigungen  durch  knab- 
bemde  Wellensittiche  und  Kanarienvogel  werden  wirkungsvoll  verhindert.) 

Fiir  die  Computer  der  ST-Serie  wird  inzwischen  nur  noch  das  zweiseitige  Disklaufwerk 
angeboten.  Zur  Datenspeicherung  wird  die  Vorder-  und  Riickseite  der  Diskette  verwendet.  Die 
Daten  werden  hierbei  in  80  Spuren  (Tracks)  auf  der  Diskette  verstreut.  Jede  Spur  ist  in  neun 
Sektoren  mit  je  512  Bytes  Datenkapazitat  aufgeteilt. 


Die  Datenspeicherung  auf  Diskette 

Die  auf  einer  Disk  gespeicherten  Informationen  sind  eine  Aneinanderreihung  von  in  verschie- 
denen  Richtungen  magnetisierten  Partikeln  in  der  Magnetschicht  der  Diskette.  Man  kann  sich 
das  als  eine  Aneinanderreihung  von  winzig  kleinen  “Stabmagneten”  vorstellen,  diekreisformig 
in  einer  Spur  auf  der  Diskette  Pol  an  Pol  liegen. 

Eine  solche  Spur  dreht  nun  mit  300  Umdrehungen/Minute  unter  dem  Schreib-/Lesekopf  des 
Disklaufwerks.  Die  unter  dem  Kopf  vorbeirotierenden  “Stabmagnete”  bewirken,  abhangig 
von  ihrer  Magnetisierungsrichtung,  in  dem  Kopf  Magnetfeldschwankungen,  welche  zu 
Stromschwankungen  fiihren,  die  dann  von  der  Lese-Elektronik  ausgewertet  werden  konnen. 
Die  Lese-Elektronik  im  Laufwerk  wandelt  diese  Stromschwankungen  in  einen  seriellen  Bit- 
strom  um,  der  zum  ST  gesendet  wird.  So  werden  Informationen  von  Diskette  gelesen.  Beim 
Beschreiben  von  Disketten  geht  man  den  umgekehrten  Weg: 

Ein  serieller  Bitstrom  vom  ST  wird  durch  die  Schreib-Elektronik  im  Laufwerk  in  gezielte 
Stromanderungen  fiir  den  Schreib-/Lesekopf  umgewandelt. 

Die  durch  die  Stromanderungen  hervorgerufenen  Magnetfeldschwankungen  magnetisieren 
die  Magnetschicht  (die  kleinen  Stabmagnete)  auf  der  Disk  in  die  gewiinschte  Richtung  und 
legen  so  die  Informationen  dauerhaft  dort  ab.  Dauerhaft  aber  nur  so  lange,  bis  man  die  Diskette 
mit  dem  gerade  fertigprogrammierten  Superutility  nachts  um  zwei  Uhr  erschopft  auf  die 
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gestem  neu  erworbenen  Autolautsprecher  mit  den  neuen  extra  starken  Permanentmagneten 
legt,  die  man  am  Wochenende  unbedingt  noch  einbauen  will. 

Wahrscheinlich  werden  die  kleinen  Stabmagnete  auf  der  Disk  dann  wohlgeordnet  in  einer 
Richtung  angeordnet  sein.  Namlich  in  jene,  in  die  sie  durch  das  auBere  Magnetfeld  der  Laut- 
sprechermagnete  gequetscht  wurden. 

Kurzum,  den  gleichen  Effekt  hatte  man  auch  durch  Formatieren  der  Disk  erreicht,  die  Daten 
(und  damit  das  Superutility)  sind  futsch!  Also  Vorsicht  vor  fremden  Magnetfeldern! 


Prazision  1st  gefragt 

Wer  schon  mal  den  Metallschuber  der  3,5-Zoll-Diskette  vorsichtig  beiseite  geschoben  hat 
(Achtung  bei  umherfliegenden  Kanarienvdgeln  und  Wellensittichen,  sie  lassen  meistin  dem 
Moment  etwas  hinter  sich,  in  dem  man  es  nicht  erwartet,  und  treffen  dann  auch  noch  genau!), 
wird  den  ca.  10  x  24  mm2  grofien  Ausschnitt  in  der  Diskettenhiille  gesehen  haben. 

In  diesem  kleinen  Ausschnitt  bewegt  sich  der  Schreib-/Lesekopf  des  Laufwerks  vom  AuBen- 
rand  der  Disk  zur  Mitte  und  wieder  zuriick,  um  die  richtige  Spur  mit  den  Daten  zu  finden! 

Wie  schon  kurz  erwahnt,  sind  auf  einer  solchen  Disk  80  Spuren  vorhanden,  die  der  Kopf 
“anfahren”  konnen  muB  (auch  wenn  man  mit  manchen  Laufwerken  mehr  als  80  Spuren  ansteu- 
em  kann;  Atari  garantiert  fiir  seine  Drives  nur  maximal  80  Spuren !).  Diese  80  Spuren  verteilen 
sich  auf  eine  S  panne  von  ca.  1 5  mm .  Eine  Spur  ist  also  nur  ca.  0, 1 9  mm  breit !  Man  sieht  daran, 
mit  welch  einer  Prazision  die  Mechanik  einer  solchen  Diskstation  arbeiten  muB. 

Der  Schrei b -/Lcsekopf  wird  auf  einem  sogenannten  Kopfschlitten  gefiihrt.  Die  Positionierung 
des  Schlittens  erfolgt  durch  einen  Schrittmotor,  welcher  den  Kopfschlitten  Schritt  fur  Schritt 
hin  und  her  bewegen  kann.  Der  Wechsel  von  einer  Spur  zur  benachbarten  Spur  geschieht  bei 
den  3,5-Zoll-Laufwerken  iiblicherweise  in  nur  3  Millisekunden! 

Die  Spuren  auf  der  Diskette  werden  von  auBen  nach  innen  durchnumeriert.  Die  auBere  Spur 
hat  die  Nummer  0,  die  innerste  Spur  tragt  die  Nummer  79.  Jede  Spur  enthalt  ca.  6250  Bytes 
an  Informationen. 


Und  wo  fangt  man  an?  -  Der  Indeximpuls 

Fiir  die  Anfangsmarkierung  einer  Spur  (wo  fangt  ein  Kreis  an?)  sorgt  der  sogenannte 
Indeximpuls.  Er  wird  einmal  pro  Umdrehung  an  immer  der  gleichen  Stelle  der  Spur  vom 
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Laufwerk  erzeugt.  Das  geschieht  durch  Abtastung  mittels  eines  Sensors  am  Antriebselement 
des  Disklaufwerks. 

Die  neun  Sektoren/Spur  (9x512  =  4608  Bytes)  werden  von  1..9  durchnumeriert  und  sind  in 
den  moglichen  6250  Bytes  eines  Tracks  eingebettet.  “Umrahmt”  werden  die  neun  jeweils  512 
Bytes  langen  Sektoren  einer  Spur  von  Synchronisations-und  Informationsby  tesfiir  Spumumtner, 
Sektornummer,  Priifsummen  usw. 


Struktur  ist  wichtig!  -  Das  Track-Layout  der  ST-Floppies 

Die  auf  Disk  abzulegenden  Daten  werden  in  Blocken  zu  512  Bytes  (Sektoren)  angeordnet. 
Damit  der  FDC  (das  ist  der  Floppy-Disk-Controller;  er  ist  der  Dolmetscher  zwischen  CPU  und 
Laufwerken)  jedoch  weifi,  iiber  welcher  Stelle  auf  der  Diskette  sich  der  Kopf  gerade  befindet, 
ist  es  erforderlich,  eine  bestimmte  Struktur  auf  die  Diskette  aufzubringen.  Es  sind  Markierun- 
gen  (Nachgucken  lohnt  auch  mit  Lupe  nicht,  markiert  wird  magnetisch!)  erforderlich,  aus  de- 
nen  zu  erkennen  ist,  wo  eine  Spur  beginnt,  iiber  welcher  Spur  (Track)  sich  der  Kopf  gerade 
befindet,  welcher  Sektor  gerade  vorbeirotiert,  wo  die  Daten  im  Sektor  anfangen  bzw.  aufhoren 
usw. 

Das  beim  ATARI  ST  verwendete  Tracklayout  ist  in  Abbildung  8.1  zur  besseren  Ubersicht 
schematisch  dargestellt. 

Ein  Track  beginnt  mit  60  Bytes  $4E,  welche  dem  Datenseparator  (der  sitzt  im  FDC  und  broselt 
den  vom  Laufwerk  eintreffenden  Bitstrom  in  Daten-  und  Taktinformationen  auf)  im  FDC  dazu 
dienen,  sich  auf  den  einlaufenden  Bitstrom  vom  Laufwerk  zu  synchronisieren.  Das  mit  dem 
Synchronisierenist  eine  aufwendige  Sache,  denn  der  Bitstrom  kommt  natiirlichmit  Geschwin- 
digkeitsschwankungen  daher.  Die  Disk  rotiert  ja  auch  nicht  immer  mit  konstanter  Geschwin- 
digkeit!) 

Jeder  Sektorbeginn  wird  durch  12  Bytes  $00,  gefolgt  von  3  Bytes  $A1  (mit  fehlenden 
Taktimpulsen,  deshalb  fur  den  FDC  besonders  auffallig!),  angekiindigt.  Es  folgt  ein  Byte  mit 
$FE  (ID- Address  Mark),  welches  dem  FDC  den  Beginn  eines  Sektor-Headers  signalisiert. 

Dieser  Sektor-Header  enthalt  je  ein  Byte  fur  die  Spumummer  ($00. .  .$4F),  Seitennummer  ($00 
Oder  $01),  Sektornummer  ($01...$09)  und  ein  Byte  fur  die  SektorgrdBe  ($02  weist  auf  512 
By  tes/Sektor  hin).  Danach  folgen  zwei  Bytes  mit  einer  Priifsumme  iiber  die  vorangegangenen 
4  Bytes  des  Sektor-Headers. 

AnschlieBend  wird  der  Datenseparator  des  FDC  wieder  mit  22  Bytes  $4E  und  12  mal  $00  zur 
Synchronisation  gefiittert. 
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Abb.  8.1:  Das  Track-Layout  beim  ST 


Drei  Bytes  $A1  (mit  fehlenden  Taktimpulsen),  gefolgt  von  einem  $FB  (die  “Data-address- 
mark”,  kurz:  DAM),  leiten  dann  die  eigentlichen  512  Datenbytes  des  Sektors  ein.  Diesen  folgt 
natiirlich  wieder  eine  Priifsumme  in  Form  zweier  CRC-Bytes  (CRC  =  Cyclic  Redundancy 


Uiederholt  sich  for  j eden  Sektor  C614  Bytes] 
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Checking,  zu  deutsch  etwa:  zyklische  Blockpriifung.  Ein  Datenblock  wird  einer  laufenden 
Priifzeichenbildung  unterzogen.  Die  gewonnene  Priifinformation  wird  vom  FDC  als  2  x  8  Bit- 
Wert  abgelegt.). 

Bis  zu  Beginn  des  nachsten  Sektors  folgen  dann  40  Bytes  mit  $4E  (damit  der  FDC  nicht  aus 
dem  Tritt  kommt).  Dieses  Raster  wird  bei  der  Formatierung  einer  Diskette  aufgebracht.  Hieran 
lalit  sich  erkennen,  daB  so  ein  FDC  eine  Menge  Dekodierarbeit  zu  leisten  hat,  bevor  dann 
endlich  die  “reinen”  Datenbytes  zur  Verfugung  stehen. 

1st  die  Diskette  jedoch  erstmal  auf  diese  Weise  formatiert,  erfolgen  alle  weiteren  Zugriffe  nur 
noch  im  Sektorformat.  Die  Markierungen  und  Liickenbytes  auf  der  Disk  werden  ebenso  wie 
der  Sektor-Header  nun  nicht  mehr  angetastet. 

Das  Datenfeld  eines  Sektors  wird  vielfach  wieder  geandert,  wobei  eine  Modifizierung  immer 
ein  komplettes  Neubeschreiben  des  entsprechenden  Sektors  mit  den  geanderten  Daten  erfor- 
dert.  Die  CRC-Bytes  nach  jedem  Datenfeld  werden  natiirlich  bei  Veranderungen  von  Daten¬ 
bytes  im  Sektor  ebenfalls  jedesmal  neu  berechnet  und  geschrieben. 


Alles  unter  Kontrolle!?  -  Was  der  Floppy-Controller 
konnen  muB 

Fur  den  Datenaustausch  von  Daten  zwischen  Computer  und  Diskstation  sind  eine  Vielzahl  von 
Funktionen  auszufiihren  und  Kontrollsignale  vom  Laufwerk  zu  iiberwachen. 

Urn  die  CPU  von  dieser  Arbeit  ffeizuhalten,  werden  die  Floppy-Disk-Controller  (FDC)  ein- 
gesetzt.  Diese  hochintegrierten  B  austeine  sind  speziell  fiir  die  Ansteuerung  von  Disklaufwerken 
entwickelte  Chips.  Sie  sind  selbst  Mikrocomputer,  die  jedoch  nur  Disklaufwerke  steuem  kon- 
nen.  Diese  Aufgabe  beherrschen  sie  dafiir  aber  meisterhaft.  Um  zu  sehen,  was  ein  solcher 
Floppy-Disk-Controller  alles  konnen  muB,  werfen  wir  mal  einen  Blick  auf  die  Anschliisse,  die 
ein  Disklaufwerk  so  aufweist. 

Zum  Gliick  (oder  sollten  da  die  Hersteller  etwa  voneinander  abgekupfert  haben?)  hat  sich  bei 
den  Anschliissen  fiir  die  Disklaufwerke  bei  alien  Herstellem  so  eine  Art  AnschluB-Norm 
durchgesetzt.  Aufier  den  normalen  Anschliissen  fiir  die  Stromversorgung  des  Laufwerks 
(+12V,+5Vund  Masse;  esgibtauchbereitsLaufwerke.diemitnureinerVersorgungsspannung 
von  5  Volt  arbeiten),  gibtes  fiir  die  Daten-  und  Steuerleitungendensogenannten  Shugart-Bus. 

Hierbei  handelt  es  sich  um  eine  34pol.  Flachbandkabel-Verbindung  iiber  Pfostenfeld-Steck- 
verbinder  (dies  gilt  fiir  3,5  Zoll-Laufwerke,  bei  5,25-Zoll-Laufwerken  findet  man  eine  Steck- 
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verbindung,  die  direkt  auf  die  Laufwerksplatine  gesteckt  wird).  Am  3,5-Zoll-Laufwerk  befin- 
det  sich  dabei  die  Stiftleiste,  folglich  sitzt  am  Anschluflkabel  diezugehorige  34pol.  Buchsenleiste. 
Wie  Abbildung  8.2  zeigt,  sind  jedoch  nicht  alle  34  Anschliisse  mit  verschiedenen  Signalen  be- 
legl.  Zur  Unterdriickung  von  Storimpulsen  ist  fast  jede  zweite  Leitung  auf  Masse  gelegt. 


34  33 


So  sieht  die  ftufsicht 
auf  den  Sfeckverbinder 
zun  Disklaufwerk  aus! 
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-  Motor  on  ■ 
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Abb.  8.2:  So  sieht  der  normale  Shugart-Bus  fur  3,5-ZolI-Laufiverke  aus 


Weiterhin  gibt  es  keine  Leitungen  fiir  beide  Signalrichtungen.  Jedes  Signal  wirkt  immer  nur 
in  eine  Richtung,  entweder  vom  FDC  zum  Laufwerk  oder  vom  Laufwerk  zum  FDC.  Hier  nun 
eine  kurze  Beschreibung  der  Anschliisse,  beginnend  mit  den  12  Signalleitungen  vom  FDC 
zum  Laufwerk. 

Density*  (Pin  2)  Im  ST  nicht  benutzt  (im  TT  und  Mega  STE  schon) !  Die  modemen 

High-Density-Laufwerke  weisen  diesen  AnschluB  auf  (mit  HD- 
Laufwerken  und  speziellen  HD-Disketten  kann  man  durch  Erho- 
hung  der  Taktrate  zum  Lesen/Schreiben  18  Sektoren/Spur  unter- 
bringen.  Damit  ergibtsich  eine  Speicherkapazitat  von  1 ,44  MByte!). 
Verwendet  wird  der  AnschluB,  je  nach  Jumpereinstellung  auf  dem 
Laufwerk,  als  Eingang  Oder  Ausgang. 
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Als  Ausgang:  Das  Laufwerk  signalisiert  dabei  fiber  den  AnschluG 
dem  Computer,  welche  Art  von  Disk  eingelegtist.  HD-Disks  wer- 
den  dabei  durch  eine  zusatzliehe  Offnung  in  der  Diskhulle  er- 
kannt!  Welcher  Logikpegel  fur  die  Signalisierung  von  HD-Be- 
trieb  verwendet  wird,  laBt  sich  ebenfalls  fiber  Jumper  am  Laufwerk 
einstellen. 

Als  Eingang\  In  dieser  Betriebsart  “sagt”  der  Computer,  welche 
Betriebsart  das  Laufwerk  einzustellen  hat.  Bei  welchem  Logikpegel 
HD-Betrieb  “gewfinscht’  ’  wird,  ist  wieder  fiber  Jumper  konfigurier- 
bar! 

Head  load  (Pin  4)  ImSTnichtbenutztIEinLowsignalisiertderLaufwerkselektronik 

“Kopf  ab”,  d.  h.,  der  Schreib-/Lesekopf  soli  auf  die  Disk  abge- 
senkt  werden.  Bei  5,25-Zoll-Drives  wird  dieser  AnschluG  noch 
manchmal  benutzt,  wahrend  erbei  3,5-Zoll-Laufwerken  seltener 
anzutreffen  ist.  Hat  man  ein  Laufwerk  mit  “Head  load”  anzuschlie- 
fien,  so  kann  man  den  AnschluG  mit  dem  “Motor  on”-Anschlu6 
verbinden!  So  wird  “Head  load”  aktiviert,  sobald  der  Motor  ge- 
startet  wird.  Beim  Ansprechen  von  Drives  mit  “Head  load”  sollten 
FDC-Kommandos  mit  gesetztem  E-Bit  gegeben  werden,  urn  dem 
Laufwerk  Zeit  zu  geben,  den  Kopf  abzusenken. 

Drive  sel.  A..D  (Pin  10,12,14,6) 

Uber  diese  Signalleitungen  bekommt  die  Laufwerkselektronik 
mitgeteilt,  welches  Laufwerk  gerade  angesteuert  wird.  Das  Signal 
ist  Low-aktiv,  d.  h.,  ein  Low-Pegel  auf  der  entsprechenden  Lei- 
tung  wahlt  das  gewunschte  Laufwerk  an.  Atari  benutzt  nur  Drive 
select  A  und  B! 

Side  select  (Pin  32)  Bei  High-Pegel  wird  auf  Seite  0  (Vorderseite)  der  Disk  gearbeitet. 

Sobald  hier  Low  anliegt,  bekommt  der  Schreib-/Lesekopf  auf  der 
Seite  1  (Ruckseite)  Arbeit. 

Motor  on  (Pin  1 6)  Ein  Low-Pegel  startet  den  Motor  (immer!  Egal,  ob  das  Laufwerk 

selektiert  ist  oder  nicht!) 

Write  gate  (Pin  24)  Signalisierung  an  die  Laufwerkselektronik: 


High:  Daten  werden  gelesen. 

Low  :  Daten  werden  geschrieben. 


952 


ATARI  Profibuch 


Write  Data  (Pin  22)  Der  FDC  sendet  iiber  diese  Leitung  die  zu  speichemden  Daten  in 
einem  seriellen  Bitstrom.  Die  Laufwerkselektronik  setzt  diesen 
Datenstrom  in  entsprechende  Magnetfeldschwankungen  im 
Schreib-/Lesekopf  um. 

Step  direction  (Pin  1 8)  Die  Richtung,  in  welcher  der  Kopf  bewegt  werden  soil,  wird  hier- 
mit  festgelegt. 

High:  Schrittbewegung  nach  auBen  (niedrigere  Spumummer) 
Low  :  Der  Kopf  soil  naeh  innen  (hohere  Spumummer) 

Die  eigentliche  Schrittbewegung  wird  jedoch  erst  durch  das  Si¬ 
gnal  “Step”  ausgelost! 

Step  (Pin  20)  Jeder  Low-Impuls  bewegt  den  Kopf  einen  Schritt  in  die  durch 

“Step  direction”  vorgewahlte  Richtung. 

Nun  zu  den  Signalen,  die  vom  Laufwerk  an  den  FDC  gerichtet  sind: 

Write  protect  (Pin  28)  Ein  High  signalisiert  dem  FDC,  daB  die  Diskette  beschrieben  wer¬ 
den  kann.  Bei  Low  ist  das  Sehreiben  auf  Disk  gesperrt.  Fur  die 
Signalisierung  wird  das  Write  protect-Fenster  in  der  Diskette 
durch  eine  Lichtschranke  abgefragt. 

Track  00  (Pin  26)  Wenn  der  Kopf  auf  Spur  00  positioniert  ist,  geht  dieses  Signal  auf 

Low-Pegel.  Sonst  liegt  hier  High. 

Index  (Pin  8)  Bei  jeder  Diskettenumdrehung  wird  ein  kurzer  Low-Impuls  er- 

zeugt.  Dies  geschieht  immer  an  der  gleichen  Stelle  einer  Umdre- 
hung  und  dient  zur  Markierung  des  Spuranfangs. 

Read  Data  (Pin  30)  Beim  Lesen  von  Daten  (‘.‘Write  gate”  auf  High)  liefert  die  Lauf¬ 
werkselektronik  an  diesem  AnschluB  einen  Bitstrom  mit  Daten 
von  der  Diskette.  Fur  die  Entwirrung  dieses  Datenstroms,  der  Da¬ 
ten-  und  Taktinformationen  enthalt,  und  die  Umsetzung  in  Daten- 
bytes  ist  der  FDC  zustandig.  Der  Bitstrom  ist  durch  Drehzahl- 
schwankungen  des  Diskantriebs  nicht  immer  gleichmaBig,  son- 
dem  unterliegt  Schwankungen,  die  der  FDC  bei  der  Decodierung 
beriicksichtigen  muB. 


Ready  (Pin  34) 


HierUber  wird  dem  FDC  mit  einem  Low  signalisiert,  daB  das 
angesprochene  Laufwerk  bereit  zur  Arbeit  ist.  Das  ist  dann  der 
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Fall,  wenn  eine  Disk  eingelegt  ist.  Deshalb  wird  das  Ready-Signal 
auch  verschiedentlich  fur  die  Diskwechsel-Erkennung  benutzt. 
Beim  ST  wird  der  AnschluB  jedoeh  nicht  verwendet. 

Diirfen’s  ein  paar  Leitungen  weniger  sein? 

Die  Konstrukteure  des  ST  waren  wohl  der  Meinung,  daft  34  Leitungen  viel  zuviel  sind. 
Aufterdem  sorgt  ein  “eigenes”  Steckerformat  dafiir,  daft  bevorzugt  die  von  Atari  produzierten 
Diskstationen  verkauft  werden.  Wohl  deshalb  werden  die  Diskstationen  an  den  ST  iiber  ein 
14pol.  Anschluftkabel  mit  einem  14pol.  Stecker  in  der  Form  der  heute  iiblichen  DIN-Stecker 
angeschlossen. 

Beim  Offnen  eines  originalen  Atari-Laufwerks  stellt  man  dann  jedoeh  fest,  das  im  Gehause 
der  Diskstation  wieder  eine  Umsetzung  vom  Atari-Steckerformat  auf  den  gebrauchlichen 
34poligen  Steckanschluft  erfolgt.  Die  Abbildung  8.3  zeigtden  AnschluB  von  zweiLaufwerken 
mit  der  Umsetzung  vom  14poligen  Atari-Disksteckerformat  auf  den  34poligen  Shugart-Bus 
im  Detail. 

Die  ST-Computer  sind  vom  Betriebssystem  herdarauf  ausgelegt,  zwei  Diskettenlaufwerke  zu 
steuem. 

Die  erste  Diskstation  (im  Desktop  das  Laufwerk  A)  wird  direkt  am  ST  angeschlossen  bzw.  ist 
bereits  eingebaut.  Die  zweite  Station  (Laufwerk  B)  wird  an  der  “Out”-Buchse  der  ersten  Disk- 
station,  ebenfalls  mit  14pol.  Steckverbinder,  angeschlossen.  Beim  ATARI  1040  STF,  STE, 
TT  und  MEGA  ST(E)  ist  fur  das  zweite  Laufwerk  (extemes  Laufwerk)  an  der  Riickseite  des 
ST  eine  Buchse  vorgesehen. 

Beim  Betrieb  von  mehr  als  einem  Laufwerk  an  einem  FDC  wird  jedem  Laufwerk  eine  eigene 
Identifikation  zugeordnet.  Dies  geschieht  auf  der  Laufwerksplatine  durch  entsprechendes 
Einstellen  von  DEP-Schaltem  oder  das  Versetzen  von  Steckbriicken  (Jumpem).  Damit  ist 
gewahrleistet,  daft  sich  Laufwerk  A  auch  nur  dann  angesprochen  fiihlt,  wenn  es  durch  Low 
am  “Drive  select  A!’-Anschluft  angesteuert  wird.  Laufwerk  B  darf  nur  reagieren,  wenn  es  am 
“Drive  select  B”-Anschluft  ein  Low  erhalt,  usw. 

Atari  fiihrt  jedoeh  die  “Drive  select  B”-Leitung  vom  Computer  iiber  die  “In”-Buchse  (An¬ 
schluB  6)  auf  den  “Drive  select  A”- AnschluB  (AnschluB  5)  der  “Out”-Buchse  der  Diskstation! 
Eine  dort  angeschlossene  zweite  Diskstation  fiihlt  sich  sornit  dann  “auserwahlt”,  wenn  “Drive 
select  B”  vom  ST  auf  Low  gesetzt  wird. 

Das  hat  den  Vorteil,  daB  keine  Einstellarbeiten  an  der  Diskstation  notig  sind,  weil  alle  Statio- 
nen  als  “Drive  A”  programmiert  werden  konnen  (sie  werden  von  ihrer  “LC-Buclise  iiber 
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Dieses  Prinzip  hat  jedoch  auch  den  Nachteil,  daB  nur  max.  zwei  Floppy-Stationen  am  ST 
betrieben  werden  konnen. 

Bei  den  Ataris  mit  eingebautem  Laufwerk  ist  das  interne  Laufwerk  immer  als  Drive  A  geschal- 
tet.  An  der  Buchse  ftir  das  exteme  Laufwerk  ist  der  AnschluB  fur  “Drive  select  B”  (AnschluB 
6)  uber  einen  Pull-Up-Widerstand  fest  an  +5V  gelegt.  Soil  das  Laufwerk  B  (extemes  Lauf¬ 
werk)  selektiert  werden,  gibt  der  Computer  an  “Drive  select  A”  (AnschluB  5)  der  Floppy- 
Buchse  ein  Low  aus!  Also  muB  das  exteme  Laufwerk  in  diesem  Fall  auch  hier  wieder  als 
“Drive  A”  eingestellt  sein. 

Wie  man  trotzdem  bei  Ataris  mit  eingebautem  Laufwerk  das  interne  Laufwerk  zu  Drive  B  “de- 
gradiert”  und  das  exteme  Laufwerk  zum  Drive  A  “emennen”  kann,  ist  ausfiihrlich  in  einem 
Artikel  im  “ST-MAGAZIN/68000er”,  Ausgabe  7/88,  beschrieben. 

Fremd(korper)laufwerke  am  ST 

Mit  Hilfe  von  zwolf  Steuer-  und  Meldeleitungen  steuert  nun  der  ST  die  angeschlossenen 
Laufwerke.  Die  Hauptarbeit  iibemimmt  dabei,  wie  schon  vorher  erwahnt,  der  Floppy-Disk- 
Controller. 

Die  Steuerung  der  “Side  select”-  und  “Drive  select  A  bzw.  B”-Leitungen  erfolgt  aber  nicht 
durch  den  FDC,  sondern  wird  vom  Port  A  des  Sound-Chip  (PSG)  vorgenommen.  Das  hat  bei 
AnschluB  von  Fremdlaufwerken  an  den  ST  ofter  zu  Schwierigkeiten  gefiihrt,  weil  ein  Port- 
Ausgang  des  PSG  bei  Low-Signal  nur  maximal  5  mA  treiben  kann. 

Die  “Side  select”-  und  “Drive  selecf’-Eingange  an  den  normalen  Laufwerken  besitzen  zwar 
in  der  Regel  “Low-Power-Schottky”-Eingangsstufen,  die  mit  geringen  Steuerstromen  (etwa 
1/4  des  Standard-TTL  Steuerstroms)  auskommen,  jedoch  sind  dieseEingange  meist  iiber  lkQ- 
Pull-Up  Widerstande  an  +5V  “gebunden”.  Das  schafft  der  Sound-Chip  gerade  noch  so  eben. 

Wird  jedoch  ein  zweites  Laufwerk  angeschlossen,  so  sollte  man  bei  einem  der  Laufwerke  die 
Pull-Up-Widerstande  ftir  “Side  select”  und  “Drive  select”  entfemen  (sinnvollerweise  beim 
ersten  Drive  in  der  Kette  der  Laufwerke,  um  den  LeitungsabschluB  am  Ende  der  Kette  zu 
haben)!  Die  Port-Ausgange  des  PSG  waren  sonst  iiberlastet;  ein  sicheres  Steuem  der 
Laufwerke  ist  nicht  mehr  gegeben. 

Man  kann  auch  zur  Erhohung  der  Ausgangsleistung  und  zur  Entlastung  des  Sound-Chips 
Treiberstufen  (mit  z.  B.  dem  TTL-IC  “7407”)  ftir  die  “Side  select”-  und  “Drive  select  A  bzw. 
B”-Steuerleitungen  zwischenschalten.  Dieses  zusatzliche  14polige  IC  laBt  sich  noch  relativ 
problemlos  in  einer  Diskstation  unterbringen  und  aus  der  Stromversorgung  des  Laufwerks 
speisen.  Siehe  hierzu  den  Schaltungsvorschlag  in  Abbildung  8.4. 
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'Side  select  * -Signal 
zu  den  Laufwerken 


'Drive  select  A'-Signal 
zu  den  Laufwerken 


'Drive  select  B'-Siynal 
zu  den  Laufwerken 


an  Laufuerksnasse 


Abb.  8.4:  So  kann  man  den  Sound-Chip  des  ST  bei  der  Laufwerksansteuerung  wesentlich  entlasten 


Viel  Grips  in  kleinen  Chips  -  Der  FDC 

Im  ST  wird  als  FDC  ein  Chip  desTyps  WD1 772eingesetzt.  DieserTyp  istkompatibel  zu  FDCs 
der  179X-Serie,  besitzt  jedoch  bereits  einen  eingebauten  Datenseparator  (um  die  Daten  aus 
dem  Strom  von  Daten-  und  Taktbits  auszufiltem)  und  erlaubt  eine  hohere  Steprate  fiir  die 
Kopfmotorsteuerung. 

Der  “1772”  kann  SektorgrdBen  von  128, 256, 512  oder  1024  Bytes/Sektorbearbeiten  und  das 
sowohl  in  einfacher  als  auch  doppelter  Dichte.  Atari  verwendet  ein  512er  Sektorenformat  in 
doppelter  Dichte.  Das  verwendete  Format  ist  physikalisch  kompatibel  zum  IBM-Diskformat. 
Schliefit  man  ein  5,25  Zoll-Laufwerk  an  den  ST  an,  so  kann  man  im  Prinzip  und  in  der  Praxis 
auf  einem  IBM-  oder  -kompatiblen  PC  formatierte  und  beschriebene  Disks  bearbeiten! 

Der  FDC  liefert  an  seinen  Chip-Ausgangen  fiir  “Motor  on”,  “Step”,  “Step  direction”  usw.  die 
Steueipegel  genau  entgegengesetzt,  wie  sie  von  den  Diskstationen  gebraucht  werden.  So  geht 
z.  B.  bei  der  Funktion  “Motor  starten”  der  entsprechende  AnschluB  (MO  =  Motor  on,  Pin  20) 
des  “1772”  auf  High-Pegel,  wahrend  das  Laufwerk  den  Motor  bei  Low-Pegel  am  “Motor  on”- 
AnschluB  startet,  Deshalb  sind  im  ST  invertierende  Treiberstufen  (mit  dem  TTL-IC  “7406”) 
zwischengeschaltet,  die  Ausgangsstufen  mit  offenen  Kollektoren  besitzen  und  so  ftir  die  Pe- 
gelanpassung  und  den  ebenfalls  erforderlichen  “Dampf  ’  auf  den  Steuerleitungen  zu  den  Lauf¬ 
werken  sorgen. 
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Der  FDC  im  ST  erhalt  Hilfe  -  von  der  DMA-Einheit 

Der  FDC  ist  nicht  direkt  mit  dem  Daten-  und  AdreBbus  des  ST  verbunden.  Jeglicher  Daten- 
austausch  lauft  nur  “unter  Aufsicht”  der  DMA-Einheit  (siehe  Abbildung  8.5). 


Abb.  8.5:  Einbindung  des  FDC  in  die  Hardware  des  ST 
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Uber  die  A0-,  Al-  und  CS-Leitung  selektiert  der  DMA-Baustein  die  Register  des  FDC.  Der 
logische  Zustand  der  R/W-Leitung  informiert  den  FDC  daruber,  ob  ein  Schreib-  oder  Lese- 
zugriff  auf  eines  seiner  Register  erfolgt. 

Per  (High-)Signalisierung  auf  der  DRQ-Leitung  bekommt  die  DMA-Einheit  mitgeteilt,  wann 
ein  “Data  request”  (Datenanforderung)  des  FDC  vorliegt.  Hieriiber  teilt  der  FDC  mit,  daft  er 
Daten  von  der  DMA-Einheit  erwartet  bzw.  Daten  bereitgestellt  hat  (beim  Lesevorgang),  die 
von  der  DMA-Einheit  abgeholt  werden  mtissen.  Das  Ende  einer  Operation  raeldet  der  FDC 
mit  einem  High  auf  der  INTRQ-Leitung  an  den  Port  15  des  MFP  (Uber  das  NOR-Gatter  wird 
dieses  High  dann  zu  einem  Low  am  MFP-Port  15). 

Der  AnschluB  DDEN  (Double  Density  ENable  =  Doppelte  Schreibdichte  anwahlen,  Pin  26 
des  FDC)  ist  im  ST  fest  auf  Low  gebunden.  Damit  kann  der  FDC  nur  mit  dem  MFM- Aufzeich- 
nungsverfahren  (MFM  =  Modified  Frequency  Modulation)  betrieben  werden.  Aber  es  wird 
ja  in  modemen  Mikrocomputersystemen  (und  dazu  kann  man  die  ST-Serie  ja  wohl  zahlen) 
ausschlieftlich  in  doppelter  Dichte  gearbeitet. 

Inzwischen  nutzt  man  ein  nicht  dokumentiertes  Feature  des  FDC’s  vom  Typ  WD1772  aus.  So 
vertragen  einige  Chips  dieses  Typs  eine  Verdoppelung  der  Taktrate  an  ihrem  Clk-Eingang, 
Wenn  statt  mit  dem  Standard-8-MHz-Takt  mit  16  MHz  gearbeitet  wird,  geht  alles  doppelt  so 
schnell,  und  der  FDC  hat  auf  einmal  High-Density.  Auf  diese  Weise  verfahrt  Atari  beim  TT 
und  Mega  STE,  urn  die  intemen  Drives  mit  High-Density  fahren  zu  konnen.  Nur  verwendet 
man  nicht  den  Original  WD 1 772-Chip  dafur,  sondem  einen  eigenen  Chip,  der  auch  laut  Spezi- 
fikation  die  Verdoppelung  der  Taktrate  mitmacht! 


Die  Register  des  FDC 

Wie  das  Ubersichtsbild  in  Abbildung  8.5  ebenfalls  zeigt,  besitzt  der  FDC  fiinf  Register  zu  je 
8  Bit  Breite.  Je  nach  auszufuhrender  Operation  ist  es  zunachst  erforderlich,  einige  dieser 
Register  mit  den  erforderiichen  Voreinstellungen  zu  versehen,  bevor  in  das  Kommandoregister 
das  Kommandobyte  eingeschrieben  wird. 

Das  Track-Register  (A0=1 ,  A  1=0,  R/W)  enthalt  die  Nummer  der  Spur,  Uber  der  sich  der  Kopf 
gegenwartig  befindet,  Eine  Schreib-/Lese-  oder  Verify-Operation  kann  nur  erfolgen,  wenn  der 
Inhalt  des  Track-Registers  mit  der  im  ID-Feld  auf  der  Disk  enthaltenen  Spurnummer 
ubereinstimmt.  Das  Register  kann  gelesen  und  beschrieben  werden.  Wahrend  der  FDC  eine 
Operation  ausfuhrt,  sollte  kein  Zugriff  auf  das  Register  durchgefuhrt  werden. 


Der  FDC  besitzt  nur  ein  Trackregister,  der  ST  aber  bis  zu  zwei  Laufwerke.  Dummerweise 
befinden  sich  die  Kopfe  der  beiden  Laufwerke  selten  Uber  der  gleichen  Spur.  Deshalb  muB 
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bei  einem  Laufwerkswechsel  die  aktuelle  Spumummer  des  Laufwerks,  mit  dem  momentan 
nicht  gearbeitet  wird,  zwischengespeichert  werden. 

Dies  geschieht  beim  ST  im  sogenannten  Drive  Status  Block  (DSB).  Und  da  maximal  zwei 
Disklaufwerke  angeschlossen  sein  konnen,  gibt  es  logischerweise  zwei  DSBs!  Das  erste 
Datenwort  des  jeweiligen  DSB  enthalt  die  Spumummer,  iiber  der  sich  der  Kopf  gerade  befin- 
dert  sollte.  Im  zweiten  Wort  findet  sich  die  Steprate,  mit  der  das  Laufwerk  seinen  Schreib-/ 
Lesekopf  iiber  die  Disk  hetzt.  Je  nach  TOS-Version  ergeben  sich  fiir  die  Anfangsadresse  der 
beiden  DSB  andere  Werte. 

Hier  die  Adressen  fiir  einige  TOS-Versionen: 


[  RAM-TOS 

RAM-/ROM-TOS 

Blitter-TOS 

1  Rainbow- 

11/1985 

vom  6.2.86 

vom  22.4.87 

1  TOS  1.04 

DSB  Drive  A 
Acurtrack 

$6C8 

$A06 

$A4C 

$A4C 

Aseekrt 

$6CA 

$A08 

$A4E 

$A4E 

DSB  Drive  B 
Bcurtrack 

$6CC 

$A0A 

! 

$A50 

$A50 

Bseekrt 

$6CE 

$A0C 

$A52 

$A52 

Man  sollte  jedoch  diese  Variablen  nicht  unbedingt  verwenden!  Da  aber  zumindest  die 
Einstellung  der  Seekrate  bei  AnschluB  von  5,25-Zoll-Laufwerken  sehr  wichtig  ist,  hat  ATARI 
in  den  “Rainbow  TOS  Release  Notes”  dann  fiir  das  ROM-TOS  1,00  und  Version  1.02 
(“BLITTER-TOS”)  die  Lage  der  Adressen  fiir  “Aseekrt”  und  “Bseekrt”  dokumentiert.  Auf 
andere  Art  und  Weise  ist  keine  getrennte  Einstellung  der  Steprate  fiir  die  Laufwerke  moglich. 
In  TOS-Versionen  1 .04  und  hoher  ist  die  Steprate  iiber  den  XBIOS-Aufruf  #41,  “FloprateO”, 
konfigurierbar. 

Im  Sector-Register  (A0=0,  Al=l,  R/W)  wird  dem  FDC  die  Nummer  des  anzusteuemden 
Sektors  mitgeteilt.  Ein  Schreib-  oder  Lesezugriff  erfolgt  nur  bei  Ubereinstimmung  mit  der 
Sektomummer  im  ID-Feld  des  Sektors  auf  der  Disk.  Das  Sector-Register  kann  beschrieben 
und  gelesen  werden.  Auch  fiir  dieses  Register  gilt:  Nicht  ansprechen,  solange  eine  Operation 
nicht  beendet  ist. 

Das  Data-Register  (A0=  1 ,  A 1= 1 ,  R/W)  wird  benutzt,  um  dem  FDC  die  zu  schreibenden  Daten 
Byte  fiir  Byte  zu  iibermitteln.  Wahrend  einer  Leseoperation  stehen  hier  die  gelesenen  Bytes 
fiir  den  Prozessor  (beim  ST  macht  das  die  DMA-Einheit)  zum  Abholen  bereit.  Bei  einem 
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“SEEK”-Kommando  (Gezieltes  Ansteuem  einer  Spur)  wird  dem  FDC  im  Data-Register  die 
gewiinschte  Spur  mitgeteilt,  die  “angefahren”  werden  soil! 

Durch  Einschreiben  eines  Bytes  in  das  Command-Register  ( A0=0,  A 1  =0,  Write  only)  wird  der 
FDC  aufgefordert,  eine  bestimmte  Operation  auszufuhren .  Das  Register  kann  nur  beschiieben 
werden.  Wahrend  einer  laufenden  Operation  darf  das  Register  nicht  neu  beschiieben  werden, 
es  sei  denn,  die  laufende  Aktion  soil  unterbrochen  werden. 

Aus  dem  Status-Register  (A0=0,  A1=0,  Read  only)  kann  eine  Zustandsinformation  liber  das 
durchgefiihrte  Kommando  abgerufen  werden.  Die  Bedeutung  der  einzelnen  Statusbits  hangt 
von  dem  ausgefiihrten  Kommando  ab.  Da  es  sich  um  ein  Zustandsregister  handelt,  ist  nur  ein 
Auslesen  moglich  und  sinnvoll.  Es  darf  auch  wahrend  einer  laufenden  Operation  ausgelesen 
werden! 


Die  Kommandos  des  ST-Floppy-Controllers 

Der  FDC  kennt  insgesamt  elf  verschiedene  Kommandos,  die  in  vier  verschiedene  Kategorien 
(Typen)  eingeteilt  sind.  Sie  sind  in  der  Abbildung  8.7  aufgefiihrt. 

Die  Kommandos  werden  ins  Command-Register  geschrieben  und  unmittelbar  nach  Beendi- 
gung  des  Einschreibvorgangs  ausgefiihrt.  Das  Laden  des  Command-Registers  sollte  nur  bei 
geloschtem  BUSY-Bit  des  FDC-Status-Registers  durchgefiihrt  werden,  da  sonst  die  laufende 
Operation  unterbrochen  wird! 

Eine  Ausnahme  bildethierbei  das  “Force  Interrupt”-Kommando,  das  jederzeit  gesendet  wer¬ 
den  kann,  aber  -  wie  der  Name  eben  schon  ausdriickt  -  sowieso  nur  zur  Unterbreehung  von 
einer  gerade  laufenden  Operation  benutzt  wird. 

Solange  ein  Kommando  bearbeitet  wird,  ist  das  BUSY-Bit  im  Status-Register  gesetzt.  Bei 
Operationsende  wird  es  geloscht  und  ein  Interrupt  ausgelost,  der  iiber  die  IRQ-Leitung  zum 
Port  15  des  MFP  geleitet  wird. 

Der  Inhalt  des  Status-Registers  gibt  dann  AufschluJJ  dariiber,  ob  die  Operation  korrekt  durch- 
gefiihrt  wurde  bzw.  welche  Fehler  aufgetreten  sind. 

Es  laBt  sich  auf  zwei  Arten  feststellen,  ob  der  FDC  ein  Kommando  abgeschlossen  hat. 

-  BUSY-Bit  (Bit  0)  im  Status-Register  so  lange  testen,  bis  es  vom  FDC  zuriickgesetzt  wird. 

Bevor  jedoch  nach  dem  Absenden  des  Kommandos  an  den  FDC  (Einschreiben  in  das 
Command-Register)  zum  ersten  Mai  das  Status-Register  abgefragt  wird,  sollte  man  dem 


Das  Floppy-Disk-Interface 


961 


FDC  eine  Pause  von  mindestens  32  ps  gonnen.  Eher  sind  die  Bits  im  Status-Register  nach 
Start  eines  Kommandos  namlich  noch  nicht  giiltig! 

Warten! !  S  Nicht  ewig,  sondem  bis  der  FDC  einen  Interrupt  auslost.  Dazu  wird  der  An- 
schluB  INTR  (Pin  28  des  FDC)  auf  High  gesetzt.  Als  Folge  davon  wird  dann  im  ST  beim 
Port  15  des  MFP  ein  Low  auftreten. 


Also  nach  Start  eines  FDC-Kommandos  immer  mal  bei  Port  15  des  MFP  nachschauen, 
ob  schon  ein  Low  anliegt,  der  FDC  ist  dann  namlich  fertig.  Das  ist  auch  die  vom  Betriebs- 
system  des  ST  praktizierte  Methode. 


B i t-Hr . 

Bedeutung 

7 

Zustand  des  'Motor  on'-Anschlusses  C’l*  ~  Motor  on) 

6 

Bei  READ  SECTOR  und  READ  TRACK  ohno  Funktion.  Bei  jeden 
WRITE-Befehl  wird  hiernit  ein  Schreibsthutz  angezeigt. 

5 

Typ  1-Konnandos:  Gesetzt  sobald  Motor-'Spin  up*  erf olgt  ist. 

CG  Indexpulse  nach  ’Motor  on1) 

Typ  1 I . . I I I~ Konnandos :  1 1 ' =  Sektor  nit  * De leted ■ -Data  nark. 

*  0 ' =  Sektor  nit  'Ual id'-Data  nark. 

4 

Gesetztes  Bit  zeigt  an,  da@  gewiinschter  Sektor,  Spur  Oder 
Seite  nicht  gefunden  wurde,  iRetora  not  found) 

3 

Gesetzt  uenn  CRC-Error  festgestellt  wurde . 

2 

Typ  I-Konwandos:  Zustand  des  ’Track  00‘-AnschIuP. 

t '  X  *  =  Kopf  uber  Spur  08J 

Typ  II . , I I I-Konnandos :  Wird  '1*  uenn  die  CPU  CDMA)  be in  Da- 

tentransfer  zu  langsan  reagiert  hat. 
C'Lost  Data' -Bit') 

i 

Typ  I-Konnandos!  Zustand  des  Index-Anschlup 

Typ  I I . . II I-Konnandos :  Zustand  des  DRQ-AnschluB . 

C'l“  =  Data  Register  nup  'bedient' 
werden . J 

0 

■BUSV’-Bit,  Ein  Konnando  ist  in  Bearbeitung. 

Abb.  8.6:  Die  Bedeutung  der  Bits  im  FDC-Status-Register 


Kommandos  des  Typs  I 

Hierunter  sind  alle  Kommandos  zusammcngel'aBt,  die  zur  Kopfpositionierung  benutzt 
werden,  wie  RESTORE,  SEEK,  STEP,  STEP-IN  und  STEP-OUT. 

Hier  wird  gesteppt! 

Alle  fiinf  Kommandobytes  des  Typs  Ibeinhalten  in  ihrem  Befehlsbyte  ein  Feld  von  2  Bits,  die 
zur  Einstellung  der  Spurwechselzeit  (Steprate)  dienen.  Folgende  Stepraten  sind  moglich: 
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ri  j 

[  r0 

Steprate 

0 

0 

6  ms 

(bei  40-Spur-Drives  (5,25")  iiblich) 

0  1 

1 

12  ms 

1 

0 

2  ms 

(bei  manchen  3,5"-Floppies  moglich) 

i  ! 

1 

3  ms 

(bei  80-Spur-Drives  (3,5"  und  5,25")  gangig) 

Mit  jedem  Step-Impuls  wird  der  Kopf  um  eine  Spur  weiterbewegt.  Die  Richtung  wird  dabei 
durch  den  Zustand  am  “Step  direction”- AnschluB  signalisiert.  Der  Pegel  am  “Step  direction”- 
AnschluB  bleibt  so  lange  gleich,  bis  der  Kopf  durch  ein  entsprechendes  Kommando  in  die  ent- 
gegengesetzte  Richtung  bewegt  werden  soli! 

Nach  Ausfiihrung  des  letzten  Steps  in  die  gewiinschte  Richtung  wird  dem  Kopf  eine  “Beruhi- 
gungspause”  von  30  ms  gegonnt,  um  evtl.  Vibrationen  in  derKopfpositioniermechanik  abklin- 
gen  zu  lassen.  Dies  geschieht  jedoch  nur  bei  gesetztem  “V-Bit”  (Verify-Bit)  oder  gesetztem 
“E-Bit”  der  Kommandos  des  Typs  II  +  HI. 

IJberprufung  ist  wichtig 

1st  also  das  “V-Bit”  gesetzt,  so  erfolgt  nach  der  Kopfberuhigungszeit  eine  Uberpriifung,  ob 
der  Kopf  sich  denn  nun  wirklich  iiber  der  gewiinschten  Spur  befindet. 

Dazu  wird  die  Tracknummer  aus  dem  ersten  vorbeikommenden  ID-Feld  gelesen  und  mit  der 
Spumummer  im  Track-Register  verglichen.  Stimmen  diese  iiberein  und  ist  die  CRC-Priifsum- 
me  des  gelesenen  ID-Feldes  korrekt,  ist  die  Verify-Prozedur  beendet.  Der  FDC  erzeugt  dann 
einen  Interrupt  als  Zeichen  der  Beendigung  des  Kommandos  und  signalisiert  im  Status-Regi¬ 
ster  den  Erfolg  der  Operation. 

Stimmt  beim  Verify  zwar  der  Track,  ergibt  die  CRC-Uberpriifung  aber  einen  Fehler,  so  gibt 
der  FDC  nicht  gleich  auf,  sondem  wiederholt  die  gleiche  (Jberpriifungsprozedur  mit  dem 
nachsten  ID-Feld. 

Findet  der  FDC  bei  dieser  Verify-Prozedur  innerhalb  von  fiinf  Diskumdrehungen  keine 
Ubereinstimmung  zwischen  Track-Register  und  Spumummer  in  den  ID-Feldem,  so  wird  die 
Operation  mit  einem  Interrupt  beendet  und  das  “Seek  Error-Bit”  im  Status-Register  gesetzt. 

Auszeit  fur  den  Laufwerksmotor 

Ist  bei  den  Kommandos  des  Typs  I.. Ill  das  “h”-Bit  geloscht  (“Motor  on”-Flag),  so  wird  die 
eigentliche  Operation  erst  gestartet,  wenn  der  FDC  der  Ansicht  ist,  daft  der  Antriebsmotor  des 
Laufwerks  mit  Solldrehzahl  lauft! 
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Befehl 


RESTORE 


SEEK 


STEP 


STEP-IN 


READ  SECTOR 


WRITE  SECTOR 


READ  ADDRESS 


READ  TRACK 


WRITE  TRACK 


FORCE  INTERRUPT 


fur  Komandos  des  Taps  I 
h  -  'Motor  on'-FIag 


Konnandobyte 


u 

rl 

rO 

u 

rl 

re 

u 

rl 

r0 

u  =  *  Update ' -Flag 


0  =  ' Uerif g * -Flag 


K)  =  O  :  Kein  Verify 
M  =  1  I  Test  KorreKte  Spur 


U  0 

u  a  1 

Kein  'Update' 

RKtualis.  des;  Tr-acK  Reg- 

rl,  r0 

=  Stepinputs-fiate  I 

for  Konnandos  des  Typs  II  +  III 

n  =  ‘Mult:-  Sector  • -Flag  1  [e  -  "Head  sett  l  i  ng  *  -F 1  ag  ] 


iv»  s  ©  5  •'Single  sec  tor-'  -Zugri ff 
m  =  1  5  'Multiple-  sector'-Zugrift1 


Keine  Verzogerung 
3 0ws  ver zoger-ung 


a0=  "Data  addr  .  nark'-Bit 


*0=  0  :  Schreibe  'Nortt^lc-'  DRM 
a0=  1  :  Schreibe  'Deleted'  drm 


=  'Write  Prekonpensat . 


'RreKonpensiat  ion'  Ein 
'PpeHowpcnsation'  flus 


fiir  Tap  IW-Komandas 

TFORCE^ INTERRUPT ■ -Bedingungsbi ts 


Nicht  zulassig 
Nicht  zulassig 

Interrupt  bein  nachsten  Indexpuls 
Sofortige  Unterbrechung  der  Operation 
=  B  s  Operation  ohne  Interrupt  abbrechen 


Abb.  8.7 :  Die  Kommandos  des  Floppy-Controllers  WD  1772 
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Gonnt  der  FDC  fiber  den  “Motor  on”-  AnschluB  (Pin  20  des  FDC)  dem  Laufwerksmotor  gerade 
eine  Pause,  so  wird  ein  Kommando  mit  geloschtem  “h”-Bit  zuerst  den  Drive-Motor  iiber  die 
“Motor  on”-Leitung  starten  und  dann  fiinf  Umdrehungen  warten  (Die  Umdrehungen  werden 
mittels  der  Indexpulse  gezahlt). 

Nach  diesen  fiinf  Umdrehungen  (ca.  1  s  bei  300  U/min)  geht  der  FDC  davon  aus,  daB  der  Lauf¬ 
werksmotor  seine  Nenndrehzahl  erreicht  hat,  und  fate  mit  der  Operation  fort. 

Nach  BeendigungderOperation  wartetderFDC  noch  zehnDiskrotationen  (wiederlndeximpulse 
zahlen!),  bis  der  Motor  gestoppt  wird.  Damit  wird  verhindert,  daB  der  Motor  evtl.  standig  lauft 
und  der  Kopf  einen  “Graben”  in  die  Diskette  “pfliigt”. 

WirdeinKommandomitgeloschtem  “h”-Bitgegeben  und  lauft  der  Motor  noch  auf  Nenndreh¬ 
zahl  (“Motor  on”-Bit  im  Status  Register  noch  gesetzt),  so  entfallt  natiirlich  die  Hochlaufzeit 
fur  den  Laufwerksmotor  von  1  s.  Das  hort  sich  in  derTheorie  ganz  simpel  an,  in  der  Praxis  treten 
jedoch  hin  und  wieder  Probleme  auf. 

So  funktioniert  die  ganze  Zahlerei  mit  den  Indeximpulsen  natiirlich  nur  dann,  wenn  das  Lauf- 
werk  auch  selektiert  ist.  Die  Diskstation  standig  selektiert  zu  lassen  ist  aber  auch  nicht  die 
ideale  Losung.  Vor  allem  dann  nicht,  wenn  mit  mehr  als  einem  Laufwerk  gearbeitet  wird. 
Dannlaufenjaaufderlndeximpuls-LeitungdielndeximpulseallerangeschlossenenLaufwerke 
gleichzeitig  beim  FDC  auf!  Das  TOS  versucht  das  Problem  folgendermaBen  zu  losen: 

In  jedem  Vertikal-Blank-Interrupt  wird  iiberpriift,  ob  der  FDC  inzwischen  den  Laufwerksmotor 
per  “Motor  on”-Leitung  abgeschaltet  hat.  1st  das  der  Fall,  wird  das  Laufwerk  deselektiert! 

Das  fiihrt  jedoch  zum  nachsten  Problem.  Die  VBlank-Interrupt-Routine  zur  Uberpriifung  der 
“Motor  on”-Leitung  muB  ja  dazu  auf  das  Status-Register  des  FDC  zugreifen  (Bit  7  des  Status- 
Registers  zeigt  ja  den  Zustand  der  “Motor  on”-Leitung  an)  und  “stolpert”  einer  evtl.  gerade 
laufenden  Diskoperation  dazwischen. 

Also  hat  ATARI  in  seinen  Betriebssystemvariablen  ein  Flag  eingerichtet  (“flock”  =  Floppy- 
Disk-lock  (Floppy-Verriegelung)  an  Adr.  $43E),  das  immer  dann  gesetzt  ist  (auf  oO),  wenn 
gerade  eine  Diskoperation  stattfindet.  Die  Interrupt-Routine  im  V-Blank  schaut  immer  zuerst 
bei  “flock”  nach,  ob  ein  Zugriff  auf  den  Disk-Controller  zulassig  ist.  Bei  geloschtem  Flag 
(flock=0)  darf  die  V-Blank-Interrupt-Routine  auf  die  Register  des  FDC  zugreifen. 

Wenn  keineDisk  eingelegt  ist,  weil  z.  B .  von  Harddisk  gebootet  wurde,  kann  das  Deselektieren 
aber  gar  nicht  klappen,  weil  (mangels  Disk)  keine  Indeximpulse  gezahlt  werden  konnen.  Da¬ 
mit  schaltet  der  FDC  den  Laufwerksmotor  aber  auch  nicht  ab,  und  als  Folge  davon  kann  die 
VBlank-Routine  auch  das  Laufwerk  nicht  deselektieren! 
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RESTORE  -  Zuriick  an  den  Anfang 

Einer  der  wichtigsten  Positionierungsbefehle  ist  das  Kommando  RESTORE.  Es  sorgt  dafur, 
daG  der  Kopf  so  lange  schrittweise  in  Richtung  “Heimat”  (Home-Position  =  Spur  00)  bewegt 
wird,  bis  iiber  die  “Track  00”-Leitung  (Pin  23  des  FDC)  eine  Signalisierung  (Low-Pegel)  er- 
folgt.  Das  bedeutet  dann  nichts  anderes,  als  daB  der  Kopf  nun  Spur  00  erreicht  hat, 

Ist  das  der  Fall,  so  wird  das  Track-Register  auf  $00  gesetzt  und  ein  Interrupt  ausgelost.  Sollte 
jedoch  nach  255  Step-Impulsen  immer  noch  keine  “Track  00”-Signalisierung  erfolgt  sein,  so 
wird  die  Operation  “interrupted”  und  im  Status-Register  das  “Record  not  found”-Bit  gesetzt 
(nur  wenn  mit  “Verify”  gearbeitet  wird!). 

Benutzt  wird  der  RESTORE-Befehl  immer  vor  einem  Zugriff  auf  die  Disk,  wenn  nicht  genau 
bekannt  ist,  iiber  welcher  Spur  sich  der  Kopf  befindet  (z.  B.  nach  dem  Einschalten  des  Sy¬ 
stems).  Die  “V”-,”h”-,”rl "-  und  “r0”-Bits  wirken  auch  hier  wie  bereits  beschrieben. 

Wer  suchet,  der  findet  -  Der  SEEK-Befehl 

Die  SEEK-Operation  (Suchen)  erlaubt  das  gezielte  Anfahren  einer  Spur. 

Der  FDC  erwartet  dabei  im  Data-Register  (!)  die  Nummer  der  Spur,  iiber  die  der  Kopf  positio- 
niert  werden  soli,  wahrend  sich  im  Track-Register  die  Spumummer  der  augenblicklichen 
Kopfposition  befindet.  Es  werden  dann  vom  FDC  so  lange  Step-Impulse  in  der  notigen  Rich¬ 
tung  ausgegeben,  bis  der  Inhalt  des  Track-Registers  (welches  jeden  Step  mitzahlt)  mit  der  ge¬ 
wunschten  Spumummer  im  Data-Register  iibereinstimmt. 

Ein  “Verify”  iiber  der  gewunschten  Spur  ist  natiirlich  auch  hier  moglich  dutch  Setzen  des  V- 
Bits.  Nach  AbschluG  der  Operation  wild  wieder  ein  Interrupt  erzeugt  und  die  Status-Bits  im 
Status-Register  entsprechend  gesetzt. 

Mehr  Speed  durch  weniger  KontroIIe  -  SEEK  ohne  Verify 

Dieses  gesetzte  Verify-Bit  sorgt  im  TOS  dafur,  das  die  Diskzugriffe  nicht  mit  der  eigentlich 
moglichen  GescJtwindigkeit  ablaufen.  So  wird  namlich  bei  jedem  (!)  Disk-Zugriff  des  TOS, 
der  ein  SEEK  erfordert  (und  das  sind  die  meisten!),  eine  SEEK-Routine  aufgerufen,  die  fiir 
die  Positionierung  des  Kopfs  sorgt,  Bei  “SEEK  mit  Verify”  wird  iiber  der  gewunschten  Spur 
noch  zur  KontroIIe  ein  ID-Feld  eingelesen  und  die  darin  enthaltene  Spumummer  mit  der  ge¬ 
wunschten  Tracknummer  verglichen. 

Das  kostet  Zeit,  die  man  sich  eigentlich  sparen  kann,  weil  die  Positionierung  zum  einen  wenig 
fehleranfallig  ist  und  auGerdem  beim  normalerweise  anschlieBend  folgenden  Zugriff  auf 
Sektoren  der  angesteuerten  Spur  ja  so  wieso  eineUberpriifung  auf  die  korrekte  Adresse  (Sektor 
und  Spur!)  erfolgt. 
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Durch  Riicksetzen  des  Verify-Bits  in  dieser  SEEK-Routine  des  TOS  kann  man  Diskzugriffe 
um  bis  zu  50%  beschleunigen!  Bei  TOS  im  RAM  laBt  sich  das  Bit  problemlos  andem  (beim 
RAM-TOS  von  1 1/85  ist  die  Speicherstelle  $68C3  von  $14  auf  $10  zu  andem.  Im  RAM-TOS 
vom  06.02.87  ist  die  interessante  Speicherstelle  bei  $7A1D). 

Fur  TOS  im  ROM  existieren  Hilfsprogramme,  die  sich  beim  Start  des  Systems  ins  TOS  ein- 
klinken  und  den  Ansprung  der  ROM-SEEK-Routine  in  eine  modifizierte  SEEK-Routine  im 
RAM  umleiten,  welche  dann  ohne  Verify  arbeitet. 

Es  gibt  auch  sogenannte  FASTLOAD-EPROMS,  die  anstelle  der  Original-ROMs  eingesetzt 
werden  und  bei  denen  das  Verify-Bit  nicht  gesetzt  ist.  Im  TOS  1.00  ist  das  die  Speicherstelle 
$0DC7,  im  TOS  1 .02an  Adresse  $0EC7  und  im  TOS  1 .04  bei  $  15 1 7.  Die  AdreBangaben  gelten 
jeweils  fur  ROM  U7  (ST),  ROM  U67  (STF)  bzw.  ROM  U10  (MEGA  ST). 

STEP  IN,  STEP  OUT  -  Schritt  fiir  Schritt  iiber  die  Diskette 

Mit  jedem  STEP-Kommando  gibt  der  FDC  einen  Step-Impuls  aus.  Die  Bewegungsrichtung 
(“Step  direction”)  ist  dabei  die  gleiche  wie  bei  dem  zuletzt  ausgefiihrten  Schritt.  Ist  das 
“Verify”-Bit  gesetzt,  erfolgtnach  Ablauf  derZeitfiir  dieSteprate  (rl-,T0-Bits  im  Kommandobyte) 
und  Kopfberuhigung  eine  Uberpriifung,  ob  der  Kopf  auf  dem  richtigen  Track  gelandet  ist. 

Bei  den  STEP-Kommandos  existiert  im  Kommandobyte  noch  das  sogenannte  “Update”-Bit 
(“U”-Bit).  Ist  es  gesetzt,  wird  das  Track-Register  je  nach  Steprichtung  um  1  erhoht  oder  emie- 
drigt.  Das  Track-Register  ist  somit  also  immer  up(to)date. 

Um  aber  den  Kopf  nicht  immer  nur  in  eine  Richtung  bewegen  zu  konnen  (STEP  andert  ja  nicht 
die  Bewegungsrichtung),  gibt  es  noch  die  STEP-IN-  und  STEP-OUT-Befehie.Wie  der  Name 
schon  sagt,  wird  hier  der  Kopf  einen  Schritt  nach  innen  (zur  Diskettenmitte)  oder  nach  auBen 
(in  Richtung  Track  00)  bewegt.  “Update”  und  “Verify”  arbeiten  auch  hier  wie  schon  zuvor 
erlautert. 

Nach  AbschluB  eines  der  Step-Kommandos  wird  wieder  ein  Interrupt  ausgelost.  Der  Status 
der  Operation  kann  natiirlich  wieder  aus  dem  Status-Register  ausgelesen  werden. 


Kommandos  des  Typs  II  -  Jetzt  geht’s  an  die  Daten 

Die  FDC-Kommandos  des  Typs  II  dienen  dem  sektorweisen  Datenzugriff  auf  die  Disk. 

Bevor  ein  READ-  oder  WRITE  SECTOR-Kommando  ausgefiihrt  werden  soli,  muB  das 
Sector-Register  mit  der  Nummer  des  zu  bearbeitenden  Sektors  geladen  werden.  Erst  dann  wird 
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das  READ-  Oder  WRITE  SECTOR-Kommando  gegeben.  Wie  schon  bei  den  Typ  I- 
Kommandos  wird  auch  hier  durch  ein  gesetztes  “BUSY”-Bit  im  Status-Register  signalisiert, 
daS  der  FDC  fleiBig  ist.  1st  auch  noch  das  “E”-Bit  gesetzt,  wird  der  FDC  mit  dem  Beginn  des 
Datenzugriffs  warten,  bis  die  Kopfberuhigungszeit  von  30  ms  abgelaufen  ist.  Aber  dann. . .  geht 
erst  mal  die  Sucherei  los! 

Der  FDC  versucht  zunachst,  ein  ID-Feld  auf  der  Spur  zu  finden.  Die  Spur-  und  Sektomummer 
des  ID-Feldes  mu 6  natiirlich  mit  den  Daten  im  Track-  und  Sector-Register  iibereinstimmen. 

Wenn  dann  auch  noch  die  CRC-Priifsumme  iiber  das  ID-Feld  stimmt,  kann  endlich  der  dem 
ID-Feld  folgende  Datensektor  gelesen  oder  beschrieben  werden.  Ftir  die  Suche  nach  einem 
passenden  ID-Feld  hat  der  FDC  fiinf  Diskumdrehungen  Zeit,  sonst  gibt  es  einen  Interrupt  mit 
gesetztem  “Record  not  found”-Bit  im  Status-Register. 

Neben  dem  schon  bekannten  “Motor  on”-Flag  gibt  es  bei  diesem  Kommando-Typ  noch  ein 
“m”-Bit  (“READ/WRITE  Multiple  sectors"): 

-  Bei  geloschtem  “m”-Bit  wird  nur  ein  Sektor  gelesen  oder  geschrieben, 

Bei  gesetztem  “m”-Bit  werden  alle  Sektoren  ab  der  Sektomummer  im  Sector-Register 
so  lange  gelesen  oder  beschrieben,  bis  der  FDC  z.  B.  per  “Force  interrupt”-Kommando 
unterbrochen  wird  oder  ein  Fehler  auftritt.  Das  Sector-Register  wird  dabei  kontinuierlich 
mit  jedem  gelesenen/geschriebenen  Sektor  heraufgezahlt  (“Auto  updating”),  bis  die 
Sektomummer  im  Sector-Register  groBer  als  die  groBte  Sektomummer  in  der  Spur  ist. 

Beim  ST  wiirde  der  FDC  also  bei  einer  “READ  MULTIPLE  SECTORS ’’-Operation,  begin- 
nend  mit  dem  Sektor  5,  dann  abgebrochen,  wenn  die  Sektoren  5..9  gelesen  wurden  und  der 
FDC  vergeblich  nach  einem  Sektor  10  Ausschau  hielte  (Sektomummer  1..9  sind  ja  normal). 

Immerhin  blieben  dem  FDC  jedoch  fiinf  Diskumdrehungen  Zeit,  den  Sektor  1 0  vielleicht  doch 
noch  zu  finden.  Erst  dann  wiirde  die  Operation  mit  gesetztem  “Record  not  found”-Bit  im 
Status-Register  abgebrochen.  Um  sich  diese  Wartezeit  zu  sparen,  wird  man  den  FDC  mit 
“Force  interrupt”  dann  unterbrechen,  wenn  genug  Daten  geschrieben  oder  gelesen  wurden. 

READ  SEKTOR 

Folgendes  spielt  sich  ab,  nachdem  der  FDC  ein  READ  SECTOR-Kommando  empfangen  hat: 

Der  FDC  schaltet  auf  BUS  Y.  (“BUS  Y”-Bit  im  Status  Register  setzen).  Evtl.  wird  gewar- 
tet,  bis  der  Motor  mit  Solldrehzahl  lauft  (“h”-Bit)  und  sich  der  Kopf  wieder  beruhigt  hat 
(“E”-Bit). 
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Em  passendes  ID-Feld  (Track,  Sektor,  CRC-Bytes)  wird  gesucht.  1st  es  gefunden,  muft 
in  einem  der  folgenden  43  Bytes  eine  “Data-address-mark”  (DAM)  gefunden  werden. 
Fur  diese  Sucherei  hat  der  FDC  fiinf  Umdrehungen  Zeit  (sonst  erfolgt  ein  Interrupt  mit 
gesetztem  “Record  not  found”-Bit  im  Status-Register). 

Nach  der  gefundenen  DAM  werden  Datenbytes  eingelesen.  Das  erste  Byte  der  Daten 
gelangt  ins  Data-Register.  Der  FDC  signalisiert  durch  High  am  DRQ-Ausgang  (Data 
Request  =  Pin  27  des  FDC)  und  durch  Setzen  des  “DRQ’VBits  im  Status-Register,  daB 
ein  Datenbyte  abgeholt  werden  muB. 

-  Sollte  das  Data-Register  nicht  rechtzeitig  vor  dem  Eintreffen  des  nachsten  Datenbytes 
ausgelesen  worden  sein,  wird  das  vorhergehende  Byte  im  Data-Register  mit  dem  von 
Disk  neu  geiesenen  Byte  iiberschrieben.  Im  Status-Register  wird  dann  das  “Lost  data”- 
Bit  gesetzt. 

Es  werden  alle  Datenbytes  des  Sektors  nacheinander  eingelesen.  Sollte  zu  allem  Ubel 
auch  noch  die  CRC-Prufung  einen  Fehler  ergeben,  so  wird  das  “CRC  error”-Bit  gesetzt 
und  die  Operation  unterbrochen  (auch  wenn  es  sich  um  ein  “READ  MULTIPLE  SEC- 
TORS”-Kommando  handelt). 

Nach  AbschluB  der  Leseoperation  wird  durch  das  “Sector  type”-Bit  im  Status-Register 
signalisiert,  ob  die  geiesenen  Daten  als  giiltig  oder  geloscht  zu  deuten  sind .Giiltige Daten 
werden  durch  eine  “Data  address  mark”  =  $FB  vor  den  Sektordaten  gemeldet.  Das 
“Sector  type”-Bit  im  Status-Register  ist  dann  geloscht.  Ein  Sektor  mit  als  “geloscht" 
geltenden  Daten  wird  durch  ein  gesetztes  “Sector  type”-Bit  angezeigt  (“Data  address 
mark”=$F8).  Beim  ST  wird  nur  mit  “gultigen”  Sektoren  gearbeitet,  weil  das  TOS  sich 
selbst  merken  kann,  welche  Sektoren  frei  und  welche  mit  giiltigen  Daten  belegt  sind. 

Soviel  zum  Kommando  READ  SECTOR. 

Wie  die  Pfiffigen  unter  den  Lesem  jetzt  wahrscheinlich  schon  messerscharf  geschlossen 

haben,  geht  es  nun  weiter  mit  dem  Kommmando 

WRITE  SECTOR 

Bei  diesem  Kommando  lauft  folgender  Vorgang  ab: 

-  “BUS  Y”-Bit-Setzen,  “Motor  on”-Flag  und  evtl.  Kopfberuhigung  abwarten  funktioniert 
genauso  wie  bei  READ  SECTOR. 

-  Die  “Write  protect”-Leitung  wird  abgefragt.  Wenn  die  Disk  im  angesprochenen  Lauf- 
werk  schreibgeschiitzt  ist,  geht’s  gar  nicht  erst  weiter.  Dann  wird  namlich  “interrupted” 
und  im  Status-Register  zur  Information  das  “Write  protect”-Bit  gesetzt. 
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-  Wenn  der  Schreibzugriff  erlaubt  ist,  erfolgt  genau  wie  bei  READ  SECTOR  die  Suche 
nach  einem  Sektor  mit  passendem  ID-Feld.  Hat  der  FDC  ein  passendes  ID-Feld  rnit 
korrekter  CRC-Priifsumme  gefunden,  wird  nach  zwei  weiteren  Liickenbytes  der  DRQ- 
AnschluB  aktiviert  und  das  “DRQ”-Bit  im  Status-Rgister  gesetzt.  Das  erste  zu  schreiben- 
de  Datenbyte  muB  innerhalb  der  nachsten  neun  Luckenbytes  ins  Data-Register  geladen 
werden,  sonst  wird  mit  gesetztem  “Lost  Data”-Bit  unterbrochen, 

22  Bytes  nach  dem  letzten  CRC-By  te  des  ID-Felds  (bei  MFM)  wird  der  FDC  den  “Write 
gate”-An$chluB  aktivieren  und  zwolf  Bytes  mit  $00  schreiben.  Dann  folgt  die  “Data- 
address-roark”  (DAM=$FB  bei  “a0”-Bit=0,  DAM=$F8  bei  “a0”-Bit=l). 

-  Nun  erst  folgen  die  eigentlichen  Datenby  tes,  welche  von  der  CPU  rechtzeitig  ins  Data- 
Register  transportiert  werden  miissen.  Die  Signalisierung,  wann  wieder  ein  Byte  fallig 
ist,  geschieht  iiber  den  DRQ-AnschluB  (Pin  27  des  FDC)  und  das  “DRQ”-Bit  im  FDC- 
Status-Register.  Gerat  die  CPU  (im  ST  macht  das  der  DMA-Baustein)  bei  der  Daten- 
bereitstellung  “aus  dem  Tritt”,  wird  fiir  jedes  fehlende  Byte  ein  $00-Byte  geschrieben. 
Dieser  Fehler  wird  dann  mit  gesetztem  “Lost  Data”-Bit  im  Status-Register  angezeigt. 

-  Nach  dem  letzten  Byte  des  Datenfeldes  eines  Sektors  wird  die  CRC-Priifsumme  ge¬ 
schrieben.  Dann  kommt  noch  ein  Byte  mit  $FF  (wer  weiB  wofiir?),  und  anschlieBend  er¬ 
folgt  der  Interrupt,  der  das  Ende  der  Operation  anzeigt. 

Damit  ist  ein  Sektor  geschrieben.  Beim  WRITE  SECTOR-Kommando  kann  das  sogenannte 
Prekompensations-Bit  (“P”-Bit)  verwendet  werden.  Bei  geloschtem  “P”-Bit  erhoht  sich  damit 
die  Datensicherheit  auf  den  inneren  Spuren,  auf  denen  die  Bits  (und  damit  die  kleinen 
“Stabmagnete”)  wesentlich  naher  beieinanderliegen  als  auf  den  auBeren  Spuren. 

Um  “Bitwanderungen”  durch  zwei  zu  nah  nebeneinanderliegende  “Stabmagnete”  von  vom- 
herein  zu  erschweren  (nebeneinanderliegende  gleiche  Magnetpole  stofien  sich  ja  bekanntlich 
ab,  wahrend  sich  ein  ungleiche  Pole  gar  nicht  nah  genug  kommen  konnen!),  werden  gleiche 
Pole  etwas  naher  beieinander  geschrieben  (sie  werden  sich  schon  von  allein  voneinander  ent- 
femen).  Ungleiche  Pole  werden  etwas  weiter  voneinander  entfemt  aufgezeichnet,  weil  sie  ja 
doch  das  Bestreben  haben,  sich  einander  zu  nahem. 

Beim  ST  arbeitet  ATARI  immer  mit  geloschtem  “P”-Bit,  egal  auf  welche  Spur  zugegriffen 
wird.  Die  Schreibvorkompensation  ist  also  immer  eingeschaltet! 

Diagnose-  und  Formatierkommandos  -  Typ  m-Befehle 

Mit  den  Kommandos  des  Typs  III  hat  man  die  Moglichkeit,  mehr  Informationen  von  der  Dis¬ 
kette  zu  holen  bzw.  darauf  zu  schreiben  als  mit  den  Sektorzugriffen  der  Typ  H-Kommandos. 
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Adresse  gesucht!  -  READ  ADDRESS 

Das  Kommando  READ  ADDRESS  ermoglicht  es,  nur  das  nachste  “vorbeikommende”  ID- 
Feld  eines  Sektors  (eben  seine  Adresse  auf  der  Disk)  auf  einer  Spur  einzulesen.  Dies  ist  nur 
6  Bytes  lang  (Spur-,  Seiten-,  Sektomummer,  Sektorlangenkennung  und  die  zwei  CRC-By  tes). 
Auch  bei  READ  ADDRESS  besteht  natiirlich  wieder  die  Moglichkeit,  mit  dem  “Motor  on”- 
Flag  (“h”-Bit)  und  einer  Kopfberuhigungszeit  (“E”-Bit)  zu  arbeiten. 

Nach  Empfang  des  Kommandos  setzt  der  FDC  wie  gehabt  das  “BUSY”-Status-Bit  und  wird 
dann  das  nachste  ID-Feld  Byte  fur  Byte  an  das  Data-Register  ubermitteln.  Von  dort  mtissen 
diese  Bytes  nach  und  nach,  entsprechend  der  Signalisierung  mit  der  DRQ-Leitung  bzw.  dem 
DRQ-Status  Bit,  abgeholt  werden  (bei  verspatetem  Auslesen  wird  wieder  “Lost  Data”  signa- 
lisiert!). 

Die  Giiltigkeit  der  gelesenen  Bytes  wird  natiirlich  per  CRC-Checksumme  iiberpriift  und  ent¬ 
sprechend  im  Status-Register  angezeigt  (Bit  3  =  “CRC  Error”-Bit).  Zusatzlich  wird  die  gelese- 
ne  Tracknummer  des  ID-Felds  ins  Sector-Register  (!)  kopiert  und  steht  dort  fur  evtl.  Verglei- 
chezur  Verfiigung.  Das  Endeder  READ  ADDRESS-Operation  wird  auch  wieder  ganz  normal 
iiber  Interrupt  und  Reset  des  “BUSY”-Bits  angezeigt. 

WRITE  TRACK 

ist  der  eigentlich  wichtigste  Befehl  iiberhaupt,  iiber  den  der  Floppy-Controller  verfiigt.  Nur 
mit  diesem  Befehl  ist  es  namlich  moglich,  alle  erforderlichen  Informationen  auf  die  Disk  zu 
bekommen. 

Mit  WRITE  TRACK  wird  eine  Diskette  formatiert! 

Dazu  legt  man  sich  in  einem  Speicherbereich  des  Computers  Byte  fiir  Byte  ein  “Doppel”  der 
zu  formatierenden  Spur  an.  Dieser  “Memory  Track”  enthalt,  cinschl  ieRl  ich  Markierungs-  und 
Synchronisationsbytes,  alle  Informationen  fiir  den  zu  schreibenden  Track.  Und  diese  Spur 
sieht  dann  folgendermaBen  aus  (zur  besseren  Ubersicht  ein  Auge  auf  Abbildung  8.8  halten): 

Da  wiiren  also  zunachst  60  Bytes  mit  $4E,  dann  zwolfmal  die  $00,  dreimal  die  $AI  mit  fehlen- 
den  Taktflanken  zur  Identifizierung  des  ersten  ID-Feldes,  dann  die  ID-Address-Mark  ($FE) 
selbst,...  Moment  mal,  wie  war  das  gerade  mit  den  fehlenden  Taktflanken?  Wo  kommen  die 
denn  her,  bzw.  wie  lafit  man  die  denn  weg? 

Fehlende  Flanken  sind  auffallig  -  Markierungen  auf  der  Disk 

Um  solche  Marken  mit  fehlenden  Taktflanken  zu  schreiben,  gibt  es  beim  WRITE  TRACK- 
Befehl  des  FDC  bestimmte  Bytes,  die  der  FDC  nicht  als  “normale”  zu  schreibende  Bytes 
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ansieht,  sondern  als  Befehlsbytes  interpretiert,  die  besondere  Reaktionen  im  FDC  auslosen. 
Bekommt  der  FDC  beim  WRITE  TRACK-Befehl  ein.es  der  folgenden  Bytes  iibermittelt,  so 
werden  die  nachstehend  beschriebenen  Reaktionen  ausgelost: 


Byte 

1  Funktion 

$00...$F4 

Schreibe  normales  Byte  $00...$F4 

$F5 

Schreibe  $A1  mit  fehlenden  Taktflanken  und  starte 

CRC-Priifsummenbildung 

$F6 

Schreibe  $C2  mit  fehlenden  Taktflanken 

$F7 

Schreibe  Inhalt  des  Priifsummengenerators  auf  Disk  (2  CRC-Bytes) 

$F8...$FF 

Schreibe  normales  Byte  $F8...$FF 

Diese  Angaben  gelten  fur  die  Betriebsart  “doppelte  Schreibdichte”  (MFM-Betrieb).  Fur  den 
Betrieb  in  “einfacher  Schreibdichte”  (FM-Betrieb),  die  beirn  FDC  des  ST  ja  nur  iiber  einen 
Eingriff  in  dessen  Hardware  eingeschaltet  werden  kann,  haben  die  Bytes  $F8..$FF  noch  eine 
besondere  Funktion.  Darauf  soil  hier  jedoch  nicht  weiter  eingegangen  werden. 

Mit  diesen  Informationen  laBt  sich  also  nun  eine  komplette  Spur  im  Speicher  nachbilden,  wel- 
che  dann  mit  dem  WRITE  TRACK-Befehl  auf  Disk  geschrieben  werden  kann. 

Beim  ST  sieht  so  eine  “Spur  im  Speicher”  dann  wie  in  Abbildung  8.8  aus. 

Hat  man  auf  der  Disk  erst  mal  eine  solche  S  truktur  aufgebracht,  kann  der  FDC  nun  die  notigen 
Markierungen  und  Synchronisationsinformationen  fur  die  sektorweise  Datenspeicherung  fin- 
den. 

Eine  ganze  Spur  im  Griff  -  READ  TRACK 

Mit  dem  READ  TRACK-Befehl  wird  der  FDC  aufgefordert,  den  kompletten  Inhalt  der  Spur, 
iiber  welcher  der  Kopf  gerade  positioniert  ist,  zu  lesen. 

Alle  Bytes,  einschlieftlich  GAPs  (Liickenbytes  zur  Synchronisation),  ID-Felder,  DAMs  und 
natiirlich  Datenbytes  werden,  beginnend  mit  der  fallenden  Flanke  des  Indexpulses,  bis  zum 
ndchsten  Indexpuls  innerhalb  einer  Diskumdrehung  gelesen! 

Das  Ende  der  Operation  wird  wie  gehabt  per  Interrupt  und  durch  Loschen  des  “BUSY”-Bits 
gemeldet. 

Bin  evtl.  aufgetretener  “Lost  data”-Fehler  durch  nicht  rechtzeitiges  Reagieren  auf  die  DRQ- 
Signalisierung  wird  natiirlich  wieder  im  Status-Register  angezeigt. 
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Abb .  8.8:  So  wird  ein  Track  im  Speicher  zusammengebaut  und  dann  mit  dem  Befehl  WRITE 
TRACK  aufDisk  geschrieben  (Formatierung) 


wiederholt  sich  fiir  jeden  Sektor 
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Fehler  bei  der  Befehlsausfuhrung  -  Der  Bug  bei  READ  TRACK 

Fur  Diagnoseanwendungen  ware  der  READ  TRACK-Befehl  geradezu  ideal,  wenn  er  denn 
korrekt  funktionieren  wtirde! 

Und  an  den  Fehlfunktionen  ist  der  sogenannte  Address  Mark-Detector  des  FDC  schuld,  der 
bei  diesem  Befehl  standig  eingeschaltet  ist.  Der  AM-Detector  des  FDC  ist  zustandig  fur  das 
Erkennen  jener  bereits  beim  WRITE  TRACK  erwahnten  Bytes,  die  mit  fehlenden  Taktin- 
formationen  ($A1  und  $C2)  geschrieben  werden. 

Zwar  beginnt  der  FDC  mit  der  fallenden  Flanke  des  Indeximpulses  mit  dem  Lesen  der  Daten. 
Jedoch  fangt  er  meist  mitten  in  einem  Byte  an,  da  der  FDC  in  dem  eintreffenden  Bitstrom  vom 
Laufwerk  zunachst  nicht  erkennen  kann,  wo  denn  ein  Byte  anfangt  und  wo  es  aufhort.  Die 
ersten  Bytes  der  Spur  werden  also  falsch  eingelesen. 

Erst  durch  Erkennen  des  ersten  Markierungsbytes  (durch  die  fehlende  Taktinformation  ja 
besonders  herausragend)  rastet  die  Synchronisation  ein.  Leider  kiimmert  sich  der  standig  akti- 
ve  AM-Detector  anscheinend  nicht  um  bereits  erkannte  Bytegrenzen  und  rastet  sich  auch 
immer  dann  neu  ein,  wenn  er  in  einer  einlaufenden  Bitfoige  meint,  wieder  ein  Markierungsby  te 
($A1  oder  $C2)  erkannt  zu  haben. 

Durch  diese  zusatzlichen  vermeintlichen  Markierungsbytes  synchronisiert  sich  der  FDC  viel 
ofter  auf  Markierungen,  die  eigentlich  gar  keine  sind  und  damit  dann  auch  falsch! 

Fazit:  Den  Befehl  READ  TRACK  am  besten  gar  nicht  benutzen! 


Kommandos  des  Typs  IV 

Manchmal  ist  er  (der  FDC)  kaum  zu  halten  -  Der  FORCE  INTERRUPT-Befehl 

Nun  zum  letzten  Kommando  des  Floppy  Controllers.  Es  lafit  sich  nicht  den  vorhergehenden 
Typen  I.  .Ill  zuordnen  und  bekommt  damit  eine  eigene  Typzuordnung. 

Mit  dem  FORCE  INTERRUPT-Kommando  wird  eine  laufende  Operation  abgebrochen.  Die- 
ser  Befehl  wird  hauptsachlich  benutzt,  um  ein  READ/WRITE  MULTIPLE  SECTORS-Kom- 
mando  zu  unterbrechen  oder  um  das  Status-Register  auf  Typ  I-Statussignalisierung  zuriickzu- 
schalten.  Bei  Typ  II.-UI-Befehlen  haben  einige  Status-Bits  ja  eine  andere  Bedeutung  als  bei 
Typ  I-Kommandos.  FORCE  INTERRUPT  kann  jederzeit  an  den  FDC  gesendet  werden.  Uber 
die  Bits  2  und  3  des  Befehlsbytes  wird  dem  FDC  mitgeteilt,  wann  er  denn  die  laufende  Opera¬ 
tion  abwiirgen  soil.  Folgende  Moglichkeiten  gibt  es: 
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Befehlsbyte 

Funktion 

$D8 

Sofortige  Unterbrechung 

$D4 

Unterbrechung  bei  nachstem  Indeximpuls 

$D0 

Keine  Interruptsignalisierung,  aber  Operation  trotzdem  abbrechen 

(Clear  Immediate  Interrupt) 

Empfiingt  der  FDC  ein  FORCE  INTERRUPT-Kommando,  so  geht  der  INTRQ-AnschluB  auf 
High,  sobald  die  Bedingung  fur  den  Interrupt  erfiillt  ist.  {Nein!  Diesmal  braucht  der  FDC  das 
“BUSY”-Bit  nicht  setzen,  es  ist  ja  von  der  zu  unterbrechenden  Operation  noch  auf  High  und 
wird  durch  FORCE  INTERRUPT  zuriickgesetzt!) 

Beim  $D4-Interrupt  (Indeximpuls  Interrupt)  geht  der  INTRQ-AnschluB  (Pin  28  des  FDC)  also 
beim  nachsten  Indeximpuls  auf  High  (gut  zur  Drehzahlmessung  geeignet!).  Wird  ein  $D8- 
Interrupt  (Immediate  Interrupt)  ausgelost,  “springt”  INTRQ  sofort  nach  Empfang  des  Befehls 
auf  “High”. 

Das  fiihrt  zu  der  Frage,  wann  denn  die  INTRQ-Leitung  normalerweise  wieder  zuriick  auf  Low 
geht?  Interrupts  treten  ja  nicht  nur  per  FORCE  INTERRUPT,  sondem  auch  nachjeder  abge- 
schlossenen  Operation  auf. 

Das  “Loschen”  der  INTRQ-Leitung  geschieht  sozusagen  automatisch  durch  Auslesen  des 
Status-Registers  oder  beim  Laden  des  Command-Registers  mit  einem  neuen  Befehl.  Aber  wie 
immer  gibt  es  auch  hier  eine  Ausnahme  von  der  Regel.  Nach  einem  “FORCE  Immediate 
INTERRUPT”  laBt  sich  nur  durch  einen  SDO-Interrupt  (Unterbrechung  ohne  Unterbrechungs- 
Signalisierung)  die  INTRQ-Leitung  loschen  (das  ist  dann  die  Unterbrechung  der  Unterbre¬ 
chung)! 

Bevor  man  nach  einem  FORCE  INTERRUPT  wieder  ein  Kommando  an  den  FDC  gibt,  sollte 
man  mindestens  16  ps  warten.  Wenn  nicht,  wird  FORCE  INTERRUPT  nicht  ausgefiihrt! 


Beim  ST  ist  alles  ganz  anders  - 
Die  FDC-Programmierung 

Nein,  ganz  so  schlimm  ist  es  nun  doch  nicht.  Man  hat  jedoch  nicht  die  Moglichkeit,  direkt  auf 
die  FDC-Register  zuzugreifen. 

Zwischen  CPU  und  FDC  hat  ATARI  den  DM  A-Baustein  (DMA= Direct  Memory  Access  oder 
Datentransfer  Mai  Anders)  gesetzt.  Das  hat  den  groBen  Vorteil,  daB  die  CPU  z.  B.  bei 
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Diskzugriffen  nicht  standig  an  der  DRQ-Leitung  des  FDC  horchen  muG,  ob  wieder  ein 
Datenbyte  vom  FDC  abgeholt  oder  dorthin  gebracht  werden  muG. 

Das  erledigt  die  DMA-Binheit  viel  eleganter.  Sie  braucht  nur  zu  wissen,  wie  viele  Sektoren 
(Bytes)  ab  welcher  Adresse  im  Speicher  auf  Disk  geschrieben  oder  von  dort  eingelesen  werden 
sollen,  und  schon  “geht  die  Post  ab”. 

Wie  im  Prinzip  eine  FDC-Operation  unter  Zuhilfenahtne  der  DMA-Einheit  ablauft,  soil  hier 
kurz  erlautert  werden. 

Eine  Beschreibung  der  einzelnen  Register  des  DMA-Bausteins  sind  im  Teil  II,  Kapitel  1 ,  “Die 
Zentraleinheit”,  zu  finden. 

-  VBlank-Diskroutine  vom  DMA-  und  FDC-Baustein  femhalten  (“flock”<>0  setzen !  Das 

muB  natiirlich,  wie  die  gesamte  FDC-Programmierung,  im  Supervisormodus  gescbehen, 
da  “flock”  (Adr.  $43E)  im  Supervisor-RAM  liegt!). 

st  flock  ;  "flock"  auf  <>  setzen 

Floppy-Laufwerk  und  -Seite  iiber  Port  A  des  PSG  (Programmable  Sound  Generator) 
selektieren.ManbenutztdazudieXBIOS-Funktion#29(“Offgibit”)und#30(“Ongibit”). 

Die  Steuerleitungen  zum  Laufwerk  sind  Low-aktiv,  also  wird  mit  einem  Low  (=  Bit  im 
Port  A  loschen)  auf  der  entsprechenden  “Drive  select”-  bzw.  “Side  select”-Leitung  die 
Laufwerks-/Seiten-Auswahl  durchgefuhrt! 

Funktion  der  Bits  zur  Disksteuerung  im  Port  A  des  PSG: 

Bit  0:  0  =  Seite  1, 

1  =  Seite  0  angewahlt 

Bit  1:0=  Drive  A  selektiert 

Bit  2:0=  Drive  B  selektiert 

Beispiel: 

move.w  #$07, -(SP)  ;  Beide  Drives  deselektieren 

move.w  #$1E,-(SP)  ;  und  Seite  0  anwahlen 

trap  #14  ;  "Ongibit"  aufrufen 

addq.l  #4,SP 


move . w 


#$FA 


;  Seite  1  und  Drive  B  selektieren 
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move.w  #$1D 

trap  #14  ;  "Offgibit"  aufrufen 

addq.l  #4,SP 


Der  DMA-Einheit  muB  mitgeteilt  werden,  wo  die  zu  schreibenden/lesenden  Daten  im 
Speicher  stehen  bzw.  nach  dem  Lesen  von  der  Disk  stehen  sollen. 

Die  Anfangsadresse  dieses  Speicherbereichs  wird  der  DMA-Einheit  im  DMA-Base-  und 
Counter-Register  byteweise  iibergeben. 


$FF8609 

High-Byte 

( "dmahigh" ) 

$FF860B 

Mid-Byte 

("dmamid") 

$FF860D 

Low-Byte 

("dmalow") 

Achtung! 

Hierbei  ist  wichtig,  daB  die  Adresse  in  der  Reihenfolge  Low-Byte  -> 
Mid-Byte  ->  High-Byte  an  das  DMA-Base-und  Counter-Register  iiber- 
geben  wird. 

Beispiel: 

move . 1 

#STRTADR, d7 

;  Anfangsadr.  fur  DMA  holen 

move.b 

d7,dmalow 

;  Low-Byte  setzen 

asr.l 

#8,d7 

;  Urn  1  Byte  nach  rechts  schieben 

move.b 

d7,dmamid 

;  Mid-Byte  setzen 

asr.l 

#8,  d7 

;  Urn  1  Byte  nach  rechts  schieben 

move.b 

d7,dmahi 

;  High-Byte  setzen. 

-  Der  32-Byte  FIFO-Buffer  der  DMA-Einheit  muB  geloscht  werden.  Das  geschieht  durch 
“Kippeln”  mit  Bit  8  im  DMA-Mode-Register  (“fifo”  an  Adr.  $FF  8606). 

Gleichzeitig  wirdmitdiesem  Biteingestellt,  in  welcheRichtungderDMA-Datentransport 
denn  laufen  soli. 

$90,  $190,  $90  Wenn  diese  Word-Folge  ins  DMA-Mode  Register  geschrieben 
wird,  ist  anschlieBend  der  FIFO-Buffer  geloscht  und  der  DMA- 
Baustein  auf  “Lesen”  programmiert. 

$190,  $90,  $190  Diese  Word-Folge  loscht  ebenfalls  den  FIFO-Buffer,  schaltet 
die  DMA-Einheit  jedoch  auf  schreibenden  DMA-Zugriff. 
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Beispiel: 

lea 

fifo, A5 

move.w 

#$190, 0 (A5) 

move.w 

#$90  , 0 (A5) 

move.w 

#$190,0(A5) 

;  Zum  Code  sparen 
;  FIFO-Buffer  loschen 
;  und  DMA-Baustein  auf 
;  LESEN  schalten 


Bin  Transfer  von  Daten  zwischen  Speicher  und  FIFO-Buffer  im  DMA-Baustein  findet 
immer  nur  statt,  wenn  mindestens  1 6  Bytes  im  FIFO  “aufgelaufen”  sind.  Darunter  tut  sich 
iiberhaupt  nichts. 

Bei  SektorgroBen  von  512  Bytes  gibt  es  da  keine  Schwierigkeiten.  Will  man  jedoch  z. 
B.  nur  ein  ID-Feld  von  Disk  lesen  (6  Bytes),  so  kommen  diese  sechs  Bytes  gar  nicht  erst 
im  Speicher  an.  Da  hilft  nur  eins:  Mehrere  ID-Felder  lesen. 

-  Die  Zahl  der  zu  transportierenden  Datenblocke  zu  5 1 2  Bytes  (Sektoren)  wird  der  DMA- 
Einheitim  Sector-Counter-Register  (“disked”  an  Adr.  $FF  8604)  mitgeteilt.  Bei  READ/ 
WRITE  TRACK  sind  das  ca.  6250  Bytes,  also  rund  13  Blocke. 

Beispiel: 

move.w  #13,diskctl  ;  13  Sektoren  ubertragen 

-  Nun  wird  beim  DMA-Chip  urn  “Audienz”  beim  FDC  gebeten,  d,  h.,  im  DMA-Mode- 
Register  wird  durch  Loschen  von  Bit  4  die  “Durchreiche”  zu  den  FDC-Registem  geoff- 
net.  Durch  diesen  Kniff  wird  statt  des  Sector-Counter-Registers  unter  Adr.  $FF  8604 
(“disked”)  ein  Register  des  FDC  zuganglich. 

Welches  FDC-Register  nun  unter  “disked”  erscheint,  wird  durch  die  Bits  1  und  2  des 
DMA-Mode-Registers  bestimmt.  Diese  steuem  namlich  die  AdreBleitungen,  mit  denen 
der  DMA-Baustein  dem  FDC-Chip  mitteilt,  welches  Register  dieser  denn  bitte  schon 
zum  Zugriff  bereithalten  soli. 

Die  auf  der  nachsten  Seite  folgenden  Kommandoworte  fur  das  DMA-Mode-Register 
wahlen  eines  der  FDC-Register  aus. 

Wenn  nach  dem  Setzen  der  FDC-Register  schreibender  DMA-Betrieb  vorgesehen  ist, 
muB  zusatzlich  das  Bit  8  im  DMA-Mode-Register  gesetzt  werden  (siehe  auch  weiter 
vom,  bei  der  Beschreibung  fur  das  Loschen  des  FIFO-Buffers). 
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Word  im  DMA- 

angewahltes  Register 

Mode  Register 

des  Floppy  Controllers 

$(1)80 

Command/Status-Register  (Read=Status) 

$(1)82 

Track-Register 

$(1)84 

Sector-Register 

$(1)86 

Data-Register 

Die  Register  des  FDC  werden  auf  die  fur  die  gewiinsehte  Operation  erforderlichen  Werte 
gesetzt  (Track-,  Sector-Register). 


Beispiel: 

move . w 

#$86, fifo 

;  Zugriff  auf  Data-Register 

move . w 

#$29,diskctl 

;  Track-Nr.  $29  ins  Data-Register 

move . w 

#$80, fifo 

;  Zugriff  auf  Command-Register 

move . w 

#$14,diskctl 

;  SEEK-Befehl  mit  Verify  an  FDC 

-  Das  Ende  des  Kommandos  wird  dann  vom  FDC  per  Interrupt  an  den  MFP,  Port  15 ,  signa- 
lisiert.  Also  empfiehlt  es  sich,  von  Zeit  zu  Zeit  Bit  5  des  Port  Registers  des  MFP  (“gpip” 
an  Adr.  $FF  FA01)  zu  testen.  Bei  Low  von  Bit  5  des  Ports  ist  der  FDC  fertig. 

-  Das  DMA-Status-Register  (“fifo”  an  Adr.  $FF  8606,  READ)  gibt  Auskunft,  ob  der 
Datentransfer  iiber  den  DMA-Baustein  ordnungsgemaB  abgelaufen  ist.  Interessant  ist 
nur  Bit  0.  Bei  einem  Fehler  ist  dieses  auf  Low.  Die  weitere  Bitbelegung  ist  bei  der  Be- 
schreibung  der  DMA-Register  zu  fmden  (Teil  II,  Kapitel  “Die  Zentraleinheif ’).  Vor  Zu- 
griff  auf  das  DMA-Status-Register  sollte  It.  Atari- Vorgaben  iiber  das  DMA-Mode-Regi- 
ster  der  Zugriff  auf  das  Sector-Counter-Register  eingestellt  sein  (Bit  4  im  DMA-Mode 
Register  gesetzt). 

Beispiel: 

move.w  #$90, fifo  ;  Sector-Cnt .-Reg.  seiektieren 

move.w  fifo,D7  ;  DMA-Status  ->  Register  D7 


Aber  nicht  nur  bei  der  DMA-Operation  kann  ein  Fehler  aufgetreten  sein.  Deshalb  schnell 
noch  das  FDC-Status-Register  ansehen.  Dazu  mufi  dieses  naturlich  erst  wieder  in  der 
“Durchreiche”  der  DMA-Einheit  erscheinen.  Also  wird  mit  den  bereits  vorgestellten 
Kommandowortem  iiber  das  DMA-Mode-Register  das  FDC-Status-Register  angewahlt. 
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Beispiel: 

move.w  #  $80,fifo 

raove.w  diskctl,D7 


;  FDC-Status-Reg.  selektieren 
;  FDC-Status  ->  Register  D7 


Wenn  wir  fertig  sind,  dlirfen  die  VBlank-Diskroutinen  nun  wieder  auf  die  DMA-Einheit 
zugreifen  (“flock”  auf  0  setzen) 

clr.w  flock  ;  "flock"  =  0  setzen 
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Kapitel  9:  Das  Atari 

Computer  System  Interface  (ACSI) 


Die  Computer  der  ST-Serie  verfiigen  zusatzlich  zu  den  schon  mehr  oder  weniger  ublichen 
Standard-Schnittstellen  liber  eine  Atari-spezifische  Schnittstelle:  den  ACSI-Bus.  Atari  hat 
hier  eine  Schnittstelle  zum  AnschluB  von  “intelligenten”  schnellen  Peripheriegeraten  wie  z. 
B.  Harddisks,  Laserdrucker  oder  CD-ROMs  definiert. 

Der  ACSI-Bus  besteht  im  wesentlichen  aus  einem  bidirektionalen  8-Bit-Datenbus  und  einigen 
Steuer-  und  Meldeleitungen,  Sein  Verhalten  und  das  verwendete  Protokoll  ahneln  stark  dem 
desSCSI-Busses  (Small  Computer  System  Interface-Bus).  ATARI  hatdenSCSI-Busauf  seine 
Anforderungen  zurechtgestutzt  und  verwendet  nur  SCSI-Kommandos  der  Klasse  0,  wegen 
einer  Abweichung  im  ersten  Befehlsbyte. 

Die  Betreuung  dieser  Schnittstelle  liegt  im  ST  bei  der  DMA-Einheit.  Deshalb  sind  It.  Atari- 
Spezifikation  auch  Datentransfer-Geschwindigkeiten  von  iiber  8  MBit/s  moglich.  Abbildung 
9.1  skizziert  kurz  die  Komponenten  am  ACSI-Bus. 

Erforderlich  ist  zunachst  der  Initiator.  Im  Gegensatz  zum  SCSI-Bus  gibt  es  beim  ACSI-Bus 
nur  einen  davon  und  das  ist  der  ST.  Er  verwaltet  den  ACSI-Bus. 


Initiator 


Devicel  |Device|  [Devicel  [Device 


Device 


Device 


Device 


Device 


Device 


Abb.  9.1 :  Der  ACSI-Bus  mit  seinen  verschiedenen  Komponenten 
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Bis  zu  acht  Targets  (Zieleinheiten)  sind  moglich.  Ein  Target  enthalt  einen  eigenen  Controller 
zur  Steuerung  der  zurn  Target  gehorigen  Gerate  (z.  B.  Harddisk).  Dabei  ist  es  durchaus  denk- 
bar,  daB  ein  Target  mehrere  Gerate  (z.  B.  Festplatten)  steuert. 

Folgende  Eigenschaften  miissen  die  angeschlossenen  Targets  aufweisen: 

-  Ein  an  ein  Target  gesandtes  Kommando  darf  nicht  “in  der  Luft  hangen  bleiben”,  bis  z. 
B .  der  Controller  im  Target  bereit  ist.  Mit  Ausnahme  des  letzten  miissen  alle  Bytes  eines 
Kommandoblocks  durch  einen  Interrupt  vom  Target  quittiert  werden. 

Ein  “DRIVENOT  READY”-Error  muB  also  sofortnachEmpfang  gesendet  werden,  oder 
der  Initiator  erklart  das  angesprochene  Target  fur  “nicht  anwesend”. 

-  Jedes  Target  testet  sich  nach  einem  RESET  selbst  und  muB  alle  erforderlichen  Grund- 
einstellungen  vomehmen.  Ein  eigenes  Selbsttest-Kommando  gibt  es  nicht. 

Der  Initiator  kann  nach  einer  festgelegten  Zeit  “Timeout”  signalisieren  und  (sollte)  einen 
RESET fur  dasTargetmitdem“Timeout”-Fehlerausl6sen(konnen).  Ein  softwaremaBiger 
RESET  einzelner  Targets  durch  den  ST  ist  jedoch  nicht  moglich.  Wenn  RESET,  dann 
nur  per  Druck  auf  die  RESET-Taste  des  ST  und  fiir  alle  Targets. 

-  Wenn  ein  Target  eine  Operation  abgeschlossen  und  zurn  AbschluB  ein  Statusbyte  gesen¬ 
det  hat,  ist  der  ACSI-Bus  freigeschaltet. 

Als  ACSI-BusanschluB  am  ST  benutzt  ATARI  eine  19pol.  Buchse  des  Typs  “DB  19S”.  Sie 
sieht  zwar  ahnlich  wie  der  Centronics- AnschluB  aus,  es  besteht  jedoch  durch  die  unterschied- 
liche  Polzahl  keine  Verwechslungsgefahr. 

Der  SCSI-Bus  verwendet  hingegen  eine  50polige  Verbindungsleitung  zwischen  den  einzel- 
nen  Komponenten,  wobei  eine  groBe  Zahl  der  Leitungen  als  Masseleitungen  dienen  und  somit 
als  Abschirmung  gegen  Storeinstrahlungen. 

Diese  bei  Atari  fehlenden  Masseleitungen  fiihren  dazu ,  daB  die  Signalleitungen  kurz  ausfallen 
miissen,  urn  Storeinstrahlungen  gering  zu  halten.  Zwischen  einzelnen  Devices  sind  maximal 
24  Inch  (ca.  60  cm)  zulassig.  Die  Gesamtleitungslange  darf  ca.  1 ,8  m  nicht  iiberschreiten,  wo¬ 
bei  nicht  mehr  als  vier  Targets  am  ACSI-Bus  angeschlossen  sein  dtirfen. 

Die  Belegung  der  Buchse  und  die  Einbindung  des  ACSI-Busses  in  die  ST-Hardware  zeigt  der 
nachfolgende  Schaltungsauszug. 

Auf  dem  ACSI-Bus  wird  mit  TTL-Pegeln  gearbeitet. 
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Die  einzelnen  Anschlusse  habe  dabei  folgende  Funktion: 


RESET  Mit  einem  Low  auf  dieser  Leitung  werden  die  angeschlossenen  Targets  vom 
Initiator  zuriickgesetzt.  Das  RESET-Signal  ist  12  usee  “lang”  aktiviert. 

R/W  Damit  signalisiert  der  Initiator  die  Datentransportrichtung.  Bei  Low  schreibt 

der  Initiator  an  ein  Target.  Liegt  hier  High,  erwartet  der  Initiator  Informationen 
von  einem  Target.  Das  Signal  wirkt  nur  bei  der  Command-Phase  (dazu  spater 
mehr).  Das  Handshaking  wahrend  des  Datenaustauschs  lauft  iiber  ACK  und 
DRQ.  Die  gewunschte  Datentransportrichtung  wird  dem  Target  wahrend  der 
Command-Phase  iiber  die  gesendeten  Command-Bytes  “beigebracht”. 


ACK  Auch  dieses  Signal  ist  wieder  Low-aktiv  und  an  die  Targets  gerichtet.  Hiermit 

quittiert  der  Initiator  ein  _DRQ  (Data  ReQuest  =  Bereitschaft  zum  Datenaus- 
tausch)  von  einem  Target. 

CS  Dieses  Low-aktive  Signal  wird  fiir  das  “Chip  Select”  des  Target-Command- 

(wahrend  Command-Phase)  oder  Target-Status-Registers  (wahrend  Status- 
Phase)  benutzt.  Wird  vom  Initiator  an  die  Targets  gerichtet. 

A1  Vom  Initiator  an  Target  gerichtetes  Signal.  Mit  einem  Low  auf  A1  wird  die 

Command-Phase  “eingelautet”. 


DRQ  Wahrend  des  DMA-Datentransfers  (nicht  wahrend  der  Command-Phase!) 

signalisiert  das  angesprochene  Target  mit  einem  Low  auf  dieser  Leitung,  daB 
ein  weiteres  Byte  auf  den  Bus  gelegt  werden  soil  (vom  Initiator  zum  Target) 
oder  gelegt  wird  (vom  Target  zum  Initiator). 

INT  Wahrend  der  Command-Phase  quittiert  das  angesprochene  Target  mit  einem 

Low-Impuls  auf  dieser  Leitung  den  Empfang  eines  Bytes.  Der  AbschluB  einer 
DMA-Operation  auf  dem  ACSI-Bus  und  der  Beginn  der  Status-Phase  wird 
ebenfalls  per  Low  auf  dieser  Leitung  signalisiert. 

D0..D7  Richtig  geraten!  Das  ist  der  Datenbus  des  ACSI. 

Soviel  zur  Bedeutung  der  einzelnen  Bus-Leitungen. 

AnschlieBend  nun  einiges  iiber  den  Bus-Fahrplan  (die  einzelnen  Bus-Phasen)  des  ACSI. 

-  Der  Datentransport  erfolgt  asynchron  und  halt  sich  an  ein  Request/Acknowledge- 
Protokoll  (Datenanforderung  mit  anschlieBender  Empfangsbestatigung).  Fiir  jedes  zu 
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ubertragende  Byte  erfolgt  ein  Handshake  (nachdem  Schema:  Vorsicht,  ein  Bytekommt! 
Datenbyte  iibertragen  -  Empfangsbestatigung  geben). 

-  Der  Informationsaustausch  auf  dem  ACSI-Bus  lauft  immer  nach  dem  gleichen  Schema 
ab. 

Command-Phase  ->  Data  in/-out-Phase  ->  Status-Phase  -> 

Command-Phase  ->  Data  in/-out-Phase  ... 

-  Ein  RESET  hat  die  hochste  Prioritat  und  muB  immer  ausgefiihrt  werden. 

-  Die  Targets  miissen  den  Bus  standig  “im  Auge”  behalten  und  auf  evtl.  Kommandos  um- 
gehend  reagieren.  Ein  “Timeout”  sollte  laut  Atari  nach  drei  Sekunden  erfolgen,  nachdem 
bei  einem  Command-Byte-Transfer  keine  Bestatigung  vom  Target  erfolgt  ist. 

-  Ein  Target  “antwortet”  nur,  wenn  es  “angesprochen”  wird. 

-  Eine  laufende  Operation  eines  Targets  kann  nur  per  RESET  unterbrochen  werden.  Der 
Initiator  sollte  per  Software  ein  Resetsignal  auf  der  RESET-Leitung  fur  die  Targets 
auslosen  konnen  (der  ST  kann’s  nicht!  Ein  RESET  wird  nur  erzeugt,  wenn  der  ST 
ebenfalls  zuriickgesetzt  wird.) 

-  Ein  angesprochenesTargethatden  Bus  fur  sich,  bis  es  das  Status-Byte  zuriicksendet.  Das 
sollte  nicht  Ianger  als  vier  Sekunden  ab  Operationsbeginn  auf  sich  warten  lassen,  da  sonst 
der  Initiator  ein  “Timeout”  erzeugt  und  das  Target  fur  “nicht  anwesend”  erklart.  Wobei 
die  Festlegung  der  Timeout-Zeit  von  der  Software  her  erfolgt,  die  den  ACSI-Bus  bedient! 

Zur  Verdeutlichung  der  einzelnen  Bus-Phasen  folgen  nun  einige  Zeitdiagramme. 


Die  Command-Phase 

Der  Initiator  kiindigtdurch  Low  aufder“Al”-Leitung  eine  Command-Phase  an.  Wahrend  der 
Obertragung  des  ersten  Command-Bytes  bleibt  “A  I”  auf  Low  (siehe  Abbildung  9.3). 

Mit  einem  Low  auf  der  “CS”-Leitung  signalisiert  der  Initiator  den  angeschlossenen  Targets 
die  Giiltigkeit  der  Daten  auf  dem  Datenbus.  Auf  der  “R7W”-Leitung  liegt  ein  Low,  weil  Daten 
vom  Initiator  an  die  Targets  geschrieben  werden. 

Alle  Targets  haben  fur  sich  das  erste  Command-Byte  daraufhin  zu  untersuchen,  ob  der  Initiator 
mit  “ihnen  sprechen”  mochte.  Das  “auserwahlte”  Target  muB  umgehend  den  Empfang  des 
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Command-Bytes  bestatigen  (mit  einem  Low-Impuls  auf  der  “JNT'-Leitung).  Geschieht  die 
Bestatigung  nicht  rechtzeitig,  kann  ein  “Time-out”  vom  Initiator  signalisiert  werden.  Das 
gesuchte  Target  wird  dann  als  “nicht  anwesend”  registriert. 


fll 

IHT 

CS 

R/H 

Data 


/ 


/ 


^ _ /..... . _ (- 

ii  ii 


■C"  Byte  0  ) - {  Byte  1  V 

1 1 - 1 — l 1 - 1 — r J 

ii  ii  ii  ii 


-+\  A  }*—  B  — H  C  -#•{  A  B  — H  C  H*- 

fi=  60  ns  Cnax.3 
B-  250  ns  tnax.3 
C  =  20  ns  Cmax.J 


Abb.  9.3:  Die  Command-Phase 


Hat  das  angesprochene  Target  den  Empfang  des  ersten  Command-Bytes  mit  Low  auf  der 
“_INT”-Leitung  quittiert,  so  existiert  nun  quasi  ein  festgeschalteter  Datenkanai  zwischen 
Initiator  und  diesem  Target.  Die  weiteren  fiinf  Command-Bytes  werden  mit  High  auf  der 
“Al”-Leitung  iibertragen.  Alle  anderen  Targets  halten  sich  bis  zum  Beginn  der  nachsten 
Command-Phase  (die  wird  ja  wieder  mit  einem  Low  auf  der  “A  1  ’’-Leitung  angekiindigt)  aus 
dem  Datenaustausch  heraus. 

Beim  ST  wird  der  ACSI-Bus  von  der  DMA-Einheit  bedient.  Mit  deren  Unterstiitzung  ist  so- 
wohl  ein  Einzelbyte-Transfer  als  auch  ein  blockorientierter  Datenaustausch  (ein  ganzes  Paket 
mit  Bytes  wird  iibertragen)  moglich.  Die  Datenby  tes  werden  in  der  Command-Phase  noch  per 
“Handbetrieb”  (im  Einzelbyte-Transfer)  iibertragen.  Der  “Turbolader”  (Datenaustausch  in 
DMA-Betriebsart)  wird  erst  wahrend  der  “Data  in/out-Phase”  zugeschaltet!  Das  angewendete 
Prinzip  fur  den  Einzelbyte-Transfer  ist  das  gleiche  wie  bei  der  Ubergabe  von  Daten  an  die 
Register  des  Floppy-Disk-Controllers  (FDC). 

Beim  FD C-Reg i sterzu gri ff  kann  man  ja  mit  geloschten  Bits  3+4  im  DMA-Mode-Register 
(“fifo”  an  Adr.  $FF  8606)  eine  “Durchreiche”  zu  einem  mit  den  Bits  1  +2  im  DMA-Mode-Regi- 
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ster  auszuwahlenden  FDC-Register  offhen.  Die  “Durchreiche”  ist  dabei  das  sogenannte 
Controller-Access-Register  (“disked”  an  Adr.  $FF  8604).  Siehe  hierzu  auch  Teil  H,  Kapitel 
1,  Abschnitt  “DMA  im  ST”. 

Fiir  einen  Einzelby  tezugriff  auf  den  ACSI -Bus  muB  im  DM  A-Mode-Register  dagegen  das  Bit 
3  gesetzt  und  Bit  4  geloscht  sein.  Wird  nun  ein  Byte  in  das  Controller-Access-Register 
geschrieben,  gelangt  es  von  dort  direkt  auf  die  Datenleitungen  des  ACSI-Busses.  Hat  man 
vorher  im  DMA-Mode-Register  das  Bit  1  geloscht,  wurde  damit  die  “Al”-Leitung  des  ACSI- 
Busses  auf  Low  gezogen,  was  ja  fiir  die  angeschlossenen  Targets  soviel  wie  “Achtung,  das 
erste  Command-Byte  kommt”  bedeutet.  Nur  fiir  die  Ausgabe  des  ersten  Command-Bytes  ist 
“Al”  auf  Low! 

Die  Signale  “_CS”  und  “R/W”  werden  von  der  DMA-Einheit  intern  erzeugt.  “R/W”  legt  die 
Datenrichtung  fest  und  ist  fiir  die  Ausgabe  eines  Command-Bytes  auf  Low  (es  werden  jaDaten 
ans  Target  geschrieben). 

Das  angesprochene  Target  hat  den  Empfang  jedes  Command-Bytes  dann  mit  einem  Low-Im- 
puls  auf  der  “„INT”-Leitung  zu  quittieren  (sonst  “Timeout”!).  Dieser  Interrupt  lauft  im  ST  ja, 
wie  schon  beim  FDC  beschrieben,  am  Port  15  des  MFP  auf.  Der  Zustand  des  Ports  15  kann  an 
Adresse  $FF  FA01  (“gpip”),  Bit  5,  abgefragt  werden.  Das  letzte  Command-Byte  wird  aller- 
dings  nicht  mehr  per  Low-Impuls  auf  der  “_INT”-Leitung  vom  Target  quittiert,  sondem  es 
wird  direkt  zur  nachsten  Phase  iibergegangen! 


Data-in/out-Phase 

Wahrend  der  Data-in/out-Phase  (siehe  Abbildung  9.4  und  9.5)  steuert  die  DMA-Einheit  des 
ST  den  Datentransfer  selbsttatig.  Es  wird  dabei  im  Blockmodus  gearbeitet  (Ubertragung  von 
Datenbytes  in  Blocks  zu  512  Bytes). 

“A  1  ”  ist  dabei  standig  auf  “High”.  Die  Synchronisation  der  Dateniibertragung  und  damit  die 
Geschwindigkeit  wird  ausschlieBlich  durch  das  Target  bestimmt.  Durch  Low  auf  der 
“_DRQ”-Leitung  signalisiert  das  Target  dem  Initiator,  daB  Daten  gebraucht  werden  (in  der 
Data-out-Phase)  oder  daB  Daten  vom  Target  geliefert  werden  konnen  (in  der  Data-in-Phase). 

MitLow  auf  der  “_ACK”-Leitung  quittiert  der  Initiator,  daB  Daten  nun  auf  dem  Bus  bereitge- 
stellt  sind  (Data-out-Phase)  oder  dieDaten  vom  Target  iibemommen  wurden  (Data-in-Phase). 

Wenn  man  sich  die  angegebenen  Zeiten  z.  B.  bei  der  Data-out-Phase  betrachtet,  so  laBt  sich 
ausrechnen,  daB  die  Zykluszeit  zur  Ubertragung  eines  Bytes  max.  240  ns  +  250  ns  +  240  ns 
=s  730  ns  betragt.  Es  konnen  also  mindestens  1/730  ns  =  1,37  MByte/Sek.  tibertragen  werden. 
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In  der  Data-in-Phase  kann  man  unter  giinstigen  Verhiiltnissen  sogar  ca.  1,8  MByte/Sek. 
erreichen  (wenn  der  Target-Controller  da  mitmacht)! 


Abb.  9.4:  Die  Data-in-Phase 


Abb.  9.5:  Die  Data-out-Phase 
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Die  Status-Phase 

Nach  AbschluB  einer  Data-in/out-Phase  wird  per  Interrupt  (Low  auf  der  “__INT”-Leitung)  das 
Ende  dieser  Phase  signalisiert.  Das  Status-Byte  fur  die  Operation  wird  dann  vom  Target  an 
den  Initiator  ubermittelt. 


bn  ST  wird  dieses  in  das  Confcroller-Access-Register  geschrieben  und  kann  von  dort  ausge- 
lesen  werden  (“diskctl”  an  Adr.  $FF  8604).  Dazu  muB  natiirlich  wieder  die  “Durchreiche”  zum 
ACSI-Bus  geoffnet  werden  (DMA-Mode-Register,  Bit  3  gesetzt  und  Bit  4  geloscht!). 


Der  ACSI-Command-Descriptor-Block 

Wahrend  der  Command-Phase  werden  dem  Target  (in  der  Mehrzahl  der  Falle  diirfte  das  z.  Zt. 
die  Hard-Disk  sein)  sechs  Bytes  ubermittelt.  Dieser  Block  hat  folgenden  Aufbau: 

Byte  0  NNNOOOOO 

^ ^ -  Operationscode 

- - -  Target-Nummer 
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Byte  1 


Byte  2 


Byte  3 


Byte  4 


Byte  5 


DDDBBBBB 


BBBBBBBI 

5 

B  B  B  B  B  B  B  I 

i 

LLLLLLLL 

C  C  C  C  C  C  C  ( 

j 

Block-Nummer 

(High-Bits) 

Device-Nummer 


Block-Nummer 

(Mid-Bits) 


Block-Nummer 

(Low-Bits) 


Block-Anzahl 


Control-Byte 


Die  Target-Nummerbezeicimet  ernes  der  acht  moglichen  Targets  (Target  0..7)  am  ACSI-Bus. 
Alle  angeschlossenen  Targets  uberpriifen  direkt  nach  Eintreffen  des  ersten  Command-Bytes 
anhand  dieser  Target-Nummer,  ob  sie  angesprochen  sind.  Das  angesprochene  Target  bestatigl 
dann  unmittelbar  dem  Initiator  per  JNT-Signalisierung  den  Empfang  und  wartet  auf  die  fol- 
genden  Bytes  des  Blocks.  Die  Target-Nummer  kann  am  Target-Controller  mit  DIP-Schaltem 
oder  Jumpern  (Steckbriicken)  eingestellt  werden. 

Der  Operationscode  enthalt  den  Code  fiir  das  auszufiihrende  Kommando.  Mit  den  fiinf  zur 
Verfiigung  stehenden  Bits  sind  max.  32  verschiedene  Kommandos  moglich. 

Die  Device-Nummer  wahlt  eines  von  acht  moglichen  Geraten  des  T  argets  aus,  auf  welches  sich 
das  Kommando  beziehen  soil.  1st  das  Target  ein  Hard-Disk-Controller,  so  konnte  damit  eins 
von  maximal  acht  Hard-Disk-Laufwerken  angesprochen  werden. 

Die  unteren  fiinf  Bits  und  die  folgenden  16  Bits  der  Commando-Bytes  2+3  bilden  eine  21  Bit 
Block-Nummer  fiir  einen  Datenblock.  Im  Falle  einer  Hard-Disk  ist  das  der  log.  Sektor,  auf  den 
zugegriffen  werden  soil. 
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Der  log.  Sektor  wird  dann  vom  Hard-Disk-Controller  in  eine  Zylinder-,  Kopf-  und  phys. 
Sektomummer  umgesetzt. 

Das  vierte  Byte  des  Command-Descriptor-Blocks  enthalt  die  Block-Anzahl.  Dieser  8-Bit- 
Wert  gibt  an,  wie  viele  Blocks  (a  512  Bytes,  also  z.  B.  Sektoren  einer  Hard-Disk)  tibertragen 
werden  sollen.  Dieser  Wert  muB  von  Null  verschieden  sein  (warum  sollte  man  auch  Null 
Blocks  =  0  Bytes  tibertragen  wollen?). 

Das  fiinfte  Byte  (< Control-Byte )  erganzt  den  Operationscode  des  Command-Descriptor- 
Blocks  urn  evtl.  spezielle  Informationen.  Es  ist  jedoch  bei  den  Hard-Disk-Commands  unbe- 
nutzt  und  auf  Null  gesetzt. 

Nachstehend  ist  der  Befehlssatz  wiedergegeben,  den  der  Adaptec -Controller  in  der  Hard-Disk 
SH204/SH205/MEGAF1LE  30/60  mindestens  verstehen  sollte,  Fur  die  Bezeichnung  der  Bits 
im  Command-Descriptor-Block  werden  die  folgenden  Buchstaben  benutzt: 

N  =  Target-Nummer  B  =  Block-Nummer 

D  =  Device-Nummer  L  =  Block-Anzahl 

Der  Befehlssatz  des  Hard-Disk-Controllers 

Befehl:  Test  Drive  Ready  ($0) 

Byte  0:  NNN00000 

Byte  1:  DDD00000 

Byte  2:  00000000 

Byte  3:  0  0  0  0  0  0  0  0 

Byte  4:  00000000 

Byte  5:  00000000 

Testet,  ob  die  Device-Nr.  DDD  des  Targets  NNN  angeschlossen  und  bereit  ist.  Wenn  das  der 
Fall  ist,  wird  ein  entsprechendes  Status-Byte  (=0)  zuriickgeliefert. 

Befehl:  Restore  to  Zero  ($1) 

Byte  0:  NNN00001 

Byte  1 :  DDD00000 

Byte  2:  00000000 

Byte  3:  00000000 

Byte  4:  00000000 

Byte  5:  00000000 


Lesekopf  auf  Spur  0  positionieren. 


992 


ATARI  Profibuch 


Befehl: 

Byte  0: 

Request  sense  ($3) 
N  N  N 

0 

0 

0 

1 

1 

Byte  1: 

D 

D 

D 

0 

0 

0 

0 

0 

Byte  2: 

0 

0 

0 

0 

0 

0 

0 

0 

Byte  3: 

0 

0 

0 

0 

0 

0 

0 

0 

Byte  4: 

0 

0 

0 

0 

0 

1 

0 

0  (4  Bytes  zuruckliefem!) 

Byte  5: 

0 

0 

0 

0 

0 

0 

0 

0 

Wie  wir  noch  sehen  werden,  meldet  das  Target  eventuelle  Fehler  fiber  ein  gesetztes  Bit  1  im 
Status-Byte.  Genauere  Informational  fiber  die  Art  des  Fehlers  kann  man  mit  diesem  Komman- 
do  erhalten. 


Es  werden  vier  Bytes  mit  Status informationen  vom  Target-Controller  eingelesen.  Die  vier 
Bytes  werden  per  DMA-Betrieb  zum  ST  ubertragen,  womit  wieder  das  Problem  mit  dem 
FIFO-Puffer  der  DMA-Einheit  auftritt  (erinnnem  Sie  sich  noch  an  READ  ADDRESS  bei  der 
Beschreibung  des  Floppy-Disk-Controllers?)! 

Damit  uberhaupt  Bytes  aus  dem  FIFO-Buffer  der  DMA-Einheit  im  Speicher  des  ST  ankom- 
men,  muB  man  ja  mindestens  16  Bytes  fibertragen.  Also  sollte  der  Befehl  mindestens  viermal 
ausgefuhrt  werden! 


Die  vier  gelesenen  Bytes  haben  dabei  folgende  Bedeutung: 


Byte-Nr 


Inhalt 


Bedeutung 


VFFFFFFF 


X  X  X  B  B  B  B 


Fehlemummer 

log.  Blockadresse  in  den  Bytes 
1-3  gultig 


High-Bits  der  Blockadresse 
Reserviert 


B  B  B  B  B  B  B  Mid-Bits  der  Blockadresse 


B  B  B  B  B  B  B  Low-Bits  der  Blockadresse 
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Im  folgenden  sehen  Sie  die  in  Byte  0  angezeigten  Fehlemummem  und  deren  Bedeutung: 


Fehler-Nummer 

Bedeutung 

$00 

Drive  Errors 

No  sense  (Alles  klar!  Kein  Fehler) 

$01 

No  Index  (keine  Indeximpulse  gefunden) 

$02 

No  Seek  complete  (SEEK  noch  nicht  beendet) 

$03 

Write  fault  (Schreibfehler) 

$04 

Drive  not  ready  (Drive  noch  bei  der  Initialisierung?) 

$06 

No  Track  $00  (Spur  $00  nicht  zu  finden) 

$10 

Controller  Errors 

ID  ECC  Error  (ECC-Fehler  im  ID-Feld) 

$11 

Uncorrectable  Data  Error 

$12 

(nicht  korrigierbarer  Fehler  im  Datenfeld  eines  Sektors) 

ID  Address  Mark  not  found 

$13 

Data  Address  Mark  not  found 

$14 

Record  not  found  (Sektor  nicht  zu  finden) 

$15 

Seek  Error 

$18 

Data  Check  in  No  Retry  Mode 

$19 

ECC  Error  during  Verify 

$1A 

Bad  Block  (Zugriff  auf  ausgemappten  Block) 

$1C 

Unformatted  or  Bad  format 

$20 

Command  Errors 

Invalid  Command  (Ungiiltiges  Kommando) 

$21 

Invalid  Address  (Ungiiltige  Blockadresse) 

$23 

Volume  Overflow  (Ungiiltige  Block-Endadresse) 

$24 

Invalid  Argument 

$25 

Invalid  Drive  Number  (falsche  Geratenummer) 

$26 

Byte  zero  Parity  Check 

$28 

Cartridge  changed  (Platte  wurde  gewechselt) 

$2C 

Error  Count  overflow 

$30 

(Fehlerzahler  hat  die  vereinbarte  Zahl  von  Fehlem  iiberschritten) 

Sonstige  Fehler 

Controller  Selftest  failed 
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Befehl:  Format  drive  ($4) 


Byte  0: 

N 

N 

N 

0 

0 

1 

0 

0 

Byte  1: 

D 

D 

D 

G 

G 

0 

F 

0 

Byte  2: 

V 

V 

V 

V 

V 

V 

V 

V 

(Virgin-Byte) 

Byte  3: 

I 

I 

I 

I 

I 

I 

I 

I 

(Interleave-Faktor 

High-Byte) 

Byte  4: 

I 

I 

I 

I 

I 

1 

I 

I 

(Interleave-Faktor 

Low-Byte) 

Byte  5: 

0 

0 

0 

0 

0 

0 

0 

0 

Mit  nur  einem  Befehl  kann  man  die  gesamte  Harddisk  formatieren.  Dabei  greift  der  Hard- 
Disk-Controller  entweder  auf  die  Format-Informationen  zuriick,  die  vorher  mit  dem  Befehl 
“Mode  select”  ubertragen  wurden,  oder  liest  sich  diese  von  der  Platte. 

Bei  geloschtem  “F”-Bit  in  Byte  1  werden  die  Sektoren  mit  einem  “  Virgin”-Wert  von  $6C  be- 
schrieben,  wahrend  bei  gesetztem  “F”-Bit  der  Wert  in  Byte  2  als  “Virgin”-Byte  genommen 
wird. 

Sind  die  beiden  “G”-Bits  im  Byte  1  gesetzt,  so  kann  dem  Festplattencontroller  noch  eine  max. 
1 024  Byte  lange  Liste  mit  Daten  iiber  defekte  S  tellen  auf  der  Platte  im  DMA-Betrieb  hinterher- 
geschickt  werden.  Der  Controller  iiberspringt  diese  Defektstellen  bei  der  Formatierung.  Bei 
dem  z.  Zt.  verwendeten  Controller  in  den  Atari-Hard-Disks  ist  diese  Liste  wie  folgt  aufgebaut: 


Byte 

Bedeutung 

$00 

$01 

$02. .$03 

Null  (Reserviert) 

Null  (Reserviert) 

Lange  der  Defektliste  in  Bytes 

$04..$06 

$07 

$08..$0B 

Zylindemummer  des  ersten  Defekts 

Kopfnummer  (normalerweise  0..3) 

Entfernung  d.  Defekts  v.  Indeximpuls  in  MFM-Bytes 

$0C..$0E 

$0F 

$10..$13 

Zylindemummer  des  naehsten  Defekts 

Kopfnummer 

Entfernung  d.  Defekts  v.  Indeximpuls  in  MFM-Bytes 

Die  Bytes  3. .4  des  Command-Descriptor-Blocks  enthalten  den  Wert  fiir  den  Interleave-Faktor 
(max.  16). 
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Befehl: 

Read  Sector  ($8) 

Byte  0: 

N 

N 

N 

0 

1 

0 

0 

0 

Byte  1: 

D 

D 

D 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
High-Bits) 

Byte  2: 

B 

B 

B 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
Mid-Bits) 

Byte  3: 

B 

B 

B 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
Low-Bits) 

Byte  4: 

L 

L 

L 

L 

L 

L 

L 

L 

(Blockanzahl) 

Byte  5: 

0 

0 

0 

0 

0 

0 

0 

0 

Es  wird  ab  der  in  den  Bytes  1  ..3  angegebenen  log.  Blockadresse  die  in  Byte4  angegebene  Zahl 
von  Blocken  mit  je  512  Bytes  gelesen. 


Befehl: 

Write  Sector 

($A) 

Byte  0: 

N 

N 

N 

0 

1 

0 

1 

0 

Byte  1: 

D 

D 

D 

B 

B 

B 

B 

B 

(log.  Blockadresse 
High-Bits) 

Byte  2: 

B 

B 

B 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
Mid-Bits) 

Byte  3: 

B 

B 

B 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
Low-Bits) 

Byte  4: 

L 

L 

L 

L 

L 

L 

L 

L 

(Blockanzahl) 

Byte  5: 

0 

0 

0 

0 

0 

0 

0 

0 

Es  wird  ab  der  in  den  Bytes  1..3  angegebenen  Blockadresse  die  in  Byte  4  angegebene  Zahl 


von  Blocken  (mit  je  512  Bytes)  geschrieben. 

Befehl:  Seek  Block  ($B) 

Byte  0: 

N 

N 

N 

0 

1 

0 

1 

1 

Byte  1: 

D 

D 

D 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
High-Bits) 

Byte  2: 

B 

B 

B 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
Mid-Bits) 

Byte  3: 

B 

B 

B 

B 

B 

B 

B 

B 

(log.  Blockadresse, 
Low-Bits) 
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Befehl:  Seek  Block  ($B) 


Byte  4: 

0 

0 

0 

0 

0 

0 

0 

0 

Byte  5: 

0 

0 

0 

0 

0 

0 

0 

0 

Die  in  den 

Bytes  1. 

.3  angegebene 

Blockadresse  wird 

angesteuert. 

Befehl: 

Mode  select  ($15) 

Byte  0: 

N 

N 

N 

1 

0 

1 

0 

1 

Byte  1 : 

D 

D 

D 

0 

0 

0 

0 

0 

Byte  2: 

0 

0 

0 

0 

0 

0 

0 

0 

Byte  3: 

0 

0 

0 

0 

0 

0 

0 

0 

Byte  4: 

L 

L 

L 

L 

L 

L 

L 

L 

(Parameteranzahl 
in  Bytes\) 

Byte  5: 

0 

0 

0 

0 

0 

0 

0 

0 

Dem  Controller  wird  eine  Liste  mit  Parametem  fiir  das  entsprechende  Plattenlaufwerk  iiber- 
mittelt. 

Die  Lange  der  Liste  steht  in  Byte  4  des  Command-Descriptor-Blocks. 

Per  DMA  wird  dem  Controller  vom  ST  dann  ein  Parameterblock  mit  folgendem  Inhalt  ge- 
schickt: 


Byte 


Bedeutung 


$00 

$01 

$02 

$03 


Reserviert  (=$00) 

Reserviert  (=$00) 

Reserviert  (=$00) 

Lange  der  folgenden  Extent-Descriptor-List  (=8  Bytes) 


Die  im  AnschluB  folgende  Extent-Descriptor-List  hat  folgenden  Aufbau: 


Byte 

Bedeutung 

$00 

Density  (=$00) 

$01 

Reserviert  (=$00) 

$02 

Reserviert  (=$00) 

$03 

Reserviert  (=$00) 

$04 

Reserviert  (=$00) 

Das  Atari  Computer  System  Interface  (ACSI) 
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Byte 

Bedeutung 

$05 

SektorgroBe  (High-Byte) 

$06 

SektorgroBe  (Mid-Byte) 

$07 

SektorgroBe  (Low-Byte) 

Die  SektorgroBe  bei  ATARI-Festplatten  betragt  512  Bytes.  AnschlieRend  an  diese  beiden 
Blocke  darf  noch  eineListe  mit  Laufwerksparametem  angehangt  werden,  die  folgendermaBen 
aufgebaut  sein  muB: 


Byte 


Bedeutung 


$00 

$01. .$02 
$03 

$04,.$05 

$06..$07 

$08 


$09 


Format-Code  (1  ^Festplatte,  2=Wechselplatte) 

Anzahl  der  Zylinder  (bei  SH205/MEGAFILE  30  normalerweise  6 12... 664) 
Zahl  der  Schreib-ZLesekopfe  (bei  SH205/MEGAFILE  30  =  4) 

Nummer  des  Zylinders,  ab  dem  mit  reduziertem  Schreibstrom  gearbeitet  wird 
Nummer  des  Zylinders,  ab  dem  mit  Schreib-Precompensation  gearbeitet  wird 
Abstand  der  Landezone  vom  ersten  (oder  letzten)  Datenzylinder.  Bei  gesetztem 
Bit  8  liegt  die  Landezone  am  auBeren  Rand  der  Platte,  sonst  jenseits  der  inner  - 
sten  Spur.  Die  unteren  sieben  Bits  geben  an,  wie  viele  Zyl  inder  vom  ersten/letz- 
ten  Datenzylinder  entfemt  die  Landezone  fiir  die  Kopfe  eingerichtet  ist. 
Steprate.  Bei  Atari-Hard-Disks  sind  drei  Einstellungen  mdglich: 


$00  =  3  Millisekunden 

$01  =  28  Mikrosekunden  (Buffered  Seek!) 

$02  =12  Mikrosekunden  (Buffered  Seek!)  =  Standardeinstellung 


$0A 


$0B 


In  diesem  Byte  sind  nur  die  Bits  2  und  3  relevant. 


Bytewert 

Bedeutung 

00000000 

Softsektorierte  Wechselplatte 

00000  1  00 

Softsektorierte  Festplatte  =  Standardeinstellung 

00001000 

Hardsektorierte  Wechselplatte  (?) 

0000 1 100 

Hardsektorierte  Festplatte  (?) 

Anzahl  der  Sektoren/Spur.  Ublicherweise  ist  dieser  Wert  bei  der  SH205  auf  1 7 
eingestellt  Bei  einem  Interleave  >  1  kann  man  auch  18  Sektoren/Spur  unter- 
bringen  und  so  die  Plattenkapazitat  erhohen, 

Dabei  muB  man  aber  mit  einem  etwas  langsameren  Zugriff  rechnen  (wegen  des 
hoheren  Interleave-Faktors). 
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Wenn  diese  Parameter  mit  dem  Mode-select-Kommando  iibertragen  wurden,  kann  mit  einem 
nachfolgenden  Format-Befehl  ($4)  die  Platte  mit  den  eingestellten  Parametem  formatiert  wer- 
den.  Nach  dem  Formatieren  werden  die  neuen  Parameter  in  Spur  0  der  Platte  abgelegt. 


Befehl: 

Byte  0: 

Mode  sense  ($1A) 

N  N  N 

1 

1 

0 

I 

0 

Byte  1: 

D 

D 

D 

0 

0 

0 

0 

0 

Byte  2: 

0 

0 

0 

0 

0 

0 

0 

0 

Byte  3: 

0 

0 

0 

0 

0 

0 

0 

0 

Byte  4: 

L 

L 

L 

L 

L 

L 

L 

L 

(Parameteranzahl 

Byte  5: 

0 

0 

0 

0 

0 

0 

0 

0 

in  Bytes\) 

Dieser  Befehl  funktioniert  genau  umgekehrt  wie  Mode  select.  Es  werden  die  Parameter  der 
Platte  aus  der  Spur  0  ausgelesen  und  per  DMA  an  den  ST  iibermittelt. 


Der  Stand  der  Dinge  -  Das  Status-Byte 

Wie  ja  schon  mehrmals  vorher  erwahnt,  wird  jede  Operation  mit  dem  Senden  eines  Status- 
Bytes  an  den  ST  abgeschlossen.  Dieses  Status-Byte  enthalt  in  den  ersten  drei  Bits  die  Nummer 
des  Targets,  von  dem  das  Status-Byte  stammt.  Die  niedrigwertigen  fiinf  Bits  enthalten  einen 
Error-Code,  wobei  jedes  Bit  eine  bestimmte  Information  iiber  den  Stand  der  ausgefiihrten 
Operation  liefert. 

DDDEE  EEE  Status-Byte 

^ ^  ^ -  =  0  (Reserviert) 

-  CHECK-Bit  (gesetzt,  wenn  ein  Fehler  aufgetre- 

ten  ist) 

I— - —  CONDITION  MET  (tritt  bei  ATARI-Hard- 

Disks  nicht  auf) 

-  BUSY  (gesetzt,  wenn  noch  ein  Kommando  in 

Arbeit  war) 

-  =  0  (Reserviert) 

_  Target-Nummer,  von  dem  das  Status-Byte 

stammt 


Leider  wird  durch  einen  Fehler  im  Hostadapter  der  SH204  auch  bei  Fehlem  immer  ein  Status- 
Byte  von  $00  an  den  ST  iibermittelt.  Bei  der  SH205  erhalt  man  ein  korrektes  Status-Byte. 


Das  Atari  Computer  System  Interface  (ACSI) 
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Der  ST  ergreift  die  Initiative 

Eine  Dateniibertragung  mit  DMA-Betrieb  (Data-in/out-Phase)  auf  dem  ACSI-Bus  mit  dem 

ST  als  Initiator  lauft  nach  untenstehendem  Schema  ab.  Weitere  Einzelheiten  zu  den  einzelnen 

Registem  der  DMA-Einbeit  sind  in  Teil  II,  Kapitel  1,  Abschnitt  “DMA  im  ST”  zu  finden. 

Die  Registerzugriffe  miissen  natiirlich  (ebenso  wie  auf  die  Sytemvariablen)  im  Supervisormodus 

ablaufen, 

-  Urn  die  VBlank-Disk-Routine  vom  DMA-Baustein  femzuhalten,  wird  “flock”  an 
Adresse  $43E  gesetzt. 

-  Das  DMA-Base  und  Counter-Register  (“dmahigh”  an  Adr.  $FF  8609,  “dmamid”  an  Adr. 
$FF  860B  und  “dmalow”  an  Adr.  $PF  860D)  wird  mit  der  Anfangsadresse  fiir  den  zu 
iibertragenden  Datenblock  geladen  (Reihenfolge  Low-,  Mid-,  High-Byte  beachten!). 

-  Loschen  des  FIFO-Buffers  und  des  DMA-Status-Registers  der  DMA-Einheit  durch 
“Klappem”  (0-1-0-  oder  1-0-1-Zustandswechsel)  mit  dem  R/W-Bit  (Bit  8)  im  DMA- 
Mode-Register  (“fifo”  an  Adr.  $FF  8606).  Sinnvollerweise  klappert  man  mit  dem  R/W- 
Bit  so,  daB  nach  dem  Loschen  des  FIFO-Buffers  die  Datentransportrichtung  auch  gleich 
richtig  eingestellt  ist.  Der  “Turbo-Lader”  (DMA-Einheit)  bleibt  vorlaufignoch  gesperrt 
(Bit  7  im  DMA-Mode-Register  gesetzt),  indem  man  einen  DMA-Betrieb  mit  dem  FDC 
“vortauscht”. 

-  Im  DMA-Sector-Counter-Register  (“diskctl”  an  Adr.  $FF  8604)  wird  der  DMA-Einheit 
die  “Arbeitsmenge”,  d.  h.  die  Anzahl  der  zu  iibertragenden  5 12-Byte-Blocks,  mitgeteilt. 
UmZugriff  auf  das  Sector-Counter-Register  zu  bekommen,  muB  im  DMA-Mode-Regi¬ 
ster  das  Bit  4  gesetzt  sein! 

Der  Command-Descriptor-Block  muB  ausgegeben  werden.  Dazu  muB  die  “Durchrei- 
che”  zum  ACSI-Bus  geoffhet  werden.  Also  im  DMA-Mode-Register  das  Bit  3  setzen 
(wir  wollen  an  den  ACSI-Bus)  und  Bit  4  loschen  (“Durchreiche”  offnen). 

-  Ausgabe  des  ersten  Command-Bytes  mit  Low  auf  der  “Al”-Leitung  des  ACSI-Busses 
(Bit  1  im  DMA-Mode-Register  steuert  die  “Al”-Leitung  und  muB  also  in  diesem  Fall 
geloscht  werden),  Warten  auf  Target-Empfangsbestatigung  durch  Low  auf  der  INT- 
Leitung  (evtl.  “Timeout”  auslosen),  die  am  MFP,  Port  15  auflauft  (Adresse  $FF  FA01 
=  “gpip”,  Bit  5  testen!). 


-  Ausgabe  der  weiteren  fiinf  Command-Bytes  im  “Handbetrieb”  (ohne  DM A-Hilfe,  Byte 

fiir  Byte)  mit  High  auf  der  “Al”-Leitung  (Bit  1  im  DMA-Mode-Register  gesetzt)  und 
Abwarten  der  Quittierung  vom  Target  iiber  die  “JNT”-Leitung  (wieder  iiber  Bit  5  in 
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“gpip”  abfragbar).  Nach  dem  Senden  des  letzten  Kommandobytes  kommt  zur  Quittierung 
kein  Signal  iiber  “_INT”,  sondem  erst  wenn  das  Kommando  abgeschlossen  wurde! 

Fiir  die  Ausgabe  der  Command-Bytes  empfiehlt  Atari  eine  “moved”- Anweisung.  Dadurch 
kann  man  die  im  AdreBraum  des  ST  unmittelbar  hintereinanderliegenden  Controller-Access- 
Register  (“disked”  an  Adr.  $FF  8604)  und  DMA-Mode-Register  (“fifo”  an  Adr.  $FF  8606) 
“gleichzeitig”  beschreiben.  Es  ist  wohl  schon  mal  vorgekommen,  daB  der  DM  A-Baustein  des 
ST  bei  zwei  unmittelbar  aufeinander  folgenden  Word-Zugriffen  auf  DMA-Mode-Register 
unddann  auf  das  Controller- Access-Register,  die  CS-Leitung  des  ACSI-Busses  zweimal  akti- 
viert  hat.  Das  fiihrte  dann  im  Target-Controller  verstandlicherweise  zu  einiger  Verwirrung. 

Im  High- Word  des  Long-Zugiffs  steht  dann  der  Wert  fiir  das  Controller- Access-Register  (der 
auf  den  ACSI-Bus  gegeben  wird)  und  im  Low-Word  bereits  die  Einstellung  des  DMA-Mode- 
Registers  fur  das  nachste  Command-Byte. 

-  Nach  Senden  des  Command-Descriptor-Blocks  wird  durch  Loschen  von  Bit  7  im  DMA- 
Mode-Register  der  “Turbo-Lader”  auf  den  ACSI-Bus  geschaltet.  Das  wird  in  der  Regel 
mit  der  Ausgabe  des  letzten  Command-Bytes  gleich  miterledigt! 

Nun  lauft  alles  weitere  nicht  mehr  “per  Hand”  sondem  iiber  den  “Turbo-Lader”  (die 
DMA-Einheit  des  ST),  bis  das  DMA -Sector-Counter-Register  auf  Null  gezahlt  ist.  Es 
sind  dann  alle  vorgesehenen  Datenblocks  iibertragen.  Solange  darf  der  DM  A-Baustein 
aber  nicht  gestort  werden. 

-  Das  Ende  der  DMA-Operation  wird  durch  Low  auf  der  “_INT”-Leitung  an  den  Port  15 
des  MFP  (“gpip”  an  Adr.  $FF  FA01)  gemeldet.  Die  CPU  sollte  also  immer  “ein  Auge” 
auf  diesen  Port  haben. 

-  Zum  Testen  auf  Erfolg  oder  MiBerfolg  der  ganzen  Aktion  wird  das  Status-Byte  des 
Target-Controllers  ausgelesen.  Dazu  ist  der  “Durchgriff”  auf  das  Controller-Access- 
Register  durch  Setzen  des  Bits  3  des  DMA-Mode  Registers  zu  offnen  (Bit  4  muB  geloscht 
sein).  Aus  dem  Controller-Access-Register  (“disked”  an  Adr.  $FF  8604)  kann  nun  das 
Status-Byte  ausgelesen  werden. 

-  Der  DMA-Status  der  Operation  kann  ebenfalls  iiberpriift  werden  (“fifo”  an  Adr.  $FF 
8606  auslesen).  Die  Bits  0..2  sind  bei  korrekt  abgeschlossener  Operation  gesetzt. 

Nun  wird  wieder  auf  Floppy-Zugriff  umgeschaltet  und  damit  der  “Turbo-Lader”  vom 
ACSI-Bus  getrennt  ($0080  ins  DMA-Mode-Register  schreiben).  “flock”  wird  zuriick- 
gesetzt,  urn  die  VBlank-Interrupt-Routine  wieder  an  die  Floppy  zu  lassen. 

So  lauft  der  Datentransport  zwischen  ST  als  Initiator  und  einem  Target  ab. 


Teil  III 


Die  Hardware  des  TT 
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Kapitel  1:  Schneller,  holier,  weiter  - 
Der  Prozessor  MC68030 


In  den  ATARI  TT-Computem  findet  sich  ein  Prozessor  der  MotorolaMC68030-Serie.  Der  Sy- 
stemtakt  fur  den  Prozessor  liegt,  ebenso  wie  der  des  Coprozessors  vom  Typ  MC68882,  bei  32 
MHz. 

Der  MC68030  ist  aufwartskompatibel  zu  seinen  Vorgangem,  verfiigt  jedoch  iiber  einen  we- 
sentlich  hoheren  Integrationsgrad  und  eine  neue  Architektur. 

Hiernureine  stichpunktartige  Auflistung  derEigenschaften  und  Moglichkeiten  des  MC68030: 
Harvard-Architektur  (intern  getrennte  Busse  fur  Adressen  und  Daten). 

-  Getrennte  On-Chip-Cache-Speicher  fur  Daten  und  Befehle  (je  256  Byte). 

Damit  ist  die  interne,  gleichzeitige  Bearbeitung  von  Befehlen  und  Daten  moglich. 

-  Integrierte  PMMU  (Paged  Memory  Management  Unit)  zur  Umsetzung  von  Zugriffen  auf 
logische  Adressen  in  entsprechende  physikalische  Adressen  (wichtig  in  Multitasking- 
Systemen!). 

Vollstandiger  32  Bit  (nicht  gemultiplexter!)  AdreBbus. 

32-Bit-Datenbus. 

-  Erweiterter  B  us-Controller  mit  der  U  nterstutzung  von  drei  verschiedenen  Busbetriebsarten 
(Asynchron,  Synchron  und  Burst  Data  Transfer). 

-  Direkte  Unterstiitzung  des  Coprozessors. 

Da  die  Moglichkeiten  der  MC68030  sehr  vielfaltig  sind,  wiirde  es  den  Rahmen  dieses  Buches 
sprengen,  auf  alle  Eigenschaften  einzugehen. 

Wer  sich  intensiv  und  erschopfend  mit  diesem  Prozessor  beschaftigen  mochte,  sei  auf  das 
“MC68030  Enhanced  32  Bit  Mikroprocessor  User’s  Manual”  hingewiesen.  Auf  nahezu  “hal- 
ber  Profibuchstarke”  wird  dort  nur  der  Prozessor  von  vom  bis  hinten  beleuchtet,  ohne  dabei 
noch  besonders  intensiv  auf  so  “Nebensachliches”  wie  den  Befehlssatz  einzugehen! 
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Hardware 

Im  Gegensatz  zur  MC68000-CPU  in  z.  B.  den  ST(E)-Maschinen  reicht  ein  64pol.  Gehause 
langst  nicht  mehr  fur  alle  Anschliisse  aus  (die  gehen  ja  allein  fiir  den  AdreB-  und  Datenbus 
schon  drauf !).  Verwendet  wird  ein  quadratisches  13x13  Pin-Grid-Gehause  mit  1 22  Anschliis- 
sen !  Eine  Vielzahl  von  Pins  dienen  der  Betriebsspannungszufuhr  und  dem  MasseanschluB,  um 
eine  bessere  Stdrunterdriickung  zu  erreichen. 

In  der  nachfolgenden  Abbildung  ist  dargestellt,  welche  Signale  (nach  Funktionen  geordnet) 
beim  MC68030  herausgefiihrt  sind. 


Abb.  1 .1 :  Prozessorsignale,  nach  Funktionsgruppen  geordnet 


Schneller,  hoher,  welter  -  Der  Prozessor  MC68030 
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Hier  nun  eine  kurze  Beschreibung  der  Signale  und  deren  Bedeutung  bzw,  Verwendung  im 

ATARI  TT  (oder  eben  auch  nicht!): 

Function  Codes  (FCO  ..  FC3)  Hiermit  gibt  die  CPU  bekannt,  auf  welchen  AdreBraum 

(Supervisor  Program/Data,  User  Program/Data  us  w .)  im 
laufenden  Buszyklus  zugegriffen  wird.  Beim  Function- 
code  $7  (alle  Bits  gesetzt)  erfolgt  ein  Zugriff  auf  den 
sogenannten  CPU  address  space  (spezieller  AdreGbe- 
reich  der  CPU).  Das  passiert  unter  anderem  bei  alien 
CPUs  der  MC680XX-Serie  bei  der  Interruptbestatigung 
und  bei  den  MC68020/030-CPUs  wahrend  der  Ausfiih- 
rung  von  Coprozessor-Operationen. 

32  Bit-AdreGbus  (A0 ..  A3|)  Ausgabe  der  Zugriffsadresse  fiir  den  laufenden  Buszyk¬ 

lus.  Three-state- AusgSnge  (Neben  Low-  und  High  kann 
der  AnschluB  auch  noch  Hochohmig  geschaltet  wer- 
den!). 

32  Bit-Datenbus  (Dp ..  D3|)  Transport  der  Daten  mit  8, 1 6, 24  oder  32  Bit  pro  Buszy¬ 

klus.  Three-state,  bidirektional! 

Transfer  Size  (SIZO,  SIZ1)  Statussignal  iiber  die  im  laufenden  Buszyklus  auf  dem 

Datenbus  ilbertragenenBy  tes  ( 1 ..  4  Bytes !).  Three-state- 
Ausgang. 

Bus-Steuersignale 

Operand  Cycle  Start  (_OCS)  Low-aktives  Ausgangssignal,  mit  dem  der  Beginn  des 

ersten  extemen  Buszyklusses  (Zugriff  auf  RAM,  ROM 
usw.)  bei  einem  Operanden- Transfer  angezeigt  wird. 
Wird  nicht  im  TT  verwendet! 

External  Cycle  Start  (_ECS)  Hiermit  wird  der  Beginn  jedes  Buszyklusses  angezeigt. 

Low-aktiver  Ausgang.  Wird  nicht  im  TT  verwendet. 

Read/Write  (R/_W)  Art  des  Buszyklusses.  High  bei  Read,  Low  bei  Write- 

Zugriff.  Three-state-Ausgang. 

Read-Modify- Write  Cycle  (_RMC)  Identifiziert  mit  einem  Low  einen  Buszyklus,  der  nicht 

unterteilbar  ist.  Es  wird  etwas  in  die  CPU  gelesen,  dort 
modifiziert  und  wieder  “weggeschrieben”.  Three-state- 
Ausgang.  Wird  nicht  im  TT  verwendet. 
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Adress  Strobe  (_AS)  Auch  schon  vom  MC68000  bekanntes,  low-aktives  Si¬ 

gnal,  mit  dem  die  Giiltigkeit  der  Adresse  im  laufenden 
Buszyklus  angezeigt  wird.  Three-state- Ausgang. 

Data  Strobe  (_DS)  Low-aktives  Signal.  BeimLesezykluswirddamitsignali- 

siert,  daB  die  exteme  Einheit  Daten  auf  den  Datenbus  zu 
legen  hat.  Wahrend  eines  Schreibzyklusses  zeigt  die 
CPU  mit  einem  Low  die  Giiltigkeit  der  Daten  auf  dem 
Datenbus  an.  Wird  nicht  im  TT  verwendet. 

Data  Buffer  Enable  (_DBEN)  Low-aktives  Ausgangssignal  fur  Systeme  mit  extemen 

(schnellen)  Datenbuffem  (so  eine  Art  exteme  Cache!). 
Damit  konnen  diese  Buffer  freigegeben  werden.  Wird 
nicht  im  TT  verwendet. 

Data  Transfer  and  Size  Acknowledge  (_DSACK0,  _DSACK1) 

Eingange,  Low-aktiv.  Fiir  asynchrone  Buszyklen  ver¬ 
wendet. 

Bei  einem  Lesezyklus  “sagt”  die  exteme  Einheit  (z.  B.  1/ 
O-Baustein)  dariiber  Bescheid,  wenn  die  gewunschten 
Daten  auf  dem  Datenbus  bereitstehen  und  in  welchem 
Format  (8-,  16-  Oder  32-Bit-Format)  das  der  Fall  ist. 

Beim  Schreibzyklus  quittiert  die  ext.  Einheit  die  Uber- 
nahme  der  Datenbits  und  in  welchem  Format  das  gesche- 
hen  ist. 

Bei  z.  B.  einem  Langwort-Lese-Zugriff  (32  Bit)  auf 
einen  8-Bit-Port  wird  der  Port  mit  einer  “Antwort”  von 
_DSACK0  =  Low  und  _DSACK1  =  High  jeden  Zugriff 
quittieren. 

Die  CPU  wird  die  ersten  acht  Bits  einlesen  und  einen 
weiteren  Zyklus  starten,  um  von  diesem  Port  die  nach- 
sten  8  Bits  zu  erhalten.  Das  geht  dann  so  lange  (vierZyk- 
len),  bis  alle  vier  Bytes  in  der  CPU  angekommen  sind! 

Synchronous  Termination  (_STERM) 

Dieser  Eingang  wird  als  Ende-Signal  (Synchronous 
Termination)  fiir  synchrone  Buszugriffe  benutzt. 


Schneller,  hoher,  weiter  -  Der  Prozessor  MC68030 
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Le^ezyklus :  Mit  _STERM  auf  Low  wird  der  CPU  mitge- 
teilt,  daS  die  Daten  auf  dem  Datenbus  mit  der  nachsten 
fallenden  Taktflanke  ge”lachted”  (eingespeichert)  wer- 
den  konnen. 

Schreibzyklus:  Mit  _STERM  =  Low  signalisiert  die  ex- 
teme  Einheit  die  Ubemahme  der  Daten  vom  Datenbus. 


Cache-Steuersignale 

Cache  Inhibit  Input  (_CIIN)  Mit  einem  Low  an  diesen  Eingang  wird  verhindert,  daB 

die  Daten  dieses  Lesezyklusses  in  die  intemen  Caches 
ubemommen  werden. 


Cache  Inhibit  Output  (_CIOUT)  Dieses  Low-aktive  Ausgangssignal  signalisiert  an  even- 

tuelle  ext.  Caches,  die  Daten  des  laufenden  Buszyklusses 
zu  ignorieren.  Wird  nicht  im  TT  verwendet. 


Cache  Burst  Request  (_CBREQ)  Mit  einem  Low-Signal  fordert  die  CPU  das  Auffiillen 

einer  Zeile  (vier  Langworte)  im  Cache  durch  Burst- 
Mode  an.  Three-state-Ausgang. 


Cache  Burst  Acknowledge  LCBACK) 

Die  angesprochene  Einheit  (RAM)  kann  im  Burst-Mode 
arbeitenund  istin  derLage,  mindestens  noch  ein  Langwort 
fiir  die  int.  Caches  zu  liefem. 


Steuersignale  fiir  Interrupts 

Interrupt  Priority  Level  (_IPL0  ..  _IPL2) 

Low-aktive  Eingange,  iiber  die,  wie  beim  MC68000,  die 
“Dringlichkeit”  des  Interrupts  signalisiert  wird. 

Interrupt  Pending  (_IPEND)  MiteinemLowbestatigtdieCPU.daBsiedielnterruptan- 

forderung  intern  registriert  hat  und  dieser  Interrupt  eine 
hohere  Prioritat  besitzt,  als  die  gegenwartige  Interrupt- 
Maske  aufweist. 

Bei  der  nachsten  Gelegenheit  (wenn  intern  der  nachste 
Befehl  an  die  Reihe  kommt)  wird  dann  der  Interrupt 
bearbeitet.  Wird  nicht  im  TT  verwendet. 
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Autovector  ( _AVEC )  Low-aktives  Eingangssignal,  daB  die  CPU  bitte  schon 

einen  Autovektor  zu  erzeugen  hat  (beim  Interrupt-Ack- 
nowledge-Zyklus). 

Steuersignale  fiir  die  Buszuteilung 

Bus  Request  (_BR)  Ein  extemer  Baustein  (z.  B .  DMA)  mochte  gem  den  Bus 

“fiir  sich”  haben.  Dieser  Eingang  ist  Low-aktiv. 

Bus  Grant  (_BG)  Low-aktiver  Ausgang  fiir  die  Signalisierung,  daB  der 

Prozessor  die  Buskontrolle  nach  Ende  des  laufenden 
Buszykiusses  abgeben  wird.  (Bestatigung  auf  das  Bus- 
Request-Signal. 

Bus  Grant  Acknowledge  (_BGACK) 

Ober  diesen  Eingang  erfahrt  die  CPU,  daB  der  Bus  jetzt 
von  jemand  anders  iibernommen  wurde.  Die  neue 
Busmaster-Einheit  belaBt  dieses  Signal  auf  Low,  bis  sie 
den  Bus  wieder  freigibt. 


Signale  fiir  die  Bus-Ausnahmesteuerung 


Reset  CRESET) 


Halt  (_HALT) 


Bus  Enror  (_BERR) 


Bidirektionaler  AnschluB! 

Wenn  von  auBen  ein  Low-Signal  angelegt  wird,  geht  der 
Prozessor  in  den  Grundzustand  zuriick  (Dauer  des  Si¬ 
gnals  mind.  520  Taktperioden).  Wenn  der  Prozessor 
einen  RESET-Befehl  bearbeitet,  bleibt  der  interne  Status 
der  CPU  erhalten,  und  an  diesem  AnschluB  wird  ein 
Low-Impuls  zum  Riicksetzen  der  extemen  Einheiten 
ausgegeben. 

Mit  einem  Low  an  diesem  AnschluB  wird  die  CPU 
“aufgefordert”,  alle  Bus-Aktivitaten  einzustellen.  In  Ver- 
bindung  mit  dem  _BERR-Signal  bedeutet  das  die  Auf- 
forderung,  den  letzten  Buszyklus  nochmal  zu  wiederho- 
len. 

Mit  einem  Low  an  diesem  Eingang  wird  der  Prozessor 
auf  eine  ungiiltige  Busoperation  hingewiesen  (zum  Bei- 
spiel,  weil  eine  ext.  Einheit  innerhalb  einer  gewissen  Zeit 
nicht  auf  einen  Buszyklus  reagiert  hat). 


Schneller,  hoher,  weiter  -  Der  Prozessor  MC68030 
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Signale  fiir  Emulator-Unterstiitzung 

Fur  manche  Emulationen  und  zur  Fehlersuche  ist  es  zwingend  notwendig  zu  wissen,  wie  weit 
die  Abarbeitung  von  Befehlen  im  Prozessor  gediehen  ist  (durch  die  Verwendung  der  Caches 
ist  das  nicht  so  einfach  festzustellen).  Deshalb  sind  einige  Signale  vorgesehen,  die  dabei 
“behilflich”  sind. 


Cache  Disable  (_CDIS) 


MMU  Disable  CMMUDIS) 


Pipeline  Refill  (JREFILL) 


Mit  einem  Low  an  diesem  Eingang  wird  der  MC68030 
“angewiesen”,  seine  intemen  Caches  nicht  zu  verwen- 
den.  Die  Cacheinhalte  werden  dabei  nicht  geloscht, 
sondem  stehen  nach  Ubergang  des  Signals  auf  High 
wieder  unverandert  zur  Verfiigung. 

Durch  ein  Low  an  diesem  Eingang  wird  die  interne 
MMU  auBer  Funktion  gesetzt.  Dabei  werden  die  Eintra- 
ge  im  Address-translation-cache  ( ATC  =  Cachespeicher 
fiir  die  AdreBiibersetzungstabelle)  nicht  geloscht.  Nach 
Entfemen  des  Low-Signals  (also  bei  High)  steht  der 
MMU -Cache  wieder  unverandert  bereit. 

Mit  diesem  Signal  zeigt  der  Prozessor  an,  wenn  die  inter¬ 
ne  Befehlspipeline  wieder  neu  gefullt  wird  (bei  Ande- 
rungen  im  Programmablauf  zum  Beispiel  bei  bedingten 
Verzweigungen).  Three-state-Ausgang. 


Internal  Microsequencer  Status  (_STATUS) 

Mit  einem  Low  unterschiedlicher  Dauer  signalisiert  die 
CPU  an  diesem  AnschluB,  ob  sie  gerade  am  Ende  einer 
Befehlsbearbeitung  ist  (Low  fur  einen  Taktzyklus),  ob 
eine  Trace-  oder  Interrupt-Ausnahmeverarbeitung  an- 
steht  (Low  fiir  zwei  Taktzyklen)  oder  daB  eine  andere 
Ausnahmeverarbeitung  begonnen  wird  (Low  fiir  drei 
Taktzyklen). 

Nicht  zu  vergessen  ist  natiirlich  der  TaktanschluB,  der  im  TT  mit  32  MHz  und  TTL-Pegel 
gespeist  wird. 


Der  MC68030  im  TT 

Der  TT  ist  von  seinem  Aufbau  her  (ROM,  RAM  usw.)  auf  1 6  MHz  ausgelegt.  Atari  hat  jedoch 
schon  kurz  nach  Auslieferung  der  ersten  TT-Rechner  mit  16  MHz  an  Softwarehauser  eine 
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T akterhbhung  fiir  die  CPU  auf  32  MHz  vorgesehen.  Damit  laufen  also  prozessorinteme 
Vorgange  mit  der  doppelten  Taktfrequenz  ab.  Bei  RAM-  und  ROM-Zugriffen  sind  aufgrund 
des  restlichen  Systemdesigns  jedoch  entsprechende  Waitstates  beim  Zugriff  erforderlich. 

Da  das  TT -Platinenlayout  zunachst  fiir  eine  1 6-MHz-CPU  vorgesehen  war,  ist  fiir  die  Umrii- 
stung  auf  32  MHz  von  Atari  eine  eigene  Aufsatzplatine  zur  Anwendung  gekommen.  Auf 
dieser  Platine  befinden  sich  sowohl  die  CPU  als  auch  einige  PALs  und  FlipFlops  in  SMD-B  au- 
weise  zur  Anpassung  an  das  “langsamere  Umfeld”.  Uber  einen  PGA-Stecker  wird  die  Platine 
direkt  in  die  Fassung  fiir  den  MC68030  auf  dem  Motherboard  gesteckt.  Die  Zufiihrung  des  32- 
MHz-Taktes  erfolgt  iiber  eine  separate  Taktleitung  vom  Taktoszillator  auf  der  Hauptplatine. 
In  Zukunft  wird  das  Platinenlayout  des  Motherboards  gleich  fiir  den  32-MHz-Betrieb  des  Pro- 
zessors  und  des  Coprozessors  ausgelegt  sein.  Die  Anpassungsplatine  entfallt  dann. 


Der  interne  Aufbau  des  MC68030 

soil  hier  nur  kurz  durch  eine  Ubersicht  iiber  die  Register  gestreift  werden. 

Im  User-Modus  stellt  sich  der  MC68030  genau  wie  der  “gute  alte”  MC68000  im  ST(E)  dar. 
Die  gleichen  acht  Daten-  und  acht  AdreBregister  mit  je  32  Bits  Breite  sind  auch  hier  zu  finden. 
Programmzahler  und  die  unteren  acht  Bits  des  Statusregisters  (das  Condition  Code-Register) 
sind  genauso  aufgebaut  und  zu  betrachten  wie  beim  MC68000! 

Es  sind  jedoch  eine  Anzahl  von  neuen  Adressierungsarten  hinzugekommen,  wie  z.  B.  die 
Moglichkeit,  sowohl  Daten-  als  auch  AdreBregister  als  Indexregister  zu  verwenden.  In  der  Su- 
pervisor-Betriebsart  kommen  aber  die  zusatzlichen  Register  der  CPU  erst  richtig  zum  Tragen. 

Eine  Besonderheit  gegeniiber  dem  MC68000  ist  das  Vektor  Base  Register  ( VBR ).  Es  enthiilt 
die  Anfangsadresse  der  Tabelle  fiir  die  Ausnahmevektoren  (1  KByte  lang).  Zu  dem  Eintrag 
in  diesem  Basisregister  wird  dann  der  Versatz  fiir  den  angesprochenen  Ausnahmevektor  dazu- 
addiert  und  so  der  Pointer  auf  die  Adresse  gebildet,  in  der  die  Anfangsadresse  fiir  die  Ausnah- 
meverarbeitungs-Routine  abgelegt  ist.  Damit  muB  also  die  Tabelle  fiir  die  Ausnahmevektoren 
nicht  mehr  zwingend  an  der  absoluten  Adresse  $8  beginnen  wie  beim  MC68000  (was  sie  im 
TOS  des  TT  aber  weiterhin  tut)! 

Im  Supervisor-Modus  stehen  nun  zwei  Stackpointer  zur  Verfiigung.  Im  “normalen”  Supervisor- 
Modus,  wie  er  z.  B.  nach  einem  RESET  eingestellt  ist,  wird  der  Interrupt  StackPointer  (ISP) 
verwendet.  Umschalten  auf  den  Master  Stack  Pointer  (MSP )  laBt  sich  im  Supervisor-Modus 
durch  Setzen  des  M-Bits  im  Status-Register.  Die  Belegung  des  Statusregisters  ist  nur  im  Sta- 
tusbyte  (Supervisor-Modus)  geiindcrt  (erweitert)  worden  und  sieht  wie  auf  der  iibemachsten 
Seite  aus. 


Schneller,  hoher,  weiter  -  Der  Prozessor  MC68030 
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System-Byte 


User  Byte 
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Mit  den  Altemate-Function-Code  Registem  (SFC  und  DFC)  kann  unter  bestimmten  Bedin- 
gungen  der  durch  den  32  Bil-AdreBbus  auf  vier  GByte  erweiterte  AdreBraum  nochmal  ver- 
vielfacht  werden.  Mit  den  je  drei  Bit-Funktionscodes  sind  damit  acht  AdreBraume  zu  je  vier 
GByte  unterscheidbar  (das  sollte  erst  mal  reichen!). 


Geschwindigkeitsgewinn  durch  Caches 

In  den  auf  dem  Chip  integrierten  Caches  werden  immer  ein  Teil  der  bereits  verarbeiteten  Daten 
und  die  im  Moment  in  Bearbeitung  befindlichen  Befehle  zwischengespeichert.  Das  hat  den 
Vorteil,  daB  auf  diese  Informationen  bei  nochmaligem  Bedarf  (z.  B.  wahrend  einer 
Programmschleife)  ohne  einen  extemen  Buszyklus  zugegriffen  werden  kann!  Das  spart 
natiirlich  Zeit  und  erhoht  die  Geschwindigkeit  nicht  unerheblich  (urn  ca.  10..30%).  Fur  das 
Fiillen  der  Caches  wird  vorzugsweise  der  sogenannte  “Burst  fill  mode”  verwendet.  Damit  wird 
jeweils  immer  ein  ganzer  Cacheeintrag  von  1 28  Bit  (vier  Langworte)  mit  einer  sehr  geringen 
Zahl  von  Taktzyklen  geftillt  (giinstigstenfalls  in,/w«/Taktzyklen,  ohne  Waitstates,  sonst  ent- 
sprechend  langer)!  Zu  dieser  Betriebsweise  muB  natiirlich  die  Speicherhardware  in  der  Lage 
sein  (was  im  TT  teilweise  der  Fall  ist). 

Caches  konnen  nach  verschiedenen  Prinzipien  arbeiten,  “Voll-assoziativ-Caches”  verglei- 
chen  zur  Uberpriifung,  ob  z.  B.  der  Befehl  unter  einer  bestimmten  Adresse  im  Cache  vorliegt, 
die  gesamte  Adresse.  Im  MC68030  wird  nach  dem  “Teil-assoziativ-Prinzip”  gearbeitet.  Dabei 
wird  immer  nur  ein  Teil  der  gewiinschten  Adresse  verglichen.  Es  wird  namlich  unter  einem 
Cacheeintrag  immer  ein  Block  von  vier  Langwords  verwaltet.  Damit  reduziert  sich  dererfor- 
derliche  Hardwareaufwand  in  der  Vergleicherlogik  nicht  unerheblich,  ohne  einen  merklichen 


Schneller,  hoher,  weiter  -  Der  Prozessor  MC68030 
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Verlust  in  der  Trefferquote  und  der  Geschwindigkeit  hinnehmen  zu  miissen.  Der  MC68030 
verwendet  aus  diesem  Grande  auch  bevorzugt  den  bereits  erwahnten  Burst-fill-Modus,  um  so 
jeweils  mit  einem  schnellen  Zugriff  auf  den  extemen  Speicher  einen  Cacheeintrag  aufzufri- 
schen. 

Ein  Cache  ist  also  nur  bei  wiederholbaren  Programmsequenzen  effektiv.  Dabei  darf  die 
Sequenzlange  aber  nicht  die  Grofie  des  Cache  iibersteigen,  weil  sonst  die  Cacheeintrage 
standig  iiberschrieben  werden.  Gleiches  gilt  fiir  Spriinge  auBerhalb  der  AdreBdistanz  des 
Cache.  Ein  paar  Nachteile  lassen  sich  dabei  durch  gescfr.ckten  Umgang  mit  dem  Cache 
Control  Register  (CACR)  und  dem  Cache  Address  Register  (CAAR)  vermeiden. 


0 

0 

WA 

DBE 

CD 

CED 

FD 

ED 

0 

0 

IBE 

Cl 

CEI 

FI  El 

WA  =  Write  Allocate 
DBE  -  Data  Burst  Enable 
CD  =  Clear  Data  Cache 
CED  =  Clear  Entry  in  Data 

FD  =  Freeze  Data  Cache 
ED  =  Enable  Data  Cache 


IBE 

Cl 

Cache  CEI 

FI 

EF 


=  Instruction  Burst  Enable 

-  Clear  Instruction  Cache 
=  Clear  Entry  in 

Instruction  Cache 
=  Freeze  Instruction  Cache 

-  Enable  Instruction  Cache 


Das  Cache-Control-Register 

(Das  High-Word  des  Registers  ist  Null!) 

Mit  dem  Cache  Control  Register  ist  das  Spenren  (ED-  bzw.  El-Bit),  Einfrieren  (FD-  bzw.  FI- 
Bit)  und  das  Loschen  des  gesamten  Caches  (CD-  bzw.  CI-Bit)  moglich,  Unter  Einfrieren 
versteht  man,  daB  sich  der  Cache  wie  ein  ROM  verhalt.  Bei  Treffem  werden  wohl  die  Cache- 
informationen  gelesen,  aber  nicht  iiberschrieben. 

Es  konnen  auch  einzelne  Cacheeintrage,  die  iiber  das  Cache  Address  Register  (CAAR) 
bestimmt  werden,  durch  Manipulation  mit  dem  CED-  bzw.  CEI-Bit  gezielt  geloscht  werden. 
Durch  die  spezielle  Organisation  des  Caches  ist  es  lediglich  erforderlich,  die  Bits  1.2  des 
AdreBeintrags  in  die  Bits  1.2  des  CAAR  einzuschreiben. 

Damit  ist  der  entsprechende  Cache-Eintrag  zum  Loschen  identifiziert!  Die  anderen  Bits  im 
32-Bit  groBen  CAAR  sind  fiir  zukiinftige  Verwendung  durch  Motorola  reserviert  (und  werden 
zur  Zeit  noch  nicht  ausgewertet!). 

Das  DBE-  bzw.  EBE-Bit  signalisiert  der  Bus-Control-Logik  des  Prozessors,  ob  der  Burst-fill- 
Modus  moglich  ist. 
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Adressen  gibt’s,  die  gibt’s  gar  nicht  -  Die  PMMU 

HauptsMdichesEinsatzgebietfurMemoo'Manugemertrt/wV.sYMMt/jistdieAdreBumsetzung 
von  logischen  Adressen  in  real  existierende,  also  physikalische  Adressen,  bei  Multitasking- 
Systemen.  Dabei  kommt  es  halt  vor,  daB  mehrere  Prozesse  (Tasks)  parallel  bearbeitet  werden 
sollen.  Da  in  Systemen  mit  nur  einem  Prozessor  dieser  sich  immer  nur  zur  gleichen  Zeit  um 
einen  Prozefi  kiimmem  kann,  mufi  eine  Umschaltung  zwischen  einzelnen  Tasks  z.  B.  zeit- 
gesteuert  erfolgen.  Um  die  Umschaltzeiten  gering  zu  halten,  ist  es  natiirlich  von  Vorteil,  daB 
die  Tasks  sich  im  Arbeitsspeicherbefinden.  Das  wiirde  bedeuten,  das  diese  T asks  alle  an  unter- 
schiedliehen  Adressen  stehen  miissen  und  Uberlappungen  ebenfalls  nicht  erlaubt  sind. 

Da  diese  Bedingungen  sehr  einschrankend  sind,  weicht  man  auf  den  Einsatz  einer  MMU 
zwischen  Prozessor  und  Speicher  aus.  Diese  sorgt  dafiir,  daB  unterschiedliche  Tasks  mit 
gleichen  logischen  Adressen  arbeiten  konnen,  welche  dann  durch  die  MMU  durch  Umsetzung 
in  entsprechende  physikalische  Adressen  umgerechnet  werden. 

Eine  weitere  Binsatzmoglichkeit  fiir  MMUs  sind  virtuelle  Speicherkonzepte.  Damit  sind  Zu- 
griffe  auf  Adressen  moglich,  die  eigentlich  gar  nicht  real  (als  Halbleiterspeicherstelle)  existie- 
ren,  sondem  nur  “scheinbar”  (virtuell)  vorhanden  sind.  Zugriffe  auf  solche  virtuellen  Adressen 
geschehen  meistens  auf  Massenspeicher  wie  Harddisks. 

Der  Zugriff  auf  so  eine  virtuelle  Adresse  fiihrt  also  zunachst  zu  einer  Fehlersignalisierung,  weil 
die  Adresse  real  nicht  existiert.  Dann  sorgt  das  Betriebssystem  durch  eine  Ausnahmebehandlung 
dafiir,  daB  die  benotigten  Daten  dieser  Speicherstellen  vom  Massenspeicher  in  einen  freien 
Speicherbereich  im  RAM  geladen  werden.  Die  MMU  sorgt  dann  nach  entsprechender  Pro- 
grammierung  dafiir,  daB  der  Zugriff  auf  die  virtuelle  Adresse  auch  auf  die  real  existierende 
Speicherstelle  im  RAM  umgerechnet  wird! 

Die  im  MC68030  integrierte  MMU  benutzt  fiir  die  AdreBumsetzung  Tabellen  fiir  die  phy- 
sikalischen  Adressen,  die  im  Speicher  angelegt  werden.  Die  logische  Adresse  dient  dabei  als 
Index  in  dieser  Tabelle.  Damit  hier  nicht  jedesmal  ein  ext.  Buszyklus  erforderlich  wird,  ist  zur 
Beschleunigung  noch  ein  Cachespeicher  hinzugefiigt  worden  (der  Address  Translation 
Cache,  ATC ),  in  dem  haufxg  benutzte  Umsetzungen  aufbewahrt  werden  (22  Eintrage  umfaBt 
der  ATC!). 

Erst  wenn  die  Umsetzung  mittels  des  ATC  nicht  vorgenommen  werden  kann,  wird  die  im 
RAM  liegende  Tabelle  benutzt.  AuBerdem  existieren  fiir  Zugriffe  auf  Speicherblocke,  die 
keiner  Umsetzung  unterliegen  sollen,  zwei  Transparent  Translation  Register  (TTO  und  TT1 ). 

Jede  einzelne  log.  Adresse  verbraucht  fiir  die  Umsetzung  in  ihre  physikalische  Adresse  natiir- 
lich  nicht  einen  ganzen  Eintrag. 


Schneller,  hoher,  weiter  -  Der  Prozessor  MC68030 
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Abb.  1.3:  Das  Programmiermodell  der  M MU 


Vielmehr  wird  der  Speicherbereich  der  CPU  in  gleich  grofie  Blocke  (Pages)  unterteilt  (beim 
MC68030  konnen  diese  256  Byte..32  KByte  gTofi  sein,  im  TT-TOS  wird  die  PMMU  auf  32 
KByte-Pages  eingestellt),  und  die  AdreBumsetzung  erfolgt  dementsprechend  blockweise, 
Deshalb  wird  die  Memory  Management  Unit  im  MC68030  auch  als  Paged  Memory 
management  Unit  ( PMMU )  bezeichnet.  Jede  Page  von  log.  Adressen  wird  also  in  einen  gleich 
groBen  Block  von  physikalisehen  Adressen  umgerechnet.  Das  Ganze  laBt  sich  durch  Glie- 
derung  in  mehrere  Umsetzungsebenen  (maximal  fiinf  sind  moglich)  sehr  flexibel  handhaben 
und  spart  auBerdem  drastisch  Speicherplatz  fur  die  Umsetzungstabellen  ein.  Am  Ende  der 
“Pointerei”  durch  die  einzelnen  Ebenen  findet  die  MMU  dann  endlich  die  Adresse  der  ge- 
wiinschten  Page  (als  Page-Deskriptor  bezeichnet). 

So  existieren  denn  zwei  grundsatzlicheTypen  von  Datenstrukturen,  sogenannte  Deskriptoren. 
Der  Page-Deskriptor  enthalt  die  gewiinschte  physikalische  Umsetzungsadresse  (bzw.  die 
oberen  24  Bits  davon,  die  unteren  8  Bits  werden  von  der  logischen  Adresse  genommen!)  und 
befindet  sich  am  Ende  einer  Umsetzungstabelle!  Als  Tabellen-Deskriptor  wird  ein  Eintrag 
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bezeichnet,  der  in  den  oberen  24  Bits  die  AdreBbits  fur  den  Pointer  auf  eine  weitere  Deskriptor- 
Tabelle  enthalt. 

Die  beiden  Root-Pointer  (CPU -Root-Pointer  und  Supervisor-Root-Pointer)  enthalten  dabei 
den  Zeiger  auf  den  Beginn  der  Tabelle  im  Speicher.  Der  CPU -Root-Pointer  ( CRP )  wird  dabei 
fur  Anwenderprogramme  (User-Modus)  und  der  Supervisor-Root-Pointer  (SRP)  im  Super- 
visormodus  flir  (na,  raten  Sie  doch  mal?  Richtig!)  Systemprogramme  benutzt. 


uu 

INDEX-LIMIT 

0 

0  DT 

Tabellenadresse  (PA31  -  PA16) 

Tabellenadresse  (PA15  -  RA4) 

nicht 

benutzt 

uu 

DT 

INDEX-LIMIT  = 
Tabellenadresse  = 


Obere  Oder  untere  Seitenbegrenzung 
Deskriptorart 

Grenzwert  fur  Tabellenindex  fur  diese 
Tabellenadresse 

Tabellenadresse  der  nachsten  Ebene 
oder  Seitenoffset,  wenn  DT=1 


Abb.  1.4:  Der  Aufbau  des  Root-Pointers 


DaB  diese  beiden  Pointer  64  Bit  groB  sind,  liegt  daran,  daB  auBer  dem  Pointer  auf  den  Tabellen- 
beginn  im  Speicher  auch  noch  weitere  Informationen  enthalten  sind.  Die  eigentliche  Tabellen¬ 
adresse  umfaBt  dabei  sogar  nur  28  Bits,  womit  sich  die  Einsehrankung  ergibt,  daB  diese  Tabelle 
an  einer  durch  16  teilbaren  Adresse  beginnen  mufi. 

Die  Bits  32.33  bilden  den  sogenannten  Descriptor  type  (DT).  Ein  Wert  von  $1  deutet  dabei 
auf  eine  Tabelle  im  Speicher  hin,  die  mit  Page-Deskriptoren  gefullt  ist.  Der  Wert  von  $0  ist 
beim  Root-Pointer  nicht  zulSssig;  er  markiert  einen  Deskriptor  im  Speicher  als  INVALID 
(fuhrt  dazu,  daB  die  weitere  Tabellensucherei  an  der  Stelle  abbricht!). 

Die  anderen  moglichen  Werte  fur  DT  deuten  darauf  hin,  daB  der  Tabellenbereich,  auf  den 
verwiesen  wird,  im  Short-format  (vier  Bytes/Eintrag  bei  DT  =  $2)  oder  im  Long-format 
(acht  Bytes/Eintrag  bei  DT  =  $3)  vorliegt.  Das  hochstwertige  Bit  (LIU- Bit)  im  Rootpointer 
(wie  auch  bei  einem  Long-format-Tabelleneintrag)  gibt  dann  an,  ob  durch  das  15  Bit-Feld  in 
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den  Bits  48. .62  das  obere  (L/U  =  0)  oder  untere  (L/U  =  1)  LIMIT  des  Indexes  in  der  Tabelle 
angegeben  ist.  Was  bedeutet,  daB  z.  B.  bei  L/U  =  0  der  Index  in  die  folgende  Tabelle  den 
LIMIT-Wert  nicht  iiberschreiten  darf. 

In  den  Deskriptoren,  die  in  der  Tabelle  im  Speicher  stehen,  existieren  je  nach  Art  (wie  z.  B. 
Short-  oder  Long-format-Tabellen-  bzw.  Page-Deskriptoren)  noch  weitere  Steuer-  bzw.  Sta¬ 
tus-Bits  am  Ende  des  oberen  Deskriptor-Langworts  bzw.  am  Ende  des  Short-format-Deskrip- 
tors.  Das  U- Bit  (Used-Bit)  wird  von  der  MMU  gesetzt,  wenn  der  zugehorige  Deskriptor  fur 
eine  AdreBumrechnung  gebraucht  wurde. 

Mit  gesetztem  WP- Bit  (Write  Protect-Bit)  wird  signalisiert,  daB  auf  die  letztlich  gefundene 
physikalische  Adresse  nicht  geschrieben  werden  darf.  Das  gesetzte  C7-Bit  (Cache  /nhibit-Bit) 
sorgt  dafiir,  daB  bei  Zugriff  auf  diese  Page  die  Umsetzung  nicht  in  den  ATC  iibemommen  wird 
(z.  B .  weil  sich  dahinter  Hardware- Adressen  verbergen,  die  sich  ohne  Beeinflussung  der  CPU 
andem  konnen).  Mit  einem  gesetzten  M- Bit  (Modified  Bit)  gekennzeichnete  Page-Deskriptoren 
signalisieren,  daB  durch  einen  Schreibzugriff  Speicherstellen  in  dieser  Page  verandert  wurden. 

Das  Translation  Control  Register  (TC )  besitzt  mehrere  Bitfelder,  die  z.  B.  fiir  das  Umschalten 
zwischen  CRP  und  SRP,  GroBeneinstellung  der  Pages,  Festlegung  der  Anzahl  der  Bits,  die  fiir 
die  AdreBumsetzung  benutzt  werden  sollen,  und  die  Struktur  der  Umsetzungstabelle  verwen- 
det  werden. 

Die  Register  TTO  und  7T 1  legen  “Fenster”  einstellbarer  GroBe  im  AdreBraum  fest,  fiir  die  kei- 
nerlei  AdreBumsetzung  stattfinden  soil.  Dabei  kann  auGerdem  festgelegt  werden,  ob  jedes  die¬ 
ser  Fenster  nur  fiir  lesende  oder  schxeibende  oder  beide  Betriebsweisen  gelten  soil. 

ImMe/noryManageweft/Stoto/fcgBrer/MMt/SPjschlieBlichfindetmanStatusinformationen 
iiber  die  Suche  aus  AnlaB  einer  AdreBiibersetzung  im  ATC  oder  dem  Umsetzungsbaum. 

Auf  weitere  Einzelheiten  zur  MMU  einzugehen  ware  zu  umfangreich.  Dafiir  empfiehlt  sich 
das  bereits  weiter  oben  erwahnte  “MC68030  Enhanced  32  Bit  Mikroprocessor  User’s  Manu¬ 
al”,  wo  auf  nahezu  100  Seiten  die  MMU  durchleuchtet  wird. 

Im  TT-TOS  beschrankt  sich  der  Einsatz  der  MMU  ohnehin  eigentlich  nur  auf  das  Simulieren 
des  ST-AdreBraums.  Das  lauft  dann  darauf  hinaus,  dem  MC68030  einen  mehr  oder  weniger 
zum  ST  kompatiblen  Speicherraum  vom  16  MByte  vorzutauschen.  So  sollen  sich  eben  z.  B. 
in  den  letzten  32  KByte  des  ST-AdreBraums  auch  beim  TT  die  ST-Hardwareregister  wie- 
derfinden,  dieaber  physikalisch  eigentlichin  den  letzten  32  KByte  des  MC68030-Speicherraums 
liegen  (und  auch  dort  nochmals  auftauchen!). 


Kapitel  2:  Damit’s  noch  schneller  geht  - 
Der  Coprozessor  MC68882 


Im  ATARI  TT  verrichtet  neben  der  MC68030-CPU  noch  ein  weiterer  Prozessorbaustein 
semen  Dienst.  Er  besitzt  einen  Befehlssatz  von  “nur”  64  Instruktionen,  daftir  sind  diese  aber 
sehr  hilfreich,  wenn  es  um  schnelle  und  komplexe  Berechnungen  geht.  Der  Coprozessor 
wickelt  mathematische  Aufgabenstellungen  wie  z.  B.  sin(x),  log(x)  usw.  mit  einer  sehr  hohen 
Verarbeitungsgeschwindigkeit  und  Genauigkeit  ab. 

Der  Vorteil  bei  der  Verwendung  des  MC68882  (oder  seines  Vorgangers,  des  MC68881)  in 
Verbindung  mit  dem  MC68020/MC68030  liegt  darin,  da8  man  beim  Programmieren  in  der 
Praxis  gar  nicht  mehr  zu  unterscheiden  braucht,  ob  der  entsprechende  Befehl  nun  durch  die 
CPU  oder  den  Coprozessor  ausgefiihrt  wird.  Die  beiden  Chips  spielen  so  elegant  ineinander, 
dafi  man  meint,  nur  einen  einzigen  Prozessor  zu  programmieren,  der  auch  FlieBkommaarithmetik 
beherrscht. 

Motorola  hat  dabei  eine  Schnittstelle  fiir  die  Coprozessor- Anbindung  definiert,  die  ab  den  Pro- 
zessoren  der  MC68020er-Serie  die  Kommunikation  mit  dem  Coprozessor  regelt. 

Im  Gegensatz  zum  MEGA  ST(E)  mit  nachgeriistetem  Coprozessor,  braucht  der  Programmie- 
rer  die  Coprozessor-Interface-Register  nicht  selbst  zu  bedienen,  um  festzustellen,  wie  weit  der 
Coprozessor  ist  und  ob  z.  B.  noch  weitere  Operanden  “riibergeschoben”  werden  miissen. 


HardwaremaBige  Embindung  des  MC68882  beim  TT 

Die  Anbindung  des  Coprozessors  an  einen  MC68030  ist  relativ  einfach  zu  bewerkstelligen. 
So  sind  natiirlich  alle  32  Datenbusleitungen  zwischen  beiden  Chips  vorhanden,  um  nicht  durch 
einen  zu  “schmalen”  Bus  einen  Performance- Verlust  zu  erzeugen.  Fur  die  Registerauswahl 
im  Coprozessor  sind  auBerdem  die  AdreBbusleitungen  A1 ..  A4  an  die  FPU  (=  Floating  Point 
Unit)  angeschlossen.  Zur  Steuerung  des  Datenaustauschs  werden  dann  nur  noch  die  Quit- 
tungsleitungen  JDS  A  CKO  und  _DSACK1  von  der  FPU  bedient. 

Uber  die  _AS-  und  JDS-Eingange  erfahrt  die  FPU  von  der  CPU,  wann  AdreB-  und  Datenbus- 
informationen  gtiltig  sind.  Die  Art  des  Buszyklusses  (Lesen  oder  Schreiben)  wird  uber  die  R / 
_W-Leitung  signalisiert.  Und  iiber  den  _CS  (=  Chip  Select)- AnschluB  teilt  die  TTSCU  (TT- 
System  Control  Unit  =  Baustein  fur  die  Generierung  und  Uberwachung  von  Signalen  fiir  die 
Ausnahmeverarbeitung)  der  FPU  mit,  wann  sie  denn  angesprochen  ist. 
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Weil  die  FPU  die  Buszyklen  asynchron  abschlieJit,  muB  diese  nicht  unbedingt  mit  dem 
gleichen  Takt  wie  die  CPU  betrieben  werden. 

So  sieht  denn  das  (fur  die  32  MHz-CPU  angepaBte)  Platinenlayout  im  TT  die  Moglichkeit  des 
Umschaltens  auf  16  MHz  FPU-Takt  durch  Umsetzen  einer  Lotbriicke  (W101  auf  2 "  3  = 
16  VI H /.-Takt:  W101  auf  1  2  =  32  MHz-Takt)  vor. 


Abb.  2.1:  Hardwaremafiige  Einbindung  des  MC6888 2  beim  TT 


BUILT  IN  -  /  •  ;  CLOCK  GENERATOR 


Damit’s  noch  schneller  geht  -  Der  Coprozessor  MC68882 


Abb.  2.2:  Blockdiagramm  des  MC68882 
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Aufbau  des  MC68882 

Der  innere  Aufbau  des  MC68882  ist  ahnlich  komplex  wie  der  des  MC68030.  Fiir  den 
Programmierer  sind  jedoch  ohnehin  nur  die  Register  von  Bedeutung  und  welche  Funktionen 
dariiber  gesteuert  werden  konnen. 

Die  MC68882-FPU  unterscheidet  sich,  auBer  in  der  Hohe  der  Taktfrequenz  (der  MC6888 1  ist 
in  Ausfiihrungen  bis  max.  25  MHz  erhaltlich,  der  MC68882  bis  33  MHz),  der  optimierten 
Arbeitsgeschwindigkeit,  noch  durch  die  Conversion  U nit  (CU) .  Diese  erlaubt  bereits  die  Ein- 
gabe  von  weiteren  Instruktionen,  wahrend  die  intern e  Arithmetic  Processing  Unit  ( APU )  noch 
mit  der  vorherigen  Aufgabe  beschaftigt  ist. 

Von  dieser  Conversion  Unit  werden  dann  z.  B.  schon  die  weiteren  Operanden  angefordert 
(liber  die  Bus  Interface  Unit  der  FPU)  und  vom  platzsparenden  64  Bit-Format  ins  FPU-interne 
80  Bit-Format  konvertiert.  Handelt  es  sich  z.  B.  um  Datentransportbefehle  in  eines  der  acht 
Floating-Point-Register,  so  wirdder  konvertierte  Operand  dort  auch  schon  abgelegt  (wenn  die 
APU  dieses  Register  nicht  gerade  selbst  verwendet).  Bei  einem  Datentransportbefehl  von 
einem  der  Floating-Point-Register  nach  “auBen”  holt  die  CU  den  Operanden  aus  dem  entspre- 
chenden  Register  (wenn  dieses  Register  nicht  ausgerechnet  Ziel  der  Rechenoperation  des 
gerade  laufenden  Befehls  in  der  APU  ist),  konvertiert  diesen  ins  gewiinschte  exteme  Format 
und  bringt  ihn  “ans  Ziel”  (natiirlich  mit  CPU-Unterstutzung!). 
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Abb.  2.3:  Das  Programmiermodell  des  MC6888! 
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Zahlenformate  beim  MC68881/68882 

Die  acht  Flielikommaregister  des  MC6888 1/68882  besitzen  je  eine  Breite  von  80  Bit.  Damit 
werden  FlieBkommazahlen  als  64  Bit-Mantisse  (Bits  0 ..  63)  miteinem  15  Bit-Exponent  (Bits 
64.  .78)  dargestellt.  Das  hochstwertige  Bit  dient  als  Vorzeichenbit  fur  die  Mantisse!  Die  Zahlen 
konnen  jedoch  auch  in  anderen  Formaten  dargestellt  werden,  die  dann  von  der  FPU  entspre- 
chend  in  das  interne  Format  konvertiert  werden.  Da  ja  intern  von  der  FPU  ohnehin  das  80-Bit- 
Format  verwendet  wird  (auch  als  Extended  Precision  Format  bezeichnet),  konnen  natiirlich 
auch  Operanden  unterschiedlichen  Formats  verkniipft  werden!  Die  MC68882-FPU  unter- 
stiitzt  dabei  die  folgenden  (auch  im  IEEE  Standard  for  Binary  Floating-Point  Arithmetic  ver- 
einbarten)  Formate: 


Integer  Data  Format  (Ganzzahl-Format) 

Hier  sind  die  bereits  vom  MC680XX  bekannten  Datenformate  in  Zweierkomplement-Dar- 
stellung  (hochstwertiges  Bit  ist  Vorzeichenbit)  von  Byte-,  Word-  und  Longword-GroBe  ge- 
meint. 


Binary  Real  Data  Format  (Binares  Realzahl-Format) 

Generell  wird  hier  mit  dem  folgenden  Format  gearbeitet:  Vorzeichen  x  Mantisse  x  2  ExponM 
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Nachkommateil 

1 —  Vorzeichen  des  Nachkommateils 
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94 

80 

63 
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15  Bit- 
Exponent 
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Mantisse! 

► - 2Z - 

Extended  Real 

(Doppelte  Genauigkeit) 


Unterstellter  Dezimalpunkt! 
—  Vorkommastelle 
—  Vorzeichen  des  Nachkommateils 


In  alien  drei  Formaten  wird  die  sogenannte  “normalisierte”  Darstellung  verwendet.  Das  be- 
deutet,  daB  die  Mantisse  immer  zwischen  1 ,0  und  2,0  liegt.  Damit  kann  man  sich  die  Eins  vor 
dem  Komma  schenken  (und  muB  sie  sich  nur  denken). 

Es  wird  also  nur  der  Nachkommateil  angegeben.  Ausnahme  ist  hierbei  das  Extended  Real- 
Format,  bei  dem  die  Vorkommastelle  mit  angegeben  wird. 

Es  existieren  auch  sogenannte  “nicht  normalisierte”  Zahlendarstellungen.  Sie  werden  fur 
Werte  nahe  dem  untersten  darstellbaren  Zahlenwert  verwendet.  Dabei  ist  der  Exponent  =  0, 
und  die  Mantisse  hat  einen  von  Null  verschiedenen  Wert.  Die  Vorkommastelle  ist  dann  aber 
ebenfalls =0  (oder  man  muB  sie  sich  beim  Single  Real-  und  Double  Real-Format  als  Null  “den¬ 
ken”)! 


Eine  weitere  Besonderheit  ist  der  Zahlenwert  Null.  Er  wird  durch  eine  Null  im  Exponenten 
und  in  der  Mantisse  (bzw.  Nachkommateil  der  Mantisse)  dargestellt. 

Eine  Zahl,  die  den  darstellbaren  Wertebereich  uberschreitet,  wird  als  Unendlich  (Infinity)  be- 
handelt  und  durch  eine  Mantisse  (bzw.  Nachkommateil)  von  Null  und  durch  den  hochstmog- 
lichen  Wert  fur  den  Exponenten  gekennzeichnet. 

Ist  der  Exponent  auf  Maximum  gesetzt  und  die  Mantisse  nicht  Null,  so  wird  damit  ein  Resultat 
angezeigt,  das  mathematisch  unzulassig  (nicht  interpretierbar)  ist.  Z.  B.  das  Ergebnis  aus  einer 
Division  von  Unendlich  durch  Unendlich!  Solche  Resultate  werden  als  NANs  bezeichnet  (Not- 
A-Number!) 

Der  Exponent  ist  bei  alien  drei  Formaten  zunachst  als  vorzeichenlose  Ganzzahl  zu  betrachten, 
zu  der  allerdings  bereits  ein  Offset  addiert  ist.  Dieser  betragt  127  bei  Single  Real,  1023  bei 
Double  Real  und  16383  bei  Extended  Real. 

Um  den  Zahlenwert  des  Exponenten  zu  erhalten,  ist  also  der  entsprechende  Offset  abzuziehen. 
Der  so  erhaltene  Wert  ist  dann  als  Binarzahl  im  Zweierkomplement  zu  betrachten. 
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Beispiel: 

Die  Dezimalzahl  5  wird  als  Single  Real-Zahl  durch  einen  32  Bit  Long  mit  dem  Wert 
$40AOOOOO  dargestellt.  Nach  Zerlegung  in  Exponent  und  Nachkommateil  erhalt  man  dann: 

Bits  0..22  bilden  den  Nachkommateil  (20000kx)  der  Mantisse.  Wandelt  man  diese 
Binarzahl  (als  Nachkommazahl!)  in  Dezimal  um,  so  erhalt  man  0,25deJ  Da 
ja  die  Eins  vor  dem  Komma  nicht  auftaucht,  aber  “gedacht”  werden  muB  (sie 
ist  “implizit”  vorhanden!),  ergibt  sich  die  komplette  Mantisse  dann  zu  ldez  + 
0,25.  =1,2$,  ! 

Bits  23..30  bilden  den  Exponenten  (10000001binSr).  In  Dezimal  sind  das  1 29 lcz.  Da  aber 
darin  ein  Offset  von  127dez  (bei  Single  Real)  enthalten  ist,  mufi  dieser 
abgezogen  werden,  um  den  Exponenten  im  Zweierkomplement  zu  erhalten. 
Somit  ergibt  sich  als  Resultat  fiir  den  Exponenten  129,ez  -  127dM  =  2dcx. 

Bit  3 1  ist  das  Vorzeichenbit  des  Nachkommateils  und  hier  Null.  Damit  ist  die  Man¬ 

tisse  als  positive  Zahl  deklariert. 

Die  Zahl  lafit  sich  jetzt  also  als  Vorzeichen  x  Mantisse  x  2  Exp°ne"<  schreiben.  Das  ergibt  fiir 
das  Beispiel  den  Wert  von +1,25  x  22  =+l,25x4  =  +5!  (WZBW-  WasZuBeweisen  War). 
Die  gleiche  Zahl  als  Double  Real  ergibt  sich  iibrigens  zu  $40140000  00000000kx.  Sie  konnen 
ja  selbst  einmal  probieren,  ob  die  Umwandlung  nach  dem  Double  Real-Schema  auch  auf  die 
dezimale  5  fiihrt  (wehe,  wenn  nicht!). 


Packed  Decimal  Real  Data  Format  (Dezimal  Gepacktes  Realzahl- 
Format) 

Die  Zahlen  werden  hierbei  als  24stelliger,  gepackter  String  dargestellt.  In  ein  Byte  werden 
jeweils  zwei  Ziffem  “gepackt”!  Somit  werden  zwolf  Bytes  fiir  die  gesamte  Zahl  benotigt. 


3stelliger  Exponent 

2  Bits  fiir  Unendlich/NAN-Signalisierung  (sonst  =  0!) 
1  Bit  fiir  Exponentenvorzeichen 
1  Bit  fiir  Mantissenvorzeichen 
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Die  Befehle  des  MC68881/68882 


Die  Kommunikation  der  CPU  mit  dem  Coprozessor  erfolgt  nach  einem  durch  Motorola 
festgelegten  Protokoll.  Dieses  Protokoll  ist  aber  im  “Befehlssatz”  der  Prozessoren  des  Typs 
MC68000/68010  noch  nicht  vorhanden,  sondem  steht  erst  ab  CPUs  der  Baureihe  MC68020 
mid  hoher  zur  Veifiigung.  Wenn  man  die  FPU  in  Verbindung  mit  einer  MC68000-CPU  (z.  B. 
im  ST(E))  betreiben  will,  so  mufi  der  Coprozessor  als  “normaler”  Peripheriebaustein  ange- 
sprochen  werden.  Fur  die  Abwicklung  des  Protokolls,  bei  dem  ja  eine  Menge  von  Informatio- 
nen  ausgetauseht  werden  miissen,  stehen  12  FPU-inteme  Register  zur  Verftigung.  Das  Setzen 
und  Auswerten  dieser  Coprocessor  Interface  Register  (C1R)  mufi  bei  einer  MC68000er-CPU 
durch  ein  Programm  erfolgen,  welches  das  Kommunikationsprotokoll  einhalt.  Der  Programmie- 
rer  ernes  MC68020/68030  iiberlafit  diese  Arbeit  seiner  CPU. 

Alle  Coprozessorbefehle  bestehen  aus  mindestens  zwei  Befehlswortem.  Beim  ersten  Befehls- 
wort  sind  die  vier  hochstwertigen  Bits  immer  gesetzt,  um  zu  signalisieren,  dafi  es  sichum  einen 
Coprozessorbefehl  handelt,  Weil  alle  Coprozessorbefehle  also  immer  mit  $F. ..  beginnen,  wer¬ 
den  diese  auch  als  Line-F-Befehle  bezeichnet. 

Bei  MC68000/68010-CPUs  losen  solche  Befehle  infolge  des  fehlenden  (integrierten) 
Kommunikationsprotokolls  einen  Line-F-Trap  aus.  Dieser  Trap  soli  dann  dazu  verwendet 
werden,  um  mittels  eines  entsprechenden  Trap-Handlers  die  Coprozessorkommunikation  zu 
steuem.  Leider  hat  ATARI  in  fruheren  TOS-Versionen  diesen  Line-F-Trap  fur  eigene  Be- 
triebssystemaufrufe  benutzt!  Da  blieb  einem  dann  nur  noch  die  Moglichkeit,  den  nachtraglich 
nachriistbaren  Coprozessor  “von  Hand”  fiber  eigene  Routinen  oder  einen  “verbogenen”  Line- 
F-Handler  zu  steuem.  Letztere  Losung  wurde  in  der  c’t  4/1 990  recht  ausftihrlich  beschrieben! 

Aber  nun  zu  den  eigentlichen  Coprozessor-Befehlen.  Diese  lassen  sich  in  fiinf  Gmppen  eintei- 
len. 


Datentransportbefehle 
Befehle  mit  einem  Operanden 
Befehle  mit  zwei  Operanden 
Programmsteuerbefehle 
Befehle  zur  Systemsteuerung 


Datentransportbefehle 

Mit  dieser  Befehlsgruppe  werden  Daten  bewegt,  also  Register  in  der  FPU  geladen  oder 
Registerinhalte  der  FPU  im  Speicher  oder  der  CPU  abgelegt.  Alle  Transportbefehle  beginnen 
mit  dem  Mnemonic  FMOVE. 
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Weil  ja  bei  Verwendung  der  FPU  noch  einige  weitere  Datenformate  hinzukommen,  miissen 
diesenatiirlichentsprechendimBefehlangegeben  werden.  Die  bereitsbekannten  Datenformate 
Byte,  Word  und  Long  werden  wie  gehabt  durch  die  Zusatze  “.B”,  W”  und  “.L”  hinter  dem 
Befehlsmnemonic  gekennzeichnet.  Mit  “,S”  erkennt  der  Assembler  ein  Single  Real-Format; 
“.D”  steht  fiir  Double  Real  und  “.X”  fur  das  Extended  Real-Format. 


Packed  Dezimal  wird  durch  ein  “P”  gekennzeichnet.  AuBerdem  ist  hinter  der  Zieladresse 
noch  ein  Formatparameter  (k-Faktor)  im  Zweierkomplement  (zwischen  -64  und + 1 7)  anzuge- 
ben.  Positive  Werte  bestimmen  dabei  die  Anzahl  der  Stellen,  mit  der  die  Mantisse  ausgegeben 
wird.  Negative  k-Werte  bestimmen  die  Anzahl  der  Nachkommastellen  im  “normalen”  Zah- 
lenformat  (also  wenn  die  Zahl  nicht  in  Exponentialschreibweise  dargestellt  wird). 


Beispiele; 


FMOVE.L  d0,FP0 


;  Long  aus  CPU-Reg.  DO  ins  FPO-Reg.  laden. 


FMOVE.X  FP0,(a0)+  ;  Wert  aus  FPO-Reg.  im  Extended  Real-Format  im  Spei- 

cher  ablegen.  Pointer  steht  in  CPU-Reg.  AO.  Anschlie- 
Bend  Pointer  entsprechend  inkrementieren. 


FMOVE.P  FP7,result{#5)  ;  FP7-Wertals  Packed  Decimal  in  Speicherstelle  “result” 

ablegen.  Dabei  den  Nacbkommateil  mit  5  Stellen  ange- 
ben,  Enthalt  FP7  also  den  Wert  12345,67898765,  so  er- 
gibt  sich  als  Ergebnisstring  in  “result”  dann  +1 ,2346  x 
10*4. 


Genau  wie  bei  der  CPU  gibt  es  auch  bei  der  FPU  die  Moglichkeit,  mit  einem  FMOVE-Befehl 
eine  ganze  Liste  von  Registerinhalten  zu  bewegen.  Dieser  Befehl  heiBt  hier  FMOVEM  und 
transportiert  entweder  FP-Datenregisterinhalte  im  Extended  Real-Format  (FMOVEM.X) 
oder  FPU-Control-Register  als  Long  (FMOVEM.L)  zwischen  Speicher  und  FPU. 

Weil  in  mathematischen  Berechnungen  bestimmte  Konstanten  (Kreiszahl  Jt,  Eulersche  Zahi 
e  usw.)  relativ  haufig  benotigt  werden,  hat  man  diese  in  ein  spezielles  Konstanten-ROM  der 
FPU  “eingebaut”.  Mit  einem  speziellen  FMOVECRX- Befehl  kann  man  durch  Angabe  des 
Offsets  in  dieses  ROM  die  dort  abgelegten  Konstanten  abrufen.  Hier  die  Offsets  der  Konstan¬ 
ten  in  einer  kleinen  Tabelle: 


Offset 

Konstante 

$00 

Kreiszahl  n 

=  3,14159... 

$0B 

Log10(2) 

=  0,30102... 
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Offset 

Konstante 

$0C 

Eulersche  Zahl  e  =  2,71828... 

$0D 

Log2(e)  =  1,44269... 

$0E 

Log10(e)  =0,43429... 

$0F 

0,0  =  0,0! 

$30 

ln(2)  =  0,69314... 

$31 

ln(10)  =  2,30258... 

$32 

10° 

$33 

101 

$34 

102 

$35 

104 

$36 

108 

$37 

10'6 

$38 

1032 

$39 

1064 

$3  A 

10'28 

$3B 

102S6 

$3C 

10512 

$3D 

10'024 

$3E 

J  02048 

$3F 

JQ4096 

Befehle  mit  einem  Operanden 

Hierbei  wird  nur  ein  Eingabe-Operand  benotigt,  auf  den  der  entsprechende  Befehl  angewendet 
wird.  Dabei  ist  es  aber  durchaus  moglich,  das  Ergebnis  in  einem  anderen  FP-Register 
abzulegen  (Beispiel:  “FSIN  FPO.FPI”  berechnet  den  Sinus  des  Werts  in  Register  FPO  und 
setzt  das  Ergebnis  dann  in  Register  FPL  Register  FPO  wird  nicht  verandert)! 

Eine  Besonderheit  stellt  hierbei  allerdings  der  spezielle  Befehl  FSINCOS  dar.  Damit  laBt  sich 
von  einer  Zahl  gleichzeitig  der  Sinus  und  der  Kosinus  berechnen. 

Dazu  ist  allerdings  erforderlich,  daB  zwei  Zielregister  fiir  die  beiden  Rechenergebnisse  ange- 
geben  werden. 

Beispiel: 

FSINCOS. X  FP0,FP1:FP2  ;  Sin(FPO)  ->  FP2 ! ;  Cos (FPO)  ->  FP1 ! 
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Hier  eine  Zusammenfassung  der  moglichen  Befehle  in  einer  kleinen  Tabelle: 


Mnemonic 

Funktion 

FABS 

Erzeugt  den  Absolutwert  der  Zahl  (immer  positiv!) 

FACOS 

Arcus  Cosinus  (Umkehrfunktion  der  Kosinusfunktion) 

FASIN 

Arcus  Sinus  (Umkehrfunktion  der  Sinusfunktion) 

FATAN 

Arcus  Tangens  (Umkehrfunktion  der  Tangensfunktion) 

FATANH 

Area  Tangenshyperbolicus  (Umkehrfkt.  des  Hyperbeltan.) 

FCOS 

Kosinus(X) 

FCOSH 

Hyperbelkosinus(X) 

FETOX 

ex 

FETOXM1 

ex  - 1 

FGETEXP 

Liefert  den  Exponenten  der  Zahl 

FGETMAN 

Liefert  die  Mantisse  der  Zahl 

FINT 

Rundet  auf  die  nachste  ganze  Zahl  auf  oder  ab 

FINTRZ 

Rundet  auf  die  nachste  ganze  Zahl  ab 

FLOGN 

ln(x) 

FLOGNP1 

ln(x+l) 

FLOGIO 

log10(X) 

FLOG2 

log2(X) 

FNEG 

Negation 

FSIN 

Sinus(X) 

FSINH 

Hyperbelsinus(X) 

FSQRT 

Quadratwurzel(X) 

FTAN 

Tangens(X) 

FTANH 

Hyperbeltangens(X) 

FTENTOX 

10x 

FTWOTOX 

2X 

Befehle  mit  zwei  Operanden 

Bei  diesem  Befehlstyp  werden  zwei  Eingabewerte  bendtigt,  die  verkntipft  werden  sollen. 

Dabei  darf  der  erste  Operand  im  Speicher,  CPU-Register  oder  in  einem  FPU-Datenregister 
stehen,  Der  zweite  Operand  muji  immer  in  einem  FPU-Datenregister  zu  finden  sein !  In  diesem 
FPU-Datenregister  “landef  ’  dann  auch  das  Ergebnis  der  Operation. 

Auch  hier  alle  Befehle  in  einer  tabellarischen  Ubersicht: 
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Mnemonic 

Funktion 

FADD 

Addiert  zwei  Zahlen 

FCMP 

FPn  -  Quelle.  Ergebnis  setzt  Condition  Codes  entsprechen 

FDIV 

FPn  /  Quelle  =>  FPn 

FMOD 

FPn  mod  Quelle  =>  FPn.  Division  lafit  nur  Rest  iibrig 

FMUL 

FPn  *  Quelle  =>  FPn 

FREM 

Diff.  von  FPn  z.  nachstliegenden  Vielfachen  des  Quellop. 

FSCALE 

FPn  x  INT(2(3uel,e)  =>  FPn 

FSGLDIV 

Division  (Ergebnis  im  Single  Real  Fonnat) 

FSGLMUL 

Multiplikation  (Ergebnis  im  Single  Real  Format) 

FSUB 

FPn  -  Quelle  =>  FPn 

FPn  =  Datenregister-#n  in  der  FPU 


Programmsteuerbefehle 

Wie  in  der  CPU  lafit  sich  -  auch  abhangig  von  bestimmten  Bedingungen  in  der  FPU  -  der 
weitere  Programmflufi  steuem  (verzweigen).  So  gibt  es  z.  B.  die  von  der  CPU  her  bekannten 
Sprungbefehle  auch  in  Verbindung  mit  der  FPU.  Hier  wird  dann  abhangig  von  den  Bedin- 
gungsbits  im  Floating  Point  Status  Register  ( FPSR )  verzweigt. 


Befehi 

Operand 

Operation 

FBcc 

<label> 

IF  Bedindung  cc  wahr,  THEN  GOTO  <label> 

FDBcc 

Dn,<label> 

IF  Bedingung  cc  wahr,  THEN  NOP 

ELSE  Dn  :=  Dn  -  1 

IF  Dn  <>  -1,  THEN  GOTO  <label> 

FNOP 

No  Operation 

FScc 

<ea>* 

IF  Bedingung  cc  wahr,  THEN  <ea>  $FF 

ELSE  <ea>  :=  $00 

FTST 

<ea>* 

Zahl  testen  und  FPSR-Condition-Code-Bits  entsprechend 

FPn 

setzen 

<ea>*=  Steht  fiir  “Effektive  Adresse”.  Diese  kann  sowohl  ein  CPU-Datenregister  als 
auch  eine  Speicherzelle  sein,  auf  die  mit  den  von  der  CPU  her  moglichen  Adres- 
sierungsarten  zugegriffen  werden  kann! 

Fiir  die  Bedingungen  cc  in  der  obigen  Tabelle  konnen  dann  die  folgenden  Mnemonics  ein- 
gesetzt  werden: 
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Mnemo. 

1 

Mnemo. 

2 

Bedeutung 

EQ 

SEQ 

Gleich 

(Diese  Mnemonics  sind  nur  der 

NE 

SNE 

Ungleich 

Vollstandigkeit  halber  in  die  32 

F 

SF 

Immer  falsch 

moglichen  Abfragen  mit 

T 

ST 

Immer  wahr 

aufgenommen  worden!) 

GE 

OGE 

Gleich  oder  groBer 

GL 

OGL 

GroBer  oder  kleiner  (also  ungleich!) 

GLE 

OR 

GroBer,  kleiner  oder  gleich  (aber  es  ist  kein  NAN!) 

GT 

OGT 

GroBer 

LE 

OLE 

Kleiner  oder  gleich 

LT 

OLT 

Kleiner 

NGE 

UGE 

[Das  sind  die  gleichen  Konditionen  wie  vorher,  nur 

NGL 

UEQ 

daB  zusatzlich  das  NAN-Bit  gesetzt  sein  muB. 

NGLE 

UN 

Damit  wird  zusatzlich  ermoglicht,  auch  Bedingungen 

NGT 

UGT 

zu  priifen,  obwohl  ein  Wert  verwendet  wurde,  der 

NLE 

ULE 

nicht  ins  giiltige  Datenformat  paBt!] 

NLT 

ULT 

| 

Die  Mnemonics  vom  Typ  1  werden  verwendet,  wenn  aufgrund  der  Bedingungsabfrage  zu¬ 
satzlich  eine  Exception  ausgelost  werden  soli,  weil  beim  Test  ein  NAN  beteiligt  war  undsomit 
eine  sogenannte  “Unordered  condition”  aufgetreten  ist.  Als  Folge  davon  wird  das  BSUN-Bit 
(Branch/Set  on  Unordered-Bit)  im  EXC-Byte  des  Floating-Point  Status  Register  gesetzt.  Die 
Mnemonics  des  Typs  2  setzen  das  BSUN-Bit  nicht  (auch  wenn  ein  NAN  beteiligt  war)! 


Befehle  zur  Systemsteuerung 

Mit  diesen  Befehlen  kann  z.  B .  unter  bestimmten  Bedingungen  ein  Trap  ( FTRAPcc )  ausgelost 
werden.  Dabei  sind  fur  cc  die  gleichen  Mnemonics  zu  verwenden,  wie  in  der  vorigen  Tabelle 
bereits  dargestellt. 

Die  ebenfalls  zur  Systemsteuerung  gehorenden  Befehle  FSAVE  und  FRESTORE  erlauben  das 
Ablegen  von  intemen  FPU-Zustanden  im  Speicher  (als  sogenannten  State  Frames)  und  auch 
das  spatere  Wiederherstellen  des  alten  Zustands.  In  Multitasking-Systemen  werden  solche 
Befehle  angewendet,  um  zwischen  verschiedenen  Tasks  hin-  und  herzuschalten.  Damit  ist  es 
dann  moglich,  den  FPU-internen  Status  zwischenzeitlich  zu  sichern,  einen  anderen  Task  zu 
bearbeiten  und  anschlieBend  den  ersten  Task  mit  dem  originalen  FPU-Status  wiederherzustel- 
len  und  weiterzuftihren! 
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Das  Floating  Point  Control  Register  (FPCR) 

Dieses  32  Bit-Register  verwendet  zur  Zeit  nur  die  beiden  niederwertigsten  Bytes .  Es  kann  vom 
Benutzer  gelesen  und  beschrieben  werden  (z.  B.  durch  FMOVE.L  FPCR.dO). 

Das  Exception  Enable  byte  ( ENABLE )  (Bits  8. .  1 5  des  FPCR)  erlaubt  die  Freigabe  (Bit  gesetzt) 
und  das  Sperren  (Bit  geloscht)  von  verschiedenen  Exceptions,  die  durch  die  FPU  veranlafit 
werden  konnen. 


15 

14 

13 

12 

11 

10 

9 

8 

BSUN 

SNAN 

OPERR 

OVFL 

UNFL 

DZ 

INEX2 

—  Unexakte  Dezima- 
le  Eingabe 
Unexakte  Operation 
Division  durch  0 
""  Underflow 

-  Overflow 

"  Operand  fehlerhaft 
Signaling  Not  a 
Number 

-  Branch/Set  on 

Unordered 


Im  Mode  Control  Byte  {MODE)  (Bits  0..7  des  FPCR)  kann  der  Anwender  bestimmte  Modali- 
taten  fiir  den  RundungsprozeB  einstellen. 


7  6  5  4  3  2  1  0 


Priizision 


Modus 


Null 


Durch  die  beiden  Modus-Bits  wird  festgelegt,  wie  ungenaue  Resultate  gerundet  werden  sollen. 
(Es  lafit  sich  nicht  jede  Dezimalzahl  exakt  als  Binarzahl  mit  einer  festen  Stellenzahl  darstel- 
len). 

0  0  Der  nachstliegende,  darstellbare  Wert  wird  genommen.  Sollten  sich  zwei  Werte  anbie- 
ten,  die  beide  gleich  “nahe”  liegen,  so  wird  der  Wert  mit  dem  niedrigstwertigen  Bit=0 
genommen! 
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0  1  Als  Round-to-zero  bezeichnet.  Effekt  ist  der,  daB  die  Bits  rechts  der  Rundungsstelle 
geloscht  werden! 

1  0  Es  wird  zum  nachstliegenden  Wert  in  Richtung  — gerundet. 

1  1  Rundung  auf  den  nachstliegenden  Wert  in  Richtung  +°°. 

Die  beiden  Prazisionbits  spezifizieren,  wo  der  Rundungspunkt  der  Mantisse  liegen  soil. 

0  0  Extended  Precision.  Es  wird  auf  eine  64-Bit-Mantisse  gerundet. 

0  1  Single  Precision.  Rundung  auf  eine  24  -Bit- Mantisse. 

1  0  Double  Precision.  53-Bit-Mantisse  fur  die  Rundung  vorsehen. 

1  1  RFFU  (Soil  heiBen:  Reserved  for  future  use!) 

Das  Floating  Point  Status  Register  (FPSR) 

Alle  vier  Bytes  dieses  32-Bit-Registers  werden  verwendet.  Lesen  und  Beschreiben  des  Regi¬ 
sters  durch  den  Anwender  ist  moglich  (z.B.  durch  FMOVE.L  dO,FPSR). 

Das  hochstwertige  Byte  (Bits  24..31)  wird  als  Floating  Point  Condition  Code  Byte  ( FPCC ) 
bezeichnet  und  signalisiert  in  4  Bits  den  Bedingungscode  einer  mathematischen  Operation, 
bei  dem  ein  FP-Datenregister  beteiligt  war.  Wichtig  dabei  ist,  daB  die  Bedingungscodes  nicht 
von  der  ausgefiihrten  Operation  abhangig  sind,  sondem  von  dem  sich  als  Resultat  ergebenden 
Datentyp! 


31  30  29 

28 

27 

26 

25 

24 

Null 

N 

Z 

I 

NAN 

N  Negatives  Resultat  (Negative-Bit) 

Z  Ergebnis  ist  Null  (Zero-Bit) 

I  Resultat  ist  +/-  Unendlich  (Infinity-Bit) 

NAN  Ergebnis  ist  keine  giiltige  Zahl  Oder  Unordered  (=  bei  der  ausgefiihrten  Operation  war 

mindestens  ein  Eingabe-Operand  ein  NAN!) 

Die  Bits  1 6 ..  23  des  FPSR  bilden  das  Quotient  Byte.  Es  wird  am  Ende  einer  FMOD  oderFREM- 
Operation  entsprechend  gesetzt. 
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Dabei  enthalt  es  in  den  niedrigstwertigen  7  Bits  die  7  untersten  Bits  des  Quotienten  und  im 
hochstwertigen  Bit  dessen  Vorzeichen. 


23  22  21  20  19  18  17  16 


7  niedrigstwertige  Bits  des  Quotienten 


H 


Vorzeichen  des  Quotienten 


Das  Exception  Status  Byte  ( EXC )  ist  in  den  Bits  8. .  1 5  des  FPSR  enthalten.  Es  enthalt  je  ein 
Bit  fur  die  acht  moglichen  Ausnahmebedingungen  (Exceptions),  die  durch  eine  der  letzten 
ausgefiihrten  FPU-Operationen  aufgetreten  sind.  Vor  dem  Start  der  meisten  FPU-Operationen 
wird  dieses  Bit  geloscht,  so  daft  ein  Exception-Handler  erkennen  kann,  welche  FlieBkomma- 
Operation(en)  zur  Ausnahmebehandlung  fiihrten. 


15 

14 

13 

12 

11 

10 

9 

8 

BSUN 

SNAN 

OPERR 

OVFL 

UNFL 

DZ 

INEX2 

INEX1 

1  . . r~ . " . . .  c  Unexakte  Dezima- 

le  Eingabe 

- Unexakte  Operation 

-  Division  durch  0 

- - - — - -  Underflow 

- — - — - -  Overflow 

- Operand  fehlerhaft 

- Signaling  Not  a 

Number 

— — — — -  Branch/Set  on 

Unordered 

Die  Bitanordnung  stimmt  dabei  mit  dem  ENABLE-Byte  des  Floating  Point  Control  Registers 
(FPCR)  iiberein.  Auch  wenn  die  Exception  durch  das  korrespondierende  Bit  im  ENABLE- 
Byte  gesperrt  sein  sollte,  so  wird  doch  das  Exception-Status-Bit  bei  Auftreten  einer  entspre- 
chenden  Ausnahmebedingung  gesetzt! 

Fiir  den  Fall,  daB  ohne  Ausnahmeverarbeitung  gearbeitet  wird,  existiert  das  Accrued 
Exception  Byte  ( AEXC )  in  den  Bits  0..7  des  FPSR.  In  diesem  Register  werden  alle  Floating- 
Point  Exceptions,  die  nach  dem  letzten  Loschen  des  Registers  (muB  der  User  allerdings  selbst 
veranlassen!)  im  Laufe  der  letzten  ausgefiihrten  Operationen  aufgetreten  sind,  “zusammen- 
gesammelt”. 
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Das  erspart  dem  User  das  Uberpriifen  des  EXC-Bytes  nach  jeder  FlieBkommaoperation!  Es 
reicht  dann  aus,  am  Ende  einer  Sene  von  FlieBkommaoperationen  nachzuschauen,  ob  zwi- 
schenzeitlich  eine  Ausnahmebedingung  aufgetreten  ist. 


7 

6 

5 

4 

3 

2  1  0 

IOP 

OVFL 

UNFL 

DZ 

INEX 

Null 

Unexakte  dezimale  Eingabe 
Division  durch  Null 
Underflow 
Overflow 

Unzulassige  Operation 


Das  Floating  Point  Instruction  Address  Register 
(FPIAR) 


Da  ja  bei  der  Zusammenarbeit  zwischen  CPU  und  FPU  zum  groBen  Teil  Prozesse  “nebenein- 
ander”  herlaufen,  ist  es  erforderlich  festzuhalten,  bei  welchem  Befehl  (Adresse)  die  FPU  denn 
gerade  ist.  Sonst  konnte  bei  einer  FPU-Exccption  die  CPU  (und  damit  der  Exception-Handler) 
nicht  so  einfach  feststellen,  bei  welchem  FPU-Befehl  die  Ausnahmebedingung  auftrat. 

Im  FPIAR  wird  deshalb  jeweils  die  Adresse  des  augenblicklich  zu  bearbeitenden  FPU-Befehls 
vor  seiner  Ausfiihrung  abgelegt. 


1037 


Kapitel  3:  ROM  und  RAM  beim  TT 

Viel  Platz  fur  das  Betriebssystem  -  Das  TT-ROM 

Die  im  TT  zusatzlich  hinzugekommene  Hardware  braucht  natiirlich  entsprechende  Unterstut- 
zung  durch  Betriebssy stem-Software.  So  kommt  denn  ATARI  im  TT  (und  STE)  auch  nicht 
mehr  mit  den  im  ST  noch  ausreichenden  192  KByte  ROM  aus.Verwendet  werden  nun 
1  MBit-EPROM-Chips,  wobei  das  Platinenlayout  im  TT  (und  STE)  entsprechend  flexibei 
gestaltet  wurde.  So  konnen  so  wohl  EPROMs  des  Typs  27256, 275 1 2, 27C 1 000, 27C 1 00 1  und 
27C1010  verwendet  werden.  Es  lassen  sich  aber  auch  1-MBit-ROMs  verwenden.  Von  der 
Zugriffsgeschwindigkeit  reichen  150  ns-Typen  wohl  aus. 

Beim  TT  sind  vier  (beim  STE  sind  es  2!)  32polige  Sockel  fur  die  Betriebssystem-Chips 
vorgesehen.  Damit  ist  es  im  TT  also  moglich,  512  KByte-Sytemsoftware  unterzubringen.  In 
der  Tat  sind  auch  alle  vier  Sockel  mit  Megabit-Eproms  bestiickt.  Was  aber  noch  langst  nicht 
heiBt,  daB  diese  auch  in  ihrer  Kapazitat  voll  ausgereizt  wurden.  Es  ist  wohl  eher  so,  daB  man 
so  gerade  iiber  die  256  KByte-Grenze  “gerutscht”  ist  (TOS  3.01  und  3.05  sind  ca.  $41000  = 
266240  Bytes  lang).  Es  sind  aber  auf  jeden  Fall  alle  vier  Sockel  mit  Chips  zu  bestiicken,  da 
ja  im  TT  ein  32-Bit-Datenbus  verwendet  wird.  Jeder  Chip  bedient  also  ein  Viertel  des  Daten- 
busses. 

Das  Betriebssy  stem-ROM  erscheint  im  TT  an  zwei  Stellen  des  CPU-AdreBraums.  Zum  einen 
ist  es  so  ziemlich  am  oberen  Ende  des  “ST -  AdreBraums”  (die  unteren  1 6  MByte,  die  von  einer 
68000er-CPU  adressiert  werden  konnen! )  von  $E0  0000 ..  $EF  FFFF  zu  “fmden”.  Dafiir  sorgt 
die  MMU  in  der  68030-CPU.  Eigentlich  liegt  der  ROM-Bereich  am  hinteren  Ende  des 
68030er-Speicherbereichs  bei  $FFE0  0000  ..  $FFEF  FFFF! 

Auch  beim  TT  findet  man  wieder  in  den  ersten  beiden  Langwortem  des  Speicherraums  die 
Startwerte  fiir  die  CPU  (Adresse  $0  =  Startwert  fur  den  Supervisor  Stackpointer;  Adresse  $4 
=  Startwert  fiir  den  Programmzahler).  Diese  8  Bytes  werden,  wie  beim  ST(E)  aus  dem  Be- 
triebssystem-ROM  ($FFEO0000.  ,$FFE0  0007)  durch  entsprechende  AdreBdekodierung 
dort  eingeblendet. 

RAM  ist  nicht  gleich  RAM!  -  Der  TT  kennt 
mindestens  zwei  “Sorten” 

Um  dem  TT  zeitgemaBe  Leistungsfahigkeit  zukommen  zu  lassen,  wurde  es  erforderlich,  den 
beim  ST(E)  doch  eher  eingeschriinkten  Speicherraum  von  max.  12  MByte  (ab  $C0  0000  hat 
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Abb.  3.1 :  Die  Einbindung  der  ROMs  beim  TT 
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ATARI  ja  den  Speicherbereich  fur  eigene  Anwendungen  wie  z.  B.  Grafikkarten  reserviert!) 
entsprechend  erweitem  zu  konnen.  Vor  alien  Dingen,  wo  man  doch  eine  CPU  einsetzt,  die  im- 
merhin  4  GByte  (!)  direkt  ansprechen  kann,  muBte  man  nach  Losungsmoglichkeiten  suchen, 
wie  man  diesen  AdreBraum  nutzbar  machen  konnte,  ohne  gleichzeitig  die  Kompatibilitat  zu 
den  ST(E)-Geraten  zu  verlieren. 

Die  Losung  meint  man  mit  dem  sogenannten  “Alternate  RAM”  gefunden  zu  haben.  So 
existiert  dann  zusatzlich  zum  ST-kompatiblen  RAM,  in  dem  sich  neben  der  CPU  auch  noch 
der  DMA-Baustein  fur  ACSI-Datentransfers  und  der  Videocontroller  die  Zugriffe  auf  das  vor- 
handene  RAM  teilen,  noch  eine  zweite  Sorte  RAM,  die  nur  durch  die  CPU  angesprochen  wer- 
den  kann,  Wobei  das  mit  dem  “nur  durch  die  CPU  ansprechbar”  nicht  immer  ganz  korrekt  ist. 
Lediglichdas  Altemate-RAM,  welches  liber  den  VME-BusanschluB  andenTTangeschlossen 
werden  kann,  und  das  RAM  in  dem  Uhrenchip  des  TT  konnen  nur  durch  die  CPU  angesprochen 
werden. 

Das  sogenannte  Fast-RAM  hingegen  kann  sowohl  von  der  CPU  als  auch  von  den  beiden  DMA- 
Bausteinen  fur  den  SCSI-Bus  und  den  schnellen  seriellen  Schnittstellen-Controller  (SCC) 
benutzt  werden,  Allerdings  kann  der  Videocontroller  nicht  an  dieses  Altemate-RAM  und  fallt 
somit  als  “Bremse”  bei  Fast-RAM-Zugriffen  aus! 


ST-kompatibles  RAM 

Im  TT  hat  sich  ATARI  den  AdreBraum  von  $8  ..  $9F  FFFF  (mit  einer  weiteren  “Option”  fiir 
den  Bereich  von  $A0  0000 ..  $DF  FFFF)  explizitals  “dual  purpose”-RAM  reserviert.  Dieses 
RAM  wird  (zeitlich)  abwechselnd  von  der  CPU  und  dem  Videocontroller  (deswegen  wohl 
“dual  purpose”!)  benutzt.  Dabei  kann  der  Zugriff  auf  dieses  RAM  in  minimal  250ns- 
Abstanden  zwischen  den  beiden  Konkurrenten  wechseln,  Wahrend  eines  laufendenDisplay- 
Zyklusses  wird  der  Videocontroller  natiirlich  nicht  einfach  unterbrochen,  sondem  die  CPU 
bekommt  die  nachstmoglichen  250ns  “zugewiesen”. 

Auf  der  Hauptplatine  des  TTs  findet  sich  bereits  standardmaBig  2  MByte  ST-RAM.  Aufge- 
baut  ist  dieses  aus  16  DRAMs  der  Organisation  256Kx4Bit!  Es  werden  dabei  100ns- 
DRAMs  verwendet.  Soweit  gibt  es  bisher  keine  wesentlichen  Unterschiede  zum  RAM  in 
ST(E)s. 

Aber  nun  zur  Abweichung!  Diese  16  RAM-Chips  werden  zu  einem  64  Bit-Memory- 
Datenbus  zusammengeschaltet!  Dadurch  ist  es  dem  Videocontroller  moglich,  mit  einem 
RAM-Zugriff  sofort  8  Bytes  an  Bildschirmdaten  auszulesen!  Die  Anpassung  des  64  Bit-Me- 
mory-Datenbusses  an  den  im  System  ansonsten  verwendeten  32  Bit-Datenbus  iibemehmen 
zwei  Spezialchips  (als  FUNNEL  =  Trichter  bezeichnet). 
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Abb.  3.2:  Aufbau  der  ST-RAM-Erweiterungskarte  ( rechter  Teil J 
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Natiirlich  ist  es  vorgesehen,  dieses  “dual  purpose”-RAM  zu  erweitem.  Auf  der  Hauptplatine 
(unter  der  Harddisk)  befinden  sich  dazu  zwei  96polige  Federleisten  nach  DIN  41  612  (oder 
VG  95  324,  deshalb  auch  haufig  als  VG-Leisten  bezeichnet). 

Es  reicht  aber  nun  nicht  aus,  einfach  dort  eine  Platine  mit  nur  den  RAMs  einzusetzen,  Vielmehr 
benotigen  diese  RAMs  eine  eigene  MCU  (Memory  Control  Unit).  Die  MCU  auf  der  TT- 
Hauptplatine  hat  genug  mit  dem  dort  untergebrachten  RAM  zu  tun.  Deshalb  sind  auch  alle  fiir 
eine  MCU  erforderlichen  Signale  auf  diese  beiden  VG-Leisten  gefiihrt.  ATARI  hat  dabei 
allerdings  eine  Signalaufteilung  fiir  diese  beiden  Leisten  vorgenommen. 

Die  mit  der  Bezeichnung  J501  versehene  VG-Leiste  auf  der  TT-Hauptplatine  stellt  dabei  die 
64Leitungen  fur  den  Memory-Datenbus  und  die  Versorgungsspannungsanschliisse  zur 
Verfiigung  (dieser  SteckanschluB  findet  sein  “Gegenstiick”  in  dem  AnschluB  J 1  der  ST-RAM- 
Erweiterungssplatine  in  der  Abbildung  3.2).  Uber  die  VG-Leiste  J502  werden  der  32  Bit- 
AdreBbus  und  die  Signale  fur  die  MCU  (plus  Versorgungsanschliisse)  geliefert. 

AuBerdem  werden  noch  die  Busleitungen  D0..D10  des  32  Bit-Datenbusses  zur  MCU  der 
Erweiterungsplatine  gefiihrt  (irgendwie  miissen  ja  auch  die  Register  in  der  MCU  gesetzt 
werden  konnen!).  Auf  der  Erweiterungsplatine  ist  dieser  AnschluB  mit  J2  bezeichnet! 

Die  MCU  hat  natiirlich  nicht  nur  die  Aufgabe,  fiir  einen  gemultiplexten  AdreBbus  zu  den 
RAMs  und  die  dazu  gehorenden  RAS-  und  CAS-Signale  zu  sorgen.  Da  ja  DMA-Betrieb 
genauso  moglich  sein  muB,  ist  in  der  MCU  die  entsprechende  Logik  untergebracht! 

Gleiches  gilt  fiir  Zugriffe  des  Videocontrollers.  Also  sind  die  dazu  erforderlichen  Signale 
ebenfalls  zur  MCU  auf  der  Erweiterungskarte  gefiihrt. 

Im  Moment  verwendet  ATARI  fiir  seine  RAM-Erweitemngskarten  noch  16  DRAMs  der 
Organisation  256K  x  4  BitundkommtsoaufeineKapazitatvon2  MByte  auf  der  Erweiterungs¬ 
karte. 

Sobald  aber  4  MBit-Chips  in  entsprechenden  Stiickzahlen  erhaltlich  sind,  wird  die  Erweiterungs¬ 
karte  dann  8  MByte  Kapazitatumfassen  konnen.  Die  MCU  weist  bereits  den  entsprechenden 
AnschluB  fiir  die  gemultiplexte  AdreBleitung  9  (MAD9)  auf! 


TT-spezifisches  RAM  -  Das  Fast-RAM 

Den  Spitznamen  “Fast-RAM”  hat  diese  Sorte  RAM  im  TT  wohl  wegen  seiner  nahezu  aus- 
schlieBlichen  Nutzung  durch  die  CPU  bekommen.  ATARI  spricht  aus  diesem  Grunde  in 
seinen  Dokumentationen  deshalb  auch  vom  “single  purpose”-RAM. 
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Es  ist  als  Erweitemng  zum  (ST)-RAM  auf  der  Hauptplatine  vorgesehen.  StandardmaBig  findet 
sich  auf  demTT-Motherboard  also  kein  Fast-RAM,  sondem  lediglich  eine  AnschluBmoglichkeit 
fur  eine  entsprechende  Erweiterungskarte. 

Da  der  Videocontroller  auf  dieses  RAM  nicht  zugreifen  kann,  entfallt  auch  die  Notwendigkeit, 
es  in  Form  eines  64  Bit  breiten  Datenbusses  anzulegen.  So  findet  man  denn  beim  Erweite- 
rungssteckplatz  auch  nur  einen  32  Bit-Datenbus,  mit  direktem  “Draht”  (Busverbindung)  zur 
CPU  und  FPU.  Ahnlich  wie  bei  der  Erweiterung  des  ST -RAMs  benotigt  man  auch  f  iir  das  Fast- 
RAM  eine  eigene  FAST-MCU  auf  der  Erweiterungskarte.  Da  aber  keine  Videocontroller- 
zugriffe  in  diesen  Typ  RAM  vorgesehen  sind,  brauchen  auch  natiirlich  nicht  so  viele  Steuer- 
und  Meldeleitungen  zur  TTFMCU  (TT-FAST-RAM-Memory  Controller  Unit)  gefuhrt  zu 
werden. 

ATARI  verwendet  im  Moment  auf  seinen  Erweiterungskarten  vier  SIM-Module  der  Organi¬ 
sation  1 M  x  8  Bit  und  kommt  damit  auf  eine  Kapazitat  von  4  MByte  fiir  diese  Karte.  Sobald 
aber  die  4M  x  8  Bit  in  groBeren  (und  preiswerteren)  Stiickzahlen  erhaltlich  sind,  wird  es  auch 
eine  1 6  MByte-Karte  fiir  die  Fast-RAM-Erweiterung  geben.  Ob  dazu  allerdings  die  gleiche 
TTFMCU  verwendet  werden  kann,  konnte  von  ATARI-Deutschland  noch  nicht  bestatigt 
werden  (die  gemultiplexte  AdreBbusleiiung  MAD10  ist  zumindest  schon  mal  vorhanden!). 

Um  die  Cache-Speicher  der  MC68030  besonders  effektiv  zu  fiillen  (im  sogenannten  Burst- 
fill-Modus  lassen  sich  bis  zu  vier  Langworter  mit  sehr  wenigen  Taktzyklen  unmittelbar  hinter- 
einander  einlesen!),  werden  fiir  das  Fast-RAM  Bausteine  verwendet,  die  im  Nibble-Mode 
arbeiten.  Damit  ist  es  moglich,  nach  einem  Zugriff  mittels  normaler  RAS/CAS-Adressierung 
(erst  Zeilenadresse,  dann  Spaltenadresse  an  die  RAMs  legen  und  jeweils  durch  RAS-  bzw. 
CAS-Signal  (aktiv  Low)  die  Zelladresse  im  RAM-Chip  auswiihlen)  nur  durch  Ausgabe 
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Abb.  3.4:  Der  Unterschied  iwischen  Normal-  und Nibble-Mode-Zugriffen 
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weiterer  C  AS-Impulse  Zugriff  auf  die  drei  folgenden  Adressen  zu  erhalten .  Das  spart  natiirlich 
einiges  an  Zeit  und  erhoht  somit  den  Datendurchsatz. 

Auf  der  FAST -RAM-Erweiterungsplatine  laBt  sich  durch  Jumper  auBerdem  einstellen,  wo  die 
Startadresse  des  FAST-RAM  liegen  soil.  Bbenfalls  laBt  sich  iiber  einen  Jumper  der  Burst-fill- 
Modus  wahlweise  abschalten  (die  Standardeinstellung  ist  natiirlich  mit  Burst-fill-Modus!). 


Der  Cartridgeport  beim  TT 

ATARI  hat  beim  TT  auch  den  AnschluB  fiir  ROM-Cartridges  beibehalten.  Dieser  ist  bis  auf 
weiteres  kompatibel  zum  ST(E)-Cartridge- AnschluB.  Also  keine  Erweiterung  des  1 28  KByte- 
AdreBraums  am  Cartridge-Port,  Allerdings  finden  sich  die  128  KByte  des  Cartridges  zum 
einen  im  ST-AdreBraum  an  gewohnter  S  telle  (bei  $FA  0000 ..  $FB  FFFF)  als  auch  am  oberen 
Ende  des  32  Bit-AdreBraums  bei  $FFFA  0000..$FFFB  FFFF! 

Die  Behandlung  der  Cartridge-Software  funktioniert  weiterhin  wie  bereits  beim  ST  erlautert. 

Ein  Unterschied  besteht  jedoch  in  bezug  auf  das  Timing.  Da  der  TT-Cartridge- AnschluB  sich 
in  einer  1 6  MHz-Umgebung  befindet,  werden  manche  Dongles  mit  speziellen  Zugriffsmecha- 
nismen  evtl.  Probleme  mit  dem  etwas  anderen  Timing  haben.  Das  liegt  unter  anderem  daran, 
daB  jetzt  nichtmehr  die_UDS-  und  JLDS-Signale  (Upper  Data  Strobe  und  Lower  Data  Strobe) 
fiir  den  Cartridgeport  von  der  CPU  erzeugt  werden,  sondem  von  der  MCU  nachgebildet  wer¬ 
den.  Die  MC68030-CPU  mit  ihren  32  Bit  Busbreite  benutzt  fiir  die  Signalisierung,  welche 
Datenbusbreite  sie  beim  laufenden  Buszyklus  verwenden  will,  ja  die  Signale  SIZ0  und  SIZ1 
sowie  _DS  ACK0  und_DSACKl ! 

AuBerdem  hat  ATARI  einen  kleinen  Schritt  in  Richtung  Sicherheit  gemacht  und  die  +5V- 
Leitung  zum  Cartridge-Port  im  TT  iiber  eine  Sicherung  (0,5  A)  gefuhrt. 

Seinen  ursprunglichen  Zweck,  namlich  das  Bereitstellen  von  Software  auf  ROM-Modulen, 
erfullt  der  TT-Cartridgeport  jedoch  ohne  weitere  Modifikationen  bei  bereits  bestehenden 
Modulen.  Schnellere  ROMs  bzw.  EPROMs  als  am  ST(E)  sind  am  TT-Cartridgeport  also  nicht 
erforderlich! 

Soviel  zu  ROM  und  RAM  im  TT.  Das  Alfemate-RAM  im  Uhrenchip  wird  bei  der  Besprechung 
des  MC146818  (so  heiBt  der  Uhrenchip  im  TT!)  mit  angesprochen. 
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Kapitel  4:  Der  Videocontroller  im  TT 


ATARI  hat  dem  TT  zusatzlich  zu  den  schon  vom  ST(E)  her  bekannten  Grafikbetriebsarten 
einige  TT-spezifische  Modi  eingebaut.  Insgesamt  sechs  verschiedene  Bildschirinaufldsungen 
sind  beim  TT  nun  moglich.  Insbesondere  fiir  die  TT-spezifischen  Auflosungen,  bei  denen  der 
Bildschirmspeicher  nahezu  die  fiinffache  GroBe  gegeniiber  dem  ST-Bildschirmspeicher  auf- 
weist,  ist  natiirlich  eine  entsprechend  schnelle  Videohardware  erforderlich. 

In  der  hochsten  Auflosung  werden  1280  x  960  Bildpunkte  in  Monochrom  dargestellt.  Das 
Ganze  funktioniert  dank  einer  hohen  Vertikalen  Ablenkfrequenz  von  71  Hz  auch  noch  flim- 
merfrei!  Bei  so  hohen Pixeltakten  greift  ATARI  dann aber  auch  auf  bewahrte  Spezialchips  fiir 
den  Taktoszillator  und  das  Shiftregister  zuriick  (National  Semiconductor  Chip-Set  mit 
DP8530  und  DP8516).  Die  Horizontale  Ablenkfrequenz  liegt  in  dieser  Betriebsart  dann  bei 
ca.  74  kHz!  Fiir  die  anderen  Modi  verwendet  ATARI  “hausgemachte”  Videohardware,  wie 
schon  bei  der  ST(E)-Serie, 


Der  VideoanschluB 

Beim  TT  ist  ATARI  von  den  Spezialsteckverbindem  der  ST(E)-Serie  abgegangen  und 
verwendet  nun  gleiche  Steckverbinder  wie  beim  “Industriestandard”.  So  findet  sich  fiir  den 
MonitoranschluB  denn  auch  eine  15polige  Subminiatur-D  Buchse  mit  “kleinem”  Kontaktab- 
stand.  Die  Belegung  dieser  Buchse  ist  in  Abbildung  4. 1  dargestellt. 
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Abb.  4.1:  Der  Videoanschlu.fi  beim  TT 
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Da  aber  die  TT-Hoeh-Auflosung  ebenfalls  uber  diese  Buchse  gefiihrt  ist,  kann  man  bei  der 
Belegung  nicht  von  einer  Kompatibilitat  zum  “Industriestandard”  sprechen.  Allerdings  lassen 
sich  handelsiibliche  V GA-Monitore  in  den  ersten  fiinf  Auflosungen  am  TT  betreiben.  Das  liegt 
damn,  daB  ATARI  im  TT  bei  einer  Vertikal-Ablenkfrequenz  von  60  Hz  bleibt  (auch  bei  der 
ST-Hoch-Auflosung!  Also  aus  ist’s  mit  der  Flimmerfreiheit  in  ST-Hoch  am  IT!). 

Die  horizontale  Ablenkfrequenz  liegt  bei  ca.  32  kHz  in  den  unteren  fiinf  Auflosungen. 

Fiir  die  Signalpegel  der  drei  Farbsignalausgange  unddie  Synchronsignale  gilt  das  gleiche,  wie 
bereits  beim  ST(E)  gesagt.  R-,  G-  und  B-AnschluB  liefem  an  einer  Last  von  7512  eine 
Signalamplitude  von  1  Vss.  Die  V -  und  H-Synchronimpulse  liegen  im  TTL-Pegel  vor  und  sind 
Low-Aktiv! 

Warum  ATARI  allerdings  nur  ca.  75%  der  horizontalen  Breite  einer  Zeile  nutzt,  ist  mir  nicht 
klar.  So  konnte  man  doch  immerhin  statt  der  momentanen  max.  640  Pixel  pro  Zeile  “locker” 
auf  uber  800  bis  900  Pixel  pro  Zeile  kommen. 


Die  ST-Betriebsmodi 

Die  Organisation  des  Bildspeichers  in  den  ST- Auflosungen  ist  die  gleiche,  wie  bereits  fiir  den 
ST(E)  beschrieben.  Auch  hier  wird  wieder  mit  Bitplanes  gearbeitet.  In  alien  drei  ST-Modi  ist 
die  Groile  des  Bildschirmspeichers  32000  Byte! 


ST -High-Resolution 

Im  ST-Monochrombetrieb  wird  der  gesamte  Bildschirmspeicher  als  eine  Bitplane  aufgefaBt. 
Je  40  Words  entsprechen  einer  Bildschirmzeile. 

Das  erste  Word  im  Bildschirmspeicher  ist  dabei  in  der  ersten  Bildschirmzeile  fiir  die  ganz  links 
stehenden  16  Bits  zustandig.  Siehe  hierzu  auch  Abbildung  2.6  im  ST-Hardwareteil  “Das 
Grafiksystem”. 

Das  hochstwertige  Bit  jedes  Words  ist  dem  ganz  links  liegenden  Pixel  der  16  durch  dieses 
Word  gesteuerten  Bildpunkte  zugeordnet. 

ATARI  bezeichnet  diesen  Modus  auch  als  Duochrom-Modus!  Es  konnen  namlich  nicht  nur 
die  ZustandeSchwarz  und  Weil!  dargestellt,  sondem  zwei  Farben  aus  der  256  Register  umfas- 
senden  TT-Palette  fiir  Vorder-  und  Hintergrund  benutzt  werden.  Verwendet  werden  immer 
die  beiden  Farben  aus  den  beiden  letzten  TT-Farbpaletten-Registem  (Nr.  254  und  Nr.  255). 


Der  Videocontroller  im  TT 
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ST  'Medium-Resolution 

Hiermit  konnen  je  Zeile  640  Bildpunkte  angesteuert  werden.  In  vertikaler  Richtung  werden 
200  Zeilen  geschrieben,  was  bei  vielen  grafischen  Abbildungen  zu  “verzerrten”  Proportionen 
fiihrt.  Die  Farbe  eines  Pixels  kann  aus  einem  von  den  ersten  vier  Farbpalettenregistem 
ausgewahlt  werden.  Jedes  Palettenregister  bietet  die  Moglichkeit,  4096  Farben  einzustellen. 
Die  Organisation  der  Farbbits  der  drei  Primarfarben  ist  dabei  die  gleiche  wie  beim  STE. 

Diese  Colorbetriebsart  arbeitet  mit  zwei  wortweise  ineinander  verzahnten  Bitplanes.  Je  zwei 
“iibereinander”  liegende  Bits  dieser  Planes  bilden  einen  Indexwert  fitr  das  auszuwahlende 
Farbregister.  Dieses  Farbregister  enthalt  dann  je  4  Bits  fur  die  drei  Primarfarben  Rot,  Griin  und 
Blau.  Die  Pixelfarbe  wird  also  indirekt  liber  den  Indexwert  aus  je  2  Bits  der  beiden  Bitplanes 
abgeleitet.  Siehe  hierzu  auch  Abbildung  2.7  im  ST-Hardwareteil  “Das  Grafiksystem”.  Eine 
Bildschirmzeile  besteht  in  dieser  Betriebsart  aus  zweimal  40  Wortem  zu  16  Bits! 


ST-Low-Resolution 

Das  Darstellungformat  umfaBt  320  (hor.)  x  200  (vert.)  Bildpunkte.  Jedes  Pixel  kann  von  seiner 
Farbe  her  aus  einem  von  16  Farbpalettenregistem  ausgewahlt  werden.  Auch  hier  laBt  sich  in 
jedem  Farbpalettenregister  eine  von  4096  Farben  einstellen. 

Es  wird  mit  vier  wortweise  ineinander  verzahnten  Bitplanes  gearbeitet.  Je  vier  “iibereinander” 
liegende  Bits  bilden  dann  den  Indexwert  fur  das  zu  selektierende  Palettenregister  mit  der 
Pixelfarbinformation.  Eine  Bildschirmzeile  besteht  aus  viermal  20  Wortem  zu  je  16  Bits!  Sie¬ 
he  auch  Abbildung  2.8  im  ST-Hardwareteil  “Das  Grafiksystem”. 


Die  TT-Grafik-Retriebsarten 

Die  Video-Hardware  des  TT  bietet  noch  weitere  drei  Aufldsungen,  Bis  auf  die  TT-High- 
Auflosung  lassen  sich  auch  diese  Darstellungsmodi  auf  dem  gleichen  Monitor  wie  die  ST- 
Modi  abbilden.  In  alien  drei  TT-Modi  ist  die  GroBe  des  Bildschirmspeichers  ebenfalls  wieder 
gleich.  Sie  betragt  namlich  genau  153600  Byte! 


TT-Low-Resolution 

Diese  Betriebsart  bildet  320  Pixel  je  Zeile  bei  480  Zeilen  pro  Bild  ab.  Dabei  laBt  sich  die  Farbe 
eines  Pixel  aus  einem  von  256  (!)  Farbpalettenregistem  auswahlen.  Jedes  Palettenregister 
kann  eine  von  4096  moglichen  Farbeinstellungen  aufweisen. 
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Um  aus  256  Palette-Registem  auswahlen  zu  konnen,  sind  8  Bits  zur  Indexbildung  erforder- 
lich.  Deshalb  wird  in  dieser  Aufldsung  mit  acht  wortweise  ineinander  verschachtelten  Bit- 
planes  gearbeitet.EineBildschirmzeileistdamit  320  Pixel/  16  (Bits  pro  Wort)  x  acht  (Planes) 
=  160  Words  “lang”.  Bei  480  Zeilen  pro  Bild  ergibt  das  einen  Bildschirmspeicher  der  GroBe 
von  153600  Bytes  (WZBW  =  Was  Zu  Beweisen  War). 


Abb.  4.2:  Die  Organisation  des  Bildschirmspeichers  in  TT-Low 


TT -Medium-Resolution 

Es  werden  je  Zeile  640  Pixel  dargestellt.  In  vertikaler  Richtung  werden  480  Zeilen  geschrie- 
ben.  Je  Pixel  kann  aus  einem  der  unteren  16  Farbpalettenregister  der  Wert  fur  die  Pixelfarbe 
(1  aus  4096  Farbeinstellungen  je  Palettenregister  moglich)  entnommen  werden. 


Der  Videocontroller  im  TT 
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Da  nur  aus  den  ersten  16  Palettenregistem  der  256  moglichen  ausgewahlt  wird,  sind  aueh  nur 
vier  Bits  (=  Planes)  zur  Bildung  der  Palettenreg.-Nummer  erforderlich.  Diese  vier  Bitplanes 
sind  ebenfalls  wortweise  ineinander  verzahnl,  wie  in  der  Abbildung  4.3  dargestellt. 

Eine  Bildschirmzeile  belegt  im  Bildschirmspeicher  4  x  640/16  —  160  Words  (-  320  Bytes). 


imxR 

Bjra 

liragBW 

i 

2  2 
,  EH  E3 1 


Bit  plane  B 


Bit  plane  JL 


Bit  plane  2 


Bit  plane  3 


Farbreaister 


Bitkonbi nation  selek- 
tiert  eines  der  16 
Farbregister 


/ 

7 

Register  0 

Register  1 

| 

i 

Register  14 

5 

Register  15 

B 

Registerinh . 
bestinnt 
Pixelf arbe 


Abb.  4.3:  Die  Organisation  des  Bildschirmspeicher s  bei  TT-Medium 


TT-High-Resolution 

Genau  schon  wie  beim  ST(E)  die  High-Resolution  benotigt  auch  diese  hochauflosende  Bild- 
schirmdarstellung  beim  TT  einen  speziellen  Monitor. 

Hier  wird  mithohen  Ablenkfrequenzen  von  71  Hz  fur  die  Vertikalfrequenz  und  ca.  74  kHz 
fiir  die  Horizontalfrequenz  gearbeitet.  Zum  einen  soli  ein  ruhiges  Bild  fur  die  Augen  erzielt 
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werden  (hohe  V-Frequenz),  und  zum  anderen  soil  eine  groCc  Menge  an  Zeilen  (hohe  H- 
Frequenz)  auf  dem  Schirm  dargestellt  werden.  Das  fuhrt  aber  ebenfalls  mit  den  geforderten 
1280  Pixeln/Zeile  zu  hohen  Pixeltakten. 

Im  giinstigsten  Fall  (ohne  vordere  und  hintere  Sch  warzschulter  einer  Zeile  =  linker  und  rechter 
Rand  einer  Bildschirmzeile,  der  schwarz  geschaltet  wird,  um  Zeilenriicklaufe  unsichtbar  zu 
machen,  und  ohne  Zeilensynchronimpulse  zu  beriicksichtigen)  sind  dabei  Pixeltakte  von  1280 
x  74  kHz  =  95  MHz  zu  erwarten! 

Dafiir  braucht  man  zum  einen  schon  hochwertige  Monitore  mit  entsprechenden  Bandbreiten 
im  Videoteil  und  schnellen  Strahlablenksystemen  fiir  die  hohen  Ablenkfrequenzen. 

Zum  anderen  ist  der  Videocontroller  natiirlich  ebenfalls  auf  solche  Anforderungen  hin  auszu- 
legen.  Atari  hat  dabei  allerdings  nicht  auf  “Hausgemachtes”  zuriickgegriffen,  sondem  einen 
bewahrten  Chipsatz  (Oszillator  und  Shifter)  von  National  Semiconductor  eingesetzt. 

Unter  anderem  kann  man  diese  Pixelinformation  auch  nicht  mehr  in  TTL-Technik  ausgeben, 
sondem  verwendet  spezielle  differentielle  Ausgangstreiberstufen  in  ECL-Technik  (Emitter 
Coupled  Logic)  dazu. 


Abb.  4.4:  Die  Organisation  des  Bildschirmspeichers  in  TT-High 


Der  Videocontroller  im  TT 
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Der  Bildschirmspeicher,  mit  seinen  auch  hier  153600  Bytes,  wird  als  eine  Bitplane  interpre- 
tiert.  Jedes  Bit  reprasentiert  also  ein  Pixel.  Pro  Bildschirinzeile  werden  80  Words  zur  Darstel- 
lung  der  Pixelinformation  verwendet. 


Die  Programmierung  der  Video-Hardware 

Auch  bei  der  Video-Hardware  im  TT  hat  ATARI  versucht,  moglichst  viele  Funktionen  in 
niogiichst  wenigen  Bausteinen  zu  integrieren.  So  reduziert  sich  die  Hardware  fur  alle  Betriebs- 
arten  mit  60  Hz  V-  und  32  kHz  H-Frequenz  (also  ohne  die  TT-High-Auflosung)  auf  einen 
Chip.  Allerdings  sind  auch  im  TT  wieder  einige  Funktionen  der  Video-Hardware  in  andere 
Custom-Chips  ausgelagert  worden. 

Die  Umsetzung  der  Bildspeicherdaten  in  Bildinformationen  iibemimmt  der  TT-SHIFTER. 
Dort  sind  die  Schieberegister  untergebracht,  die  die  Bildschirmspeicherbits  nach  dem  paral- 
lelen  Laden  iiber  den  Datenbus  mit  MCU-  und  FUNNEL-Hilfe  seriell  als  Bildinformations- 
signal  ausgeben.  (FUNNEL  =  Trichter;  diese  Spezial-Chips  setzen  den  64  Bit  breiten  ST- 
RAM-Datenbus  fur  den  “Rest  des  TTs”  auf  32  Bit  um  und  erlauben  der  Videohardware  einen 
Zugriff  auf  immer  64  Bits  auf  eintnal!) 

Der  Video-Adress-Counter  und  das  Video-Base-Register  sind  allerdings  in  der  MCU  zu 
finden.  Da  bei  einer  ST-RAM-Erweiterungnoch  eine  zweite  MCU  auf  derErweiterungsplatine 
vorhanden  ist,  findet  man  auch  dort  ebenfalls  diese  Video-Register! 

Die  Digital/Analog-Wandler  fur  die  Umsetzung  der  digitalen  Farbintensitatsinformation  in 
ein  analoges  Intensitatssignal  fur  jede  Primarfarbe  sind  im  TT-SHIFTER  untergebracht.  Fiir 
das  Timing  bekommt  der  TT-SHIFTER  einen  32-MHz-Takt  eingespeist,  aus  dem  er  dann  die 
erforderlichen  Synchronsignale  erzeugt.  AuBerdem  liefert  der  TT-SHIFTER,  aus  dem  32- 
MHz-Mastertakt  abgeleitet,  Takte  von  16  MHz  fiir  den  Rest  des  Systems,  einen  4-MHz-Takt 
fiir  die  beiden  MFPs  und  einen  2-MHz-Takt  fiir  z.  B.  den  Sound-Chip  und  den  DMA-Sound- 
SHIFTER.  Des  weiteren  kommen  vom  TT-SHIFTER  die  H-  und  V-Synchronsignale  und  das 
Display-Enable-Signal! 

Die  Einbindung  der  Video-Hardware  beim  TT  zeigt  die  Abbildung  4.5. 


Die  Video-Hardware-Register  im  TT 

Aus  Kompatibilitatsgriinden  zum  ST(E)  findet  man  fur  diedrei  ST-Auflosungen  die  zugeho- 
rigen  Hardware-Register  an  der  gleichen  Stelle  (Adresse)  wie  beim  ST(E)!  Zusatzlich  kann 
man  aber  auch  am  obersten  Ende  des  MC68030er-Adre6raums  darauf  zugreifen. 
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Abb.  4.5:  Schaltungsauszug  mil  der  TT-Video-Hardware 


SST-Hd 


Der  Videocontroller  im  TT 
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Video-Base-Register 

Der  Anfang  des  Bildschirmspeichers  fur  alle  Betriebsmodi  wird  der  Video-Hardware  iiber  das 
Video-Base-Register  mitgeteilt. 


Adresse 

Modus 

Funktion 

Label 

$(FF)FF  8201 

R/W 

Video-Base-Reg.  High-Byte 

“dbaseh” 

$(FF)FF  8203 

R/W 

Video-Base-Reg.  Medium-Byte 

“dbasel” 

$(FF)FF  820D 

R/W 

Video-Base-Reg.  Low-Byte 

“dbaselow” 

Beim  Low-Byte  der  Video-Base- Adresse  (“dbaselow”  an  Adr.  $(FF)FF  820C)  haben  die  Bits 
0.  .2  keine  Funktion,  sprich:  sie  werden  immer  als  0  angenommen.  Damit  kann  der  Bildschirm- 
speicher  im  ST-RAM  immer  nur  an  einer  8-Byte-Schwelle  liegen.  Die  Video-Hardware 
bearbeitet  ja  bei  einem  Speicherzugriff  auch  immer  64  Bits  (8  Byte)  auf  einmal! 


Video-Address-Counter 

Die  in  diese  drei  Register  einzuschreibende  24  Bit- Adresse  wird  bei  jedem  neuen  Bildbeginn 
in  den  Video-Adress-CoitnierubcrtvAgcn.  Dort  wird  sie  dann  laufend  hochgezahlt,  bis  das  Bild 
fertig  aufgebaut  ist. 


Adresse 

Modus 

Funktion 

Label 

$(FF)FF  8205 

R 

Video-Address-Counter 

High-Byte 

“vcounthi” 

$(FF)FF  8207 

R 

Video-Address-Counter 

Medium-Byte 

“vcountmid” 

$(FF)FF  8209 

R 

Video-Address-Counter 

Low-Byte 

“vcountlow” 

Im  Gegensatz  zum  STE  konnen  diese  Register  nur  gelesen  werden.  Also  keine  groBartigen 
Tricks  mit  “changing  Video-Counter-Register  on  the  fly!”  fiir  Display-Manipulationen  wah- 
rend  des  Bildaufbaus  moglich! 


Sync-Mode-Register 

Aus  Kompatibilitatsgriinden  zum  ST  existiert  dann  noch  das  ST -Sync-Mode-Register,  das  sich 
aber  gar  nicht  kompatibel  zum  ST(E)  verhalt. 
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Adresse 

Modus 

Funktion 

Label 

$(FF)FF  820A 

R/W 

ST -Sync-Mode-Register 

“syncmode” 

In  diesem  Register  hat  nur  das  Bit  0  iiberhaupt  eine  Funktion.  Beim  ST  wurde  dort  durch 
Setzen  des  Bits  0  auf  exteme  Synchronisation  des  STs  umgeschaltet.  Beim  TT  ist  es  genau 
umgekehrt.  Wenn  das  Bit  0  gesetzt  ist,  erhaltman  ein  Bild,  sonst  werden  die  Synchronsignale 
abgeschaltet! 

ST-Farbregister 

Aus  Kompadbilitatsgriinden  existieren  im  TT  an  gewohnter  Stelle  wie  im  ST(E)  die 
16  Palettenregister  zur  Auswahl  der  Pixelfarbe.  Die  Bitbelegung  fur  die  drei  Primarfarben  ist 
die  gleiche  wie  beim  STE.  Die  unteren  drei  Bits  jedes  Nibbles  weisen  von  rechts  nach  links 
steigende  Wertigkeiten  fur  den  Intensitatswert  auf.  Allerdings  hat  dann  das  hochstwertige  Bit 
eines  Nibbles  bei  der  Festlegung  der  Farbintensitat  die  geringste  Gewichtung  (kompatibel  zu 
STE-Palettenregistem)!  DienachfolgendeTabellezeigtdieAdreBlageder  16  STE-kompatiblen 
Palettenregister  im  TT  und  ihre  Bitbelegung. 


Adresse 

Modus 

Bitbelegung 

Label 

$(FF)FF  8240 

R/W 

XXXXrRRR  gGGGbBBB 

“colorO” 

$(FF)FF  8242 

R/W 

XXXX  rRRR  gGGG  bBBB 

“colorl” 

$(FF)FF  825C 

R/W 

XXXX  rRRR  gGGG  bBBB 

“colorl4” 

$(FF)FF  825E 

R/W 

XXXX  rRRR  gGGG  bBBB 

“color  15” 

Atimerkung:  Bitpositionen  mit  Kleinbuchstaben  weisen  auf  das  niedrigstwertige  Farbwertbit 
hin! 

Diese  16  ST(E)-Palettenregister  sind  jedoch  nicht  separat  von  den  256  TT-Farbregistem  zu 
sehen,  sondem  stellen  vielmehr  ein  Subset  der  TT-Farbregister  dar.  Durch  die  vier  untersten 
Bits  im  TT-Shift-Mode-Register  wird  namlich  festgelegt,  welche  16er-Registergruppe  der 
256  TT-Farbregister  an  den  Adressen  der  ST-Farbregister  auftaucht. 


ST-Shift-Mode-Register 

Ebenfalls  aus  Kompatibilitatsgriinden  existiert  an  (vom  ST(E)  her)  gewohnter  Adresse  das 
ST-Shift-Mode-Register. 


Der  Videocontroller  im  XT 
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Hiertiber  wird  die  gewunschteBetriebsartfurden  TT-SHIFTER  programmiert.  Die  Bitbelegung 
ist  kompatibel  zum  ST(E), 


Adresse 

Modus 

Funktion 

Label 

$(FF)FF  8260 

R/W 

ST-Shift-Mode-Register 

“shiftmd” 

xxxx  xxMM  xxxx  xxxx  (Word) 


00 
0  1 
10 
1  1 


ST-Low  (320  x  200,  4  Planes) 
ST-Mid  (640  x  200,  2  Planes) 
ST-High  (640  x  400,  1  Plane) 
<Reserviert> 


Allerdings  tauchen  bei  Verwendung  der  TT-spezifischen  Betriebsmodi  deren  Einstellungen 
ebenfalls  in  diesem  Shift-Mode-Register  auf!  Das  gilt  sowohl  fur  die  Modus-Bits  als  auch  fur 
die  Palettenbank.  Man  findet  also  die  im  TT-Shift-Mode-Register  eingestellten  Werte  eben¬ 
falls  im  ST-Shift-Mode-Register  wieder! 


TT-Shift-Mode-Register 

Sowohl  die  ST-Grafikmodi  als  auch  die  speziellen  TT-Betriebsarten  lassen  sich  in  diesem  TT- 
eigenen  Register  einstellen.  Die  Bitbelegung  ist  die  gleiche  wie  im  ST-Shift-Mode-Register, 
nur  daB  halt  noch  ein  paar  Steuerbits  hinzugekommen  sind! 


Adresse 

Modus 

Funktion 

Label 

$(FF)FF  8262 

R/W 

TT-Shift-Mode-Register 

“shift_TT” 

SxxHxMMM 


xxxx  PPPP  (Word) 

I  1 _ Registerbank  fiir 


ST-Palette 


000  ST-Low  (  320  x  200, 4  Planes) 
0  0  1  ST-Mid  ( 640  x  200,  2  Planes) 

0  1  0  ST-High  ( 640  x  400,  1  Plane) 

0  1  1  <Reserviert> 

1  0  0  TT-Mid  ( 640  x  480, 4  Planes) 

10  1  <Reserviert> 

1  1  0  TT-High  (1280  x  960, 1  Plane) 

1  1  1  TT-Low  (  320  x  480,  8  Planes) 

-  Hyper-Mono-Modus 

Sample  &  Hold-Mode 
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Mit  den  untersten  vier  B  its  dieses  Registers  wird  festgelegt,  welcher  Registersatz  der  256  TT - 
Palette-Register  fur  die  16  ST(E)-kompatiblen  Farbpalettenregister  verwendet  wird.  Ein 
Wert  von  Null  wahlt  also  die  TT-Farbregister  0..15  fur  die  ST(E)-Farbregister  aus!  Durch 
Andern  dieser  vier  Bits  lassen  sich  alle  16  ST(E)-Farbregister  “auf  einen  Schlag”  verandem! 

Mit  Setzen  von  Bit  12  in  diesem  Register  wird  der  Hyper-Mono-Modus  eingeschaltet.  Damit 
laBt  sich  der  Tl'-SHIFTER  auf  einen  speziellen  Monochrom-Modus  mit  256  Graustufen  pro- 
grammieren.  Dabei  werden  im  TT-SHIFTER  die  D/A-Wandler  fiir  den  Griin-  und  Blau-Kanal 
zusammengefaBt.  Dazu  sind  acht  Intensitatsbits  notig.  Die  vier  hochstwertigen  Intensitats- 
bits  kommen  vom  Griin-Kanal,  das  niederwertige  Nibble  aus  den  Palettenbits  des  Blau-Ka- 
nals. 

Das  Sample  &  Hold-Bit  sorgt  daftir,  daft  so  eine  Art  Schmiereffekt  auf  dem  Bildschirm  erzielt 
wird.  Anstelle  der  Hintergrundfarbe  (Farbe  0)  wird  die  zuletzt  benutzte  Farbe  weiterverwen- 
det.  Einfach  mal  ausprobieren! 


Die  TT-Palette-Register 

Diese  256  Farbregister  konnen  alle  einzeln  angesprochen  und  geandert  werden.  Jedoch  nur 
die  TT-Low-Betriebsart  verwendet  auch  alle  256  Register  bei  der  Darstellung.  Die 
256  Farbregister  sind  in  16  ’’Banks”  zuje  16  Registemaufgeteilt,vondenen  dannimmereine 
Bank  als  ST-Farbregistersatz  verwendet  wird.  WelcheBank  das  ist,  wird  mit  den  vier  untersten 
Bits  im  TT-Shift-Mode-Register  eingestellt. 

Die  Farbintensitiit  kann  mit  jeweils  vier  Bits  fur  jede  der  drei  Primarfarben  eingestellt  werden. 
Dabei  hat  ATARI  die  Gewichtung  der  Bits  aber  wieder  in  eine  vemiinftigere  Form  gebracht 
(also  nicht  mehr  Least  significant  Bit  ganz  links  im  Nibble  wie  im  STE,  sondem  LSB  ganz 
rechts  und  MSB  ganz  links  im  Nibble!).  Da  ja  die  TT-Palette-Register  auch  fiir  die  ST(E)- 
Palette-Register  benutzt  werden,  muB  diese  unterschiedliche  Behandlung  der  Intensitats- 
steuerung  an  gepaBt  werden.  Das  geschieht  aberhardwaremaBig.  Die  Beziehung  “Hochstwertiges 
Bit  im  STE-Farbnibble  wird  niedrigstwertiges  Bit  im  TT-Farbnibble”  und  umgekehrt  ist  be- 
reits  per  Hardware  realisiert! 


Adresse 

Modus 

Bitbelegung 

Label 

$(FF)FF  8400 

RAV 

XXXX  RRRr  GGGg  BBBb 

“TT_col0” 

$(FF)FF  8402 

R/W 

XXXXRRRr  GGGg  BBBb 

“TT_coll” 

$(FF)FF  85FC 

RAV 

XXXX  RRRr  GGGg  BBBb 

“TT_col254” 

$(FF)FF  85FE 

RAV 

XXXX  RRRr  GGGg  BBBb 

“TT_col255” 

Der  Videocontroller  im  TT 
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Betriebssystemunterstiitzung  der  Video-Hardware 

AUe  diese  neuen  Moglichkeiten  der  Videohardware  wollen  und  sollen  naturlich  moglichst 
einfach  und  standardisiert  genutzt  sein.  Deshalb  hat  ATARI  eine  Menge  neuer  XBIOS- 
Aufrufe  im  TT-TOS  eingebaut,  um  dem  Programmierer  das  direkte  Manipulieren  der 
Hardware-Register  nach  Mdglichkeit  zu  ersparen. 

Im  Kapitel  zum  XBIOS  sind  diese  neuen  Aufrufe  mit  entsprechender  Beschreibung  zu  finden. 
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Kapitel  5:  Und  weil’s  so  schon  war  - 
Noch’n  MFP  iin  TT 


Da  ja  im  TT  einiges  an  Hardware  zusatzlich  vorhanden  ist,  unter  anderem  eben  auch  zusatz- 
liche  serielle  Schnittstellen,  hat  ATARI  zur  Unterstiitzung  einen  weiteren  MFP-Baustein 
(MC68901)  spendiert. 


Der  ST-MFP  im  TT 

Der  “alte"  MFP  im  TT  hat  die  gleichen  Aufgaben  wie  im  ST(E)  iiberoommen  und  verhalt  sich 
auch  kompatibel  dazu.  Das  heiBt  unter  anderem  auch,  daB  durch  die  gleichen  DMA-Sound- 
Fahigkeiten,  wie  schon  im  STE,  eine  “Doppelbelegung”  des  Portanschlusses  107  vorgenom- 
men  wurde.  Es  werden  ja  dariiber  sowohl  die  Monochrom-Detect-Leitung  des  Monitors  als 
auch  das  DMA-Sound-Aktiv-Signal  abgefragt.  Naheres  dazu  kann  man  im  Anhang  “Die 
Hardware  des  STE”  nachschlagen.  Auch  beim  TT  gibt’s  nattirlich  das  Monochrom-Detect- 
Signal,  welches  hier  vom  Pin  9  der  Monitorbuchse  stammt  und  mit  dem  DMA-Sound-Aktiv- 
Signal  ver”Exklusiv  Oder”!  wird. 

Da  es  beim  TT  allerdings  keinen  BLITTER  gibt,  ist  die  sonst  an  103  angeschlossene 
Interruptleitung  des  BLIHERs  hier  nicht  vorhanden.  ATARI  hat  dafiir  diesen  AnschluB  mit 
einem  Signal  CLKDIR  (Clock  Direction  ???)  belegt,  dessen  Bedeutung  nicht  unmittelbar  aus 
der  Schaltung  ersichtlich  ist.  Es  scheint  aber  in  Verbindung  mit  dem  Netzwerkinterface  des 
TT  zu  stehen.  Ich  konnte  mir  vorstellen,  daB  man  diesen  Port  als  Ausgang  benutzt,  um  damit 
(iiber  ein  PAL)  dem  SCC-Baustein  auf  Kanal  A  einen  TT-intemen  Takt  aufzuschalten. 

Die  Bezeichnung  des  Seriellen  Ports,  der  mit  dem  ST-MFP  realisiert  und  zum  ST(E) 
kompatibel  ist,  lautet  auf  “Serial  Port  C”  bzw.  “MODEM  1”  und  ist  auf  eine  9polige  Sub-D- 
Buchse  zusammengeschrumpft.  Auch  hier  ist  wieder  ( wie  beim  ST(E»  der  Soundchip  bei  den 
Handshakesignalen  (RTS  und  DTR)  beteiligt!  Also  alles  beim  alten  geblieben. 


Der  “neue”  MFP  im  TT 

Durch  den  Einsatz  von  neuen  DMA-fahigen  Schnittstellen  im  TT,  wie  den  SCSI-Port  und  die 
zwei  seriellen  Schnittstellen  iiber  den  SCC  (Serial  Communications  Controller  vom  Typ 
Z85C30),  benotigt  man  nattirlich  entsprechende  Meldeeingange,  um  z.  B.  den  AbschluB  von 
DMA-Operationen  signalisiert  zu  bekommen. 
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Also  hat  man  einen  zweiten  MFP-Baustein  verwendet,  bei  deni  zusatzlich  zuden  interruptfahigen 
Eingangsports  noch  eine  serielle  Schnittstelle  als  “Abfallprodukt”  herausschaute  (wird  als 
SERIAL  1  bezeichnet).  Diese  serielle  Schnittstelle  verfiigt  jedoch  iiber  keinerlei  Steuer-  und 


Abb.  5.1:  Einbindung  der  beiden  MFPs  in  die  TT-Hardware 
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Meldeleitungen!  Lediglich  Empfangs-  und  Sendedatenleitung  stehen  zur  Verfiigung.  Dieser 
zweite  MFP  (in  Zukunft  als  TT-MFP  bezeichnet)  liegt  schaltungsmaBig  “parallel”  zum  bereits 
vorhandenen  MFP.  Diese  Parallelschaltung  bezieht  sich  jedoch  nur  auf  die  Anbindung  zum 
Daten-  und  AdreBbus  und  die  erforderlichen  Leitungen  zum  Control-Bus.  Allerdings  gibt’s 
schon  noch  kleine  Abweichungen.  Die  Abbildung  5. 1  zeigt  die  Einbindung  der  beiden  MFP- 
Chips  in  das  Hardwarekonzept  des  TT. 

Die  Chip-Select-Leitung  ist  bei  den  beiden  MFPs  nattirlich  nicht  die  gleiche,  sondem  der  TT  - 
MFPhatsichnurim  AdreBbereichSFF  FA81 ..  $FFFAAF(bzw.  $FFFF  FA81 ..  $FFFF  FAAF) 
zu  melden.  Dabei  liegen  auch  hier  die  Register  (je  8  Bit  breit!)  des  Bausteins  auf  ungeraden 
Adressen.  Die  Reihenfolge  und  Funktion  der  Register  ist  die  gleiche  wie  beim  ST-MFP,  mit 
folgenden  Ausnahmen: 

Adresse  Zugriff  Funktion  des  Registers  Label 

$FF  FA81  R/W  GPIP-Data-Register  (GPIP)  “GPTP  TT” 

Es  handelt  sich  zwar  um  ein  I/O-Register,  jedoch  initialisiert  das 
gegenwartige  TOS  im  TT  alle  TT-MFP-I/O-Ports  als  Eingange. 
Man  kann  also  iiber  dieses  Register  die  Zustande  der  MFP-Ports 
IO0..IO7  auslesen.  Wenn  man  einzelne  Ports  auf  Ausgang 
schalten  will  (insbesondere  bei  IOO  und  10 1  interessant,  da  diese 
auf  Pfostenfeldleisten  (J602  auf  dem  Motherboard)  gefiihrt 
sind),muBmanentsprechenddieBitsOund  1  imData-Direction- 
Register  setzen!  Durch  Beschreiben  des  GPIP_TT-Registers 
werden  die  als  Ausgange  programmierten  Ports  entsprechend 
gesetzt  oder  riickgesetzt. 

Bit  0  und  1  signalisieren  den  Zustand  der  Anschliisse  IOO  und 
IOl.  Diese  sind  auf  dem  TT-Motherboard  auf  Pfostensteck- 
verbinder  (J602)  gefiihrt  und  konnen  fur  kiinflige  Hardware- 
erweiterungen  verwendet  werden.  Da  die  I/O-Ports  des  MFP 
sowohl  als  Ein-  oder  Ausgang  programmiert  werden  konnen, 
laBt  sich  damit  evtl.  einiges  anfangen. 

Bit  2  ist  das  Interrupt-Request-Signal  vom  SCC-DMA-Bau- 
stein.  Mit  einem  Low  meldet  damit  der  SCC-DMA-Kanal  das 
Ende  einer  DMA-Operation. 

Bit  3  gibt  die  Moglichkeit,  das  “Ring  indicator”-Signal  von  der 
Buchse  MODEM  2  auszuwerten.  Mit  einem  Low  wird  hier  das 
Setzen  dieser  Schnittstellenleitung  signalisiert. 
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Adresse  ZugrifT  Funktion  des  Registers  Label 


Bit  4  kommtvonPin34deseingebautenFloppy-Disk-Laufwerks. 
Uber  diesen  AnschluB  zeigt  die  Floppy  ihren  Betriebszustand  an. 
Manehe  Floppies  liefem  hier  auch  eine  Information  iibcr  einen 
Medienwechsel.  Dieses  Bit  wird  vom  Betriebssystem  aber  nicht 
benutzt 

Bit  5  wird  vom  SCSI-DMA-Controller  beeinfluBt,  der  bei  Auf- 
treten  eines  Busfehlers  wahrend  des  DMA-Prozesses  diesen 
AnschluB  auf  Low  setzt. 

Bit  6  ist  ein  Interrupt-Request  (Low-aktiv)  vom  TT-Uhrenchip. 
Wann  der  Uhrenchip  z.  B.  einen  Interrupt  auslosen  kann,  sollte 
man  in  dem  entsprechenden  Kapitel  iiber  den  RTC  146818 
nachlesen. 

Bit  7  geht  auf  High  (!),  wenn  der  SCSI-Controller-Chip  des  TT 
(Typ  5380)  einen  Interrupt  auslost!  Sowohl  das  TOS  als  auch 
Harddisktreiber  verwenden  dieses  Bit  (allerdings  nur  im  Polling- 
Verfahren),  um  festzustellen,  ob  die  gewunschte  SCSI-Operati- 
on  beendet  wurde.  Also  hat  es  eine  ahnliche  Funktion  wie  das  Bit 
5  beim  ST-MFP  fur  die  Fertigmeldung  von  FDC/ACSI-Bus! 

$FF  FA83  R/VV  Active-Edge-Register  (AER)  “AER  TT” 

Fiir  jedes  Bit  des  I/O-Ports  laBt  sich  hier  einstellen,  bei  welchem 
Flankenwechsel  an  einem  Port  ein  Interrupt  ausgelost  werden 
soil  (wenn  er  denn  iiber  das  Interrupt-Enable-Register  einge- 
schaltet  ist!). 

Ein  gesetztes  Bit  veranlaBt  eine  Interrupt- Anforderung  bei  Low- 
>High-Ubergang  am  entsprechenden  PortanschluB.  Wann  bei 
einem  geloschten  Bit  unterbrochen  wird,  konnen  Sie  sich  jetzt, 
glaube  ich,  selbst  denken! 

$FF  FA85  R/W  Data-Direction-Register  (DDR)  “DDRTT” 

Fiir  jeden  I/O-PortanschluB  existiert  ein  Bit.  Bei  gesetztem  Bit 
ist  der  entsprechende  Port  als  Ausgang  programmiert.  Bei 
geloschtem  Bit  fungiert  der  zugehorige  Port  als  Eingang.  (Das 
TT-TOS  setzt  im  Moment  alle  Ports  als  Eingange!) 
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Die  Timer  des  TT-MFP 

Die  Funktionsweise  der  Timer  kann  im  Kapitel  iiber  den  MFP  im  ST  nachgeschlagen  werden. 
Es  sollen  hier  und  auf  der  folgenden  Seite  nur  kurz  die  Unterschiede  aufgezeigt  werden. 

-  DerTimer-A-Eingangliegtfest  auf  Masse.  Damit  fallen  also  die  BetriebsartPulsbreiten- 
messung  (wen  interessiert  schon  die  Zeitdauer  eines  immer  anliegenden  Low-Signals?) 
und  die  Ereigniszahlung  (es  ereignet  sich  halt  wenig  auf  dem  Massepotential)  als  Anwen- 
dung  weg! 

Bliebe  also  nur  noch  der  Delay  Mode  iibrig.  Vom  TOS  wird  der  Timer  A  jedoch  nicht 
benutzt! 

-  Der  Timer-B-Eingang  liegt  zusammen  mit  dem  gleichen  Eingang  des  ST-MFP  am 
Display-Enable-Signal.  Damit  kann  also  bei  Bedarf  mit  diesem  Timer  ebenfalls  ein 
Zahler  fiir  Bildschirmzeilen  realisiert  werden. 


Die  Adressen  der  Timer-Register  beim  TT-MFP: 

Adresse  Modus  Belegung  Funktion  Label 


$FF  FA99 

R?W 

- RCCCC 

Timer-A-ControFReg.  (‘TACR  TT’) 

$FF  FA9B 

R/W 

- RCCCC 

Timer-B-Control-Reg.  (‘TBCR  TT’) 

1  1  II 

Modus 

Vorteiler 

0000 

Stop 

- 

0001 

Delay 

1  :  4 

0010 

Delay 

1  :  10 

0011 

Delay 

1  :  16 

0100 

Delay 

1  :  50 

0101 

Delay 

1  :  64 

0110 

Delay 

1  :  100 

0111 

Delay 

1  : 200 

1000 

Ereignis 

- 

1001 

Pulsbreite 

1  :  4 

1010 

Pulsbreite 

1  :  10 

1011 

Pulsbreite 

1  :  16 

1100 

Pulsbreite 

1  :  50 

1101 

Pulsbreite 

1  :  64 

1110 

Pulsbreite 

1  :  100 

1111 

Pulsbreite 

1  :200 

Timer  A-  bzw.  B-Ausgang  auf  Low 
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Adresse  Modus  Belegung  Funktion  Label 


$FF  FA9D  R/W  -CCC-DDD  Timer  C+D  Control  Reg.  (‘TCDCRTT’) 

(C:  Takt  fiir  SCC-Channel  2) 

(D:  Baudrate  fiir  SERIAL  1) 


III  III 

Modus 

Vorteiler 

000-000 

STOP 

_ 

001-001 

Delay 

1  :  4 

010-010 

Delay 

1  :  10 

011-011 

Delay 

1  :  16 

100-100 

Delay 

1  :  50 

101-101 

Delay 

1  :  64 

110-110 

Delay 

1  :  100 

111-111 

Delay 

1:200 

Timer: 

(C>  (D) 

$FF  FA9F 

r m 

DDDDDDDD 

Timer-A-Data-Register 

(‘TADR  TT’) 

$FF  FAA1 

R/W 

DDDDDDDD 

Timer-B-Data-Register 

(‘TBDR  TT’) 

$FF  FAA3 

R/W 

DDDDDDDD 

Timer-C-Data-Register 

(‘TCDR  TT’) 

$FF  FAA5 

R/W 

DDDDDDDD 

Timer-D-Data-Register 

(‘TDDR  TT’) 

Weitere  Unterschiede: 


Timer-C  des  TT-MFP  kann  als  Taktgenerator  fiir  den  Kanal  B  des  neuen  SCC-Chips 
verwendet  werden.  Das  TOS  stellt  im  Timer-C  des  TT-MFP  eine  Frequenz  von  ca. 
12,5  kHz  am  Timerausgang  ein  (Timer-C  mit  l:4-Vorteiler  und  Timer-C-Data-Wert 
von  25!).  Der  Kanal  B  des  SCC  kann  allerdings  mit  unterschiedlichen  Taktraten  fiir 
Sende-  und  Empfangsrichtung  betrieben  werden.  Mehr  dazu  bei  der  Beschreibung  des 
SCC! 

-  Genau  wie  beim  ST-MFP  kann  der  Timer  D  des  TT -MFP  als  Baudratengenerator  fiir  den 

seriellen  Port  des  MFP  verwendet  werden.  Da  der  zugrundeliegende  Takt  fiir  den  TT- 
MFP  der  gleiche  ist  wie  beim  ST-MFP,  kann  man  auch  hier  Baudraten  bis  19200  Bd 
einstellen. 


Interrupts  durch  den  TT-MFP 

Der  MFP  kann  ja  ebenfalls  als  Interruptquelle  in  einem  Mikrocomputersystem  auftreten  (siehe 
dazu  auch  die  Erlauterungen  zu  den  MFP-Interrupts  des  STs!).  Diese  Moglichkeit  wollte  sich 
ATARI  beim  TT  natiirlich  fiir  den  TT-MFP  ebenfalls  offenhalten.  So  sind  denn  im  TT  beide 
MFPs,  was  die  Interruptbehandlung  angeht,  “hintereinander  gekettet”.  Fiir  diese  Verkettung 
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besitzt  der  MFP  die  Anschliisse  _IEI  und  JEO.  Eine  Interruptanforderung  stellt  der  MFP  mit 
einem  Low-Signal  auf  dem  _IRQ-AnschluB  (Interrupt  Request).  Diesbeziiglich  sind  die 
beiden  MFPs  parallelgeschaltet.  D.  h. ,  der  MFP,  der  einen  Interrupt  anfordert,  zieht  die  JRQ- 
Leitung  auf  Low.  Daran  erkennt  dieTTSCU  (TT-System  Control  Unit)  eine  MFP-Interrupt- 
anforderung. 

Wahrend  des  nun  folgenden  Interrupt-Bestatigungszyklusses,  der  durch  die  CPU  durchgefiihrt 
wird,  erhalten  die  JACK- Anschliisse  der  beiden  MFPs  dieses  Bestatigungssignal  zugefiihrt. 
Welcher  MFP  nun  “semen”  Interrupt  bearbeitet  bekommt  (also  holier  priorisiert  ist),  wird 
durch  dessen  Position  in  der  JEI  ->  JEO-Verkettung  festgelegt.  Nur  jener  MFP  darf  nun  auf 
eine  Interruptbestatigung  reagieren,  dessen  JEI-AnschluG  auf  Low  liegt.  Als  Folge  davon 
setzt  dieser  MFP  seinen  JEO-AnschluG  auf  High,  und  der  in  der  Kette  dahinter  angeschlosse- 
ne  MFP  hat  sich  aus  dieser  Interruptbestatigung  herauszuhalten! 

Der  Schaltungsauszug  mit  den  beiden  MFPs  im  TT  zeigt  fur  diese  Verkettung  nun  an,  daB  der 
TT-MFP  infolge  seines  immer  aktivierten  JEI-Anschlusses  (fest  auf  Low  gelegt!)  hoher 
priorisiert  ist.  Nur  wenn  vom  TT-MFP  keine  Interruptanforderung  vorliegt,  wird  bei  einem 
Interruptbestatigungszyklus  an  dessen  JEO- Ausgang  ein  Low  liegen  und  damit  dem  ST -MFP 
die  Moglichkeit  gegeben,  “seinen”  Interrupt  bearbeitet  zu  bekommen! 

Jeder  MFP  besitzt  16  Interruptkanale,  die  untereinander  unterschiedlich  gewichtet  sind.  Alle 
acht  I/O-Ports  und  die  vier  Timer  kommen  als  mogliche  Interruptquellen  in  Frage.  AuBerdem 
sind  noch  4  Interruptquellen  bei  der  seriellen  Schnittstelle  des  MFP  zu  finden.  Die  Priorisierung 
der  Interrupts  ist  bei  jedem  MFPgleich  und  kann  deshalb  im  Kapitel  “DerMultifunktionsbaustein 
MFP  68901”  im  Hardwareteil  zum  ST  nachgeschlagen  werden. 

Der  MFP  iibergibt  wahrend  des  Interrupt-Bestatigungszyklusses  der  CPU  eine  eigene  8  Bit 
breite  Vektomummer  (Non-Autovektor-Interrupt  Prinzip).  Daraus  kann  die  CPU  dann,  nach 
Multiplikation  der  Vektomummer  mit  4,  die  Adresse  des  zugehorigen  Interruptvektors  im 
RAM  ermitteln.  Damit  mehrere  MFPs  in  einem  System  unterschiedliche  Vektomummern  er- 
zeugen  konnen,  ist  das  High-Nibble  der  MFP- Vektomummer  im  Intermpt-Vektor-Register 
eines  MFPs  einstellbar.  Das  Low-Nibble  ergibt  sich  dann  aus  der  Kanalnummer,  welcher  den 
Interrupt  ausgelost  hat. 

Im  TT  sorgt  das  TOS  durch  Einsteilen  des  Interrupt-Vektor-Registers  im  ST-MFP  dafiir,  daB 
alle  Vektomummern  mit  dem  Nibble  $4  beginnen  und  damit  die  zugehorigen  Interruptvektoren 
ab  Adresse  $40  x  4  =  $100  im  RAM  zu  finden  sind  (wie  auchbeim  ST(E)).  Fur  den  TT-MFP 
beginnen  alle  Vektomummern  mit  $5,  und  deshalb  findet  man  die  zugehorigen  16  Interrupt¬ 
vektoren  unmittelbar  anschlieBend  an  die  ST-MFP-Interruptvektoren,  ab  Adresse  $140  im 
Speicher.  Die  nachfolgende  Abbildung  zeigt  noch  mal  kurz  die  Lage  der  TT-MFP-Interrupt- 
vektoren  im  RAM: 
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i  ;r*  grow 

Kurzbeschreibg.  der  Interruptquelle 

MFP -Interrupt 

5140 

0 

naskiert 

I/0~Pin  1,  J602  auf  Motherboard 

I/O-Port  B  (100) 

5144 

1 

naskiert 

I/O-Pin  3,  J602  auf  Motherboard 

I 70-Port  1  (101) 

$148 

2 

naskiert 

XDMAIRQ  von  SCC— DMA-Con trol I er 

I 70— Port  2  (102) 

S14C 

3 

naskiert 

XBR IRQ  von  Rl-Anschlu0,  MODEM  2 

I/O-Port  3  (103) 

$150 

4 

naskiert 

Baudrate  fur  SERIAL  1-Port 

Tiner  D 

$154 

5 

naskiert 

TCCLK-T akt  an  SCC,  Channel  2 

Tiner  C 

5158 

6 

naskiert 

DCH  (Drive  ready)  v.  int.  Floppy 

I/O— Port  4  ( I 04) 

515C 

7 

naskiert 

XSDMAIRQ  von  SCSI-DMA-Control ter 

I/Q-Port  5  (105) 

51GB 

8 

naskiert 

Di so  I  a y-E nab le- Signal 

Tirier  B 

5164 

9 

akti v. 

Sendefehler  ser .  Port  des  TT-MFP 

XM1 T-Error 

51G8 

IB 

akt i u . 

Sendepuffer  leer  t  "  ) 

XMIT-Buf.  enpty 

516C 

11 

aktiy . 

Enpf  angsf  ehler  (  ) 

RCU-Err-or 

5170 

12 

akt  i  v 

Enpf angspuf f .  uoll  C  "  ) 

RCU-Buffer  full 

5174 

13 

naskiert 

Hicht  benutzt 

T iner  A 

5178 

14 

naskiert 

Interrupt  von  TT-Uhrenchip 

I/O— Port  G  (106) 

517C 

15 

naskiert 

Interrupt  von  SCSI-Chip  "5380" 

I/O— Port  7  (1073 

Abb.  5.2:  Die  Lage  der  TT-MFP-Interruptvektoren  im  RAM 


Die  Interrupt-Steuerregister  des  TT-MFP 

Die  vier  Register  des  TT-MFP,  die  zur  Steuerung  der  Interruptbehandlung  durch  den  MFP 
verwendet  werden,  sind  natiirlich  vollkommen  identisch  zu  denen  des  bereits  vom  ST  her 
bekannten  MFP.  Lediglich  die  Interruptquellen  sind  bei  den  I/O-Ports  andere  Signale  aus  dem 
“Inneren”  des  TT.  Da  die  Signalbelegung  ja  sowohl  aus  dem  Schaltungsauszug  als  auch  der 
Tabelle  mit  den  Interruptvektoren  hervorgeht,  soil  hier  nur  noch  kurz  auf  diese  MFP-Register 
eingegangen  werden.  Die  Wirkungsweise  der  Bits  dieser  einzelnen  Register  kann  (sinnge- 
maB)  in  ausfiihrlicher  Form  im  Kapitel  iiber  den  ST-MFP  bei  der  ST-Hardware  nachgelesen 
werden. 

Adresse  Modus  Belegung  Funktion  Label 

$FF  FA87  R/W  eeeEEEEe  Interrupt-Enable-Reg.  A  (‘IERA-TT’) 

^ —  Timer  B  (Display  enable  Signal) 

- XMIT  Error  (RS  232) 

- XMIT  Buffer  empty  (RS  232) 

- RCV  Error  (RS  232) 

- RCV  Buffer  full  (RS  232) 

- Timer  A  (nicht  benutzt) 

- Port  16  (TT-Uhrenchip-IRQ-AnschluB) 

- Port  17  (IRQ  von  SCSI-Contr.-Chip) 
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Adresse  Modus  Belegung  Funktion 

$FF  FA89  R/W  eeEeeeee  Interrupt-Enable-Reg.  B  (‘IERBTT’) 

Port  10  (Pin  1  des  J602-Steckers) 

Port  II  (Pin  3  des  J602-Steckers) 

Port  12  (IRQ  von  SCC-DMA-Baustein) 

Port  13  (Ring  indicator  von  MODEM  2) 

Timer  D  (Baudraten-Gen.  SERIAL  1) 

Timer  C  (TCCLK  an  SCC-Channei  2) 

Port  14  (DCH-Signal  v.  P.34  int.  Floppy) 

Port  15  (IRQ  von  SCSI-DMA-Baustein) 

SFFFA8B  R/W  PPPPPPPP  Int.-Pending-Register  A  (TPRATT’) 

(Bitbelegung  siehe  ‘IERA_TT’) 

$FF  FA8D  R/W  PPPPPPPP  Int.-Pending-Register  B  (‘IPRBTT’) 

(Bitbelegung  siehe  TERB_TT’) 

$FF  FA8F  R/W  SSSSSSSS  Int.-In-Service-Register  A  (‘ISRA_TT’) 

(Bitbelegung  siehe  ‘IERA_TT’) 

$FF  FA91  R/W  SSSSSSSS  Int.-In-Service-Register  B  (‘ISRBTT’) 

(Bitbelegung  siehe  TERB_TT’) 

$FF  FA93  R/W  irtmmMMMMm  Interrupt-Mask-Register  A  (‘IMRATT’) 

(Bitbelegung  siehe  ‘IERA_TT’) 

$FF  FA95  R/W  mmnrnimmmm  Interrupt-Mask-Register  B  (‘IMRBJTT’) 

(Bitbelegung  siehe  ‘EERB_TT’) 

$FF  FA97  R/W  WWS— -  Interrupt- Vektor-Register  (‘VR_TT’) 

I -  End-of-Interrupt  Modus 

- -  High-Nibble  der  Vektomummer  (=5) 


Anmerkung:  Die  vom  TOS  vorgenommenen  Standardeinstellungen  in  den  Interrupt-Enable- 
und  Interrupt-Mask-Registem  sind  durch  Klein-  bzw.  GroBbuchstaben  bei  der 
jeweiligen  Bitposition  angegeben.  Ein  GroBbuchstabe  reprasentiert  dabei  ein 
gesetztes  Bit! 


Label 
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Dieser  Zusammenfassung  kann  man  also  entnehmen,  dafi  nur  die  Interrupts  fiir  die  serielle 
Schnittstelle  des  TT -MFP  und  den  Timer-C  “enabled”  sind.  Aufierdem  sind  im  Mask-Register 
alle  Interrupts  bis  auf  die  der  seriellen  Schnittstelle  ausmaskiert.  Ahnlich  ist  es  bei  den  zugeho- 
rigen  Interrupt-Service-Routinen.  Nur  die  als  “Enabled”  eingestellten  Interrupts  haben  auch 
einen  sinnvollen  Interruptvektor. 

Auch  der  TT-MFP  wird  im  Software-End-of -Interrupt-Modus  betrieben.  Das  hciftt,  daB  die 
zugehorige  Interrupt-Service-Routine  nach  Abarbeitung  das  entsprechende  Interrupt-In-Ser¬ 
vice-Bit  zuriicksetzen  mu6! 


Die  Steuerregister  fiir  die  serielle  Schnittstelle 
des  TT-MFP 


Die  Funktion  der  Register  fiir  die  serielle  Schnittstelle  SERIAL  1 ,  die  mit  dem  TT-MFP 
realisiert  wird,  ist  schon  beim  ST-MFP  erlautert  worden. 

Deshalb  hier  nur  eine  kurze  Registeriibersicht  mit  den  entsprechenden  Adressen: 

Adresse  Modus  Belegung  Funktion  Label 


$FF  FAA7  R/W  SSSSSSSS  Sync.-Char.  Register  (‘SCR  TT’) 

$FF  FAA9  R/W  CCCCCCC-  IJSART-ControI-Register  (‘UCR  TT’) 

^ - l=Even-,  0=Odd-Parity 

- Parity  Enable 


I  1 

Start  Stop 

Modus 

00  - 

—  0 

0 

Synchron 

01  - 

—  1 

1 

Asynchron 

10  — 

—  1 

1,5 

Asynchron 

11  - 

—  1 

2 

Asynchron 

Wortldnge 

in  Bits 

00 

— 

8 

01 

— 

7 

10  - — 

— 

6 

11 - 

— 

5 

Clock  Mode  (l=Clk/16, 0-Clk) 


Und  weil’s  so  schon  war  -  Noch’n  MFP  im  TT 
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Adresse  Modus  Belegung  Funktion  Label 

$FF  FAAB  R/W  SSSSSSSS  Receiver-Status-Register  (‘RSR_TF) 

Receiver  Enable 
^  Synchronous  Strip  Enable 

Match  bzw.  Character  in  progress 
Found/Search  bzw.  Break 

-  Frame  Error 

-  Parity  Error 

-  Overrun  Error 

- - —  Buffer  Full 


$FF  FAAD  R/W  SSSSSSSS  Transmitter-Status-Register  (4TSR_TF) 

—  Transmitter  Enable 

Sender-Ausgangsleitung 
00  —  Hocbohmig 
01  —  Low-Pegel 

10  ~  High-Pegel 

11  —  Schleife 

- —  Break  senden 

-  Senden  beendet 

L - -  Auto  Turnaround 

— -  Underrun  Error 

-  Sendepuffer  Leer 

Adresse  Modus  Belegung  Funktion  Label 

$FF  FAAF  R/W  DDDDDDDD  USART-Data-Register  (‘UDRTT’) 

(Lesen  holt  Byte  aus  Empfangspuffer) 
(Schreiben  bringt  Byte  in  Sendepuffer) 


Alle  AdreBangaben  zu  MFP-TT-Registem  sind  fur  den  ST  -  AdreBraum  gemacht.  Die  gleichen 
Register  sindauchimoberenTT-AdreBraumunter$FFFF  FA8X  ..  $FFFF  FAFFerreichbar! 
Soviel  zu  den  MFPs  im  TT! 


Kapitel  6:  Ein  Schritt  in  die  richtige 
Richtung  -  Der  TT-SCSI-Port 
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Schon  bei  der  ST(E)-Serie  hat  sich  ATARI  um  eine  Schnittstelle  fiir  schnelle  Peripheriegerate 
(Festplatten,  Laserdrucker)  eigene  Gedanken  gemacht.  Herausgekommen  ist  dann  dabei  eine 
zu  nichts  (auBer  manchmal  zu  sich  selbst)  kompatible  Schnittstelle,  der  ACSI-Bus.  Dieser 
ahnelt  in  Ansatzen  dem  bei  Kleincomputersystemen  schon  weit  verbeiteten  SCSI-Bus  (Small 
Computer  Systems  /nterface). 

Beim  TT  hat  man  (=  ATARI)  sich  dann  wohl  iiberlegt,  daB  man  diese  Performance-Bremse 
fiir  Festplatten,  den  Plattencontroller  bzw.  beim  AnschluB  von  SCSI-Platten,  den  als  Interface 
erforderlichen  Host-Adapter,  besser  weglassen  sollte.  SchlieBlich  soil  der  TT  ja  auch  mal  ein 
“grofies”  Betriebssystem  (UNIX)  unterstiitzen,  und  dazu  sind  schnelle  Massenspeichernatiir- 
lich  eine  sehr  wichtige  Voraussetzung!  Also  findet  sich  im  TT  nun  auch  ein  sehr  bekannter 
SCSTController-Chip(der5380),dervoneinemeigenenDMA-ControllerbeimDatentransfer 
unterstiitzt  wird.  Bevor  hier  auf  die  Interna  (sprich:  Register,  deren  Adressen  und  die  Funktio- 
nen)  des  SCSI-und  des  DMA-Controllers  eingegangen  wird,  erst  mal  ein  Uberblick  iiber  den 
SCSI-Bus. 


Der  SCSI-Bus 

Es  handelt  sich  hierbei  um  einen  bidirektionalen  8-Bit-Bus,  an  dem  bis  zu  acht  Teilnehmer 
angeschlossen  sein  konnen.  Von  der  SCSI-Bus-Spezifikation  her  sind  diese  Teilnehmer  mit 
“Intelligenz”  ausgestattet  und  konnen  sowohl  Computer  als  auch  Controller  zur  S  teuerung  von 
Peripheriegeraten  sein.  Dabei  konnen  durchaus  auch  mehrere  Computer  am  SCSI-Bus  “han- 
gen”.  Ein  Peripherie-Controller  kann  seinerseits  nochmal  bis  zu  acht  Gerate  bedienen  (bei 
SCSI-Befehlen  werden  diese  “Untergerate”  als  “Logical  Units”  behandelt)! 

V ora  Prinzip  her  kann  jeder  Busteilnehmer  als  Initiator  Oder  als  Target  arbeiten.  Die  Funktion 
ist  dabei  die  gleiche,  wie  schon  beim  ACSI-Bus  beschrieben.  Ein  Initiator  fordert  von  einem 
anderen  Teilnehmer  (dem  Target)  eine  Reaktion  an  (in  der  Regel  einen  Datenaustausch).  In 
der  Praxis  findet  man  jedoch  Computer  mit  Host-  Adaptern  als  Initiatoren  und  periphere  Gerate 
wie  Festplatten,  Laserdrucker,  CD-ROMs  usw.  als  Targets. 


Damit  es  kein  Durcheinander  auf  dem  alle  verbindenden  Bus  gibt,  diirfen  zur  gleichen  Zeit 
immernureinlnitiatorundeinTargetmiteinanderkommunizieren.  Derlnformationsaustausch 
erfolgt  asynchron  mittels  eines  Request/Acknowledge-Protokolls.  Es  wird  immer  je  ein  Byte 
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iibertragen  und  mittels  des  Handshakes  bestatigt.  (Es  existiert  allerdings  eine  Option  fiir  syn- 
chrone  Transfers,  die  auch  von  einigen  SCSI-Festplatten  inzwischen  unterstlitzt  werden.) 
AufSerdem  haben  alle  angeschlossenen  Busdevices  eine  eigene  Prioritat,  welche  liber  ein  eige- 
nes  Bit  dargestellt  wird.  In  einer  sogenannten  Arbitrations-Phase  (Entscheidungsphase)  pra- 
sentieren  alle  “Mitbewerber”  um  die  Buszuteilung  ihr  Prioritatsbit  (wegen  der  8-Bit-Busbreite 
kann  es  also  nur  acht  Gerate  geben,  die  sich  um  die  Buskontrolle  streiten!).  Das  Device  mit 
der  hochsten  Prioritat  “gewinnt”  den  Bus  und  kann  seinerseits  nun  mit  einem  anderen  Device 
in  Verbindung  treten. 


Die  Busverbindung 

Verwendet  wird  zur  Verbindung  der  einzelnen  Bus-Teilnehmer  (meistens)  ein  50poliges 
Flachbandkabel  mit  entsprechendem  Pfostenstecker.  Jeweils  gegeniiberliegende  Pins  der 
Steckverbinder  bilden  dabei  ein  Parchen  (und  damit  auch  die  daran  angeschlossenen  Leitun- 
gen).  Bis  auf  eine  Ausnahme  ist  je  eine  Leitung  eines  solchen  Adempaares  bei  der  “single- 
ended-drivers”-Version  als  Masseleitung  ausgefuhrt  und  dient  somit  als  abschinnendes  Ele¬ 
ment  fur  die  signalfuhrende  Leitung. 

Bis  zu  Leitungslangen  von  6  m  sieht  der  SCSI-Standard  diese  Ausfiihrung  als  sogenannte 
“single-ended-drivers”-Version  (eine  Leitung  liegt  mit  “einem  Ende”  fest  auf  Masse).  Die 
“differential-dri  vers”- Ausfiihrung  kommt  mit  ebenfalls  50  Leitungen  aus,  jedoch  werden  zu- 
sammengehorige  Adempaare  mit  speziellen  Differential-Treiberstufen  angesteuert,  um  die 
Storsicherheit  heraufzusetzen  und  langere  Entfemungen  (bis  zu  25  m)  zu  iiberbriicken. 

Damit  nicht  der  Eindruck  entsteht.  Atari  mangele  es  an  eigenen  Ideen  fiir  Steckverbindem, 
hat  man  am  TT  den  herausgefiihrten  SCSI-PortanschluB  auf  einer  “normalen”  25poligen  Sub- 
D-Buchse  enden  lassen  (das  spart  jede  Masse  Masse!).  Dabei  weist  diese  Belegung  eine  “ver- 
bliiffende  Ahnlichkeit”  (sprich:  Ubereinstimmung)  mit  dem  SCSI-Port  bei  MACINTOSH- 
Rechnem  auf! 


Das  Ende  der  Busverbindung 

An  den  beiden  auBeren  Enden  einer  Busverbindung  wird  der  Bus  durch  Widerstandsnetzwerke 
abgeschlossen.  Bei  der  (am  haufigsten  verwendeten)  Single-ended-Driver-Version  wird  jede 
Signalleitung  mit 3 30  Q  gegen  Masse  und  220  £2  an  +5  V  abgeschlossen.  Dafur  verwendet  man 
in  der  Regel  Widerstandsnetzwerke  in  Steckfassungen,  um  bei  Bedarf  (wenn  das  Gerat  z.  B. 
nicht  am  Ende  des  Busses  “hangt”)  die  Terminierung  entfemen  zu  konnen.  Optional  existiert 
fiir  diese  Busterminierung  eine  eigene  Terminator-Power-Leitung  (kurz:  Termpwr).  Damit  ist 
es  moglich,  alle  AbschluBnetzwerke  aus  einer  Quelle  (+5V)  zu  speisen,  unabhangig  davon, 
ob  die  am  Bus  angeschlossenen  Gerate  eingeschaltet  sind! 


Ein  Schritt  in  die  richtige  Richtung  -  Der  TT-SCSI-Port 
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Die  Signale  auf  dem  SCSI-Bus 

Alle  Signale  auf  dem  Bus  sind  Low-aktiv !  Die  Belegung  des  SCSI-Bus- Anschlusses  zeigt  die 
Abbildung  6.1.  Als  Signalpegel  werden  TTL-Pegel  verwendet. 


St  eckuer  binder 
an  SCSI-Bus 


5a  'I* 


Belegung 

Pin- Hr . : 

Belegung 

Data  0 

2 

1 

Masse 

Data  1 

4 

3 

Masse 

Bata  2 

6 

5 

Masse 

Data  3 

8 

7 

Basse 

Data  4 

ie 

9 

Masse 

Data  5 

12 

11 

Masse 

Data  6 

14 

13 

Masse 

Data  7 

ie 

15 

Masse 

Parity 

10 

17 

Basse 

— 

20 

19 

Masse 

22 

21 

Masse 

24 

23 

Masse 

(Terrtpur) 

26 

25 

N.C. 

— 

28 

27 

Masse 

— 

30 

29 

Masse 

HTH 

32 

31 

Basse 

— 

3-1 

33 

Basse 

BSV 

36 

36 

Masse 

fo 

38 

37 

Masse 

Reset 

48 

39 

Masse 

nsu 

42 

41 

Basse 

SEE 

43 

43 

Basse 

C/O 

46 

45 

Masse 

BED 

48 

47 

nasse 

I/O 

59 

49 

Masse 

fluflenansicht  auf  die 
SCSI“Buchse  des  TT 


1  -  Htfi 

2  -  MSG 

3  -  17d 

4  -  RKET 

5  -  BCK 

6  -  BSY 

7  -  Basse 

8  -  Data  9 

9  -  Basse 

10  -  Oalal 

11  -  Data  5 

12  -  Data  6 

13  -  Data  7 


14  -  Masse 

15  -  CTO 

16  -  Masse 

17  -  HTR 
IB  -  Basse 

19  -  SEC 
28  -  Parity 

21  -  Data  1 

22  -  Data  2 

23  -  bata  9 

24  -  Basse 

25  -  N.C. 


Abb.  6.1:  Die  Belegung  beim  SCSI-Bus 


Ein  Low  an  einem  Ausgangsanschlufi  soil  zwischen  0..0,4V  liegen.  Dabei  mufi  ein  Ausgang 
bei  Low-Signal  einen  Strom  von  48mA  “verkraften”  konnen! 

An  einem  Buseingang  werden  Spannungspegel  bis  0,8  V  noch  als  Low  “angesehen”.  Die  Last, 
mit  der  ein  Eingang  den  Bus  bei  Low  belastet,  soil  0,4mA  nicht  iiberschreiten. 

High-Signale  liegen  zwischen  2,5V  und  5,25V  an  Ausgangsanschlussen.  Bei  Eingangen  wer¬ 
den  Signale  zwischen  2V  und  5,25  V  als  High  angesehen. 

Eine  Speisung  fiir  die  Termpwr-Leitung  soil  bei  einer  Spannung  zwischen  4V..5.25V  einen 
Strom  von  800mA  liefem  konnen. 
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Verwendete  Leitungen 

Da  im  Prinzip  alle  Gerate  sowohl  auf  den  Bus  ausgeben  als  auch  von  dort  Daten  aufnehmen 
konnen,  empfiehlt  sich  fur  Ausgange  das  Open-Collector-Prinzip. 

Reset  (_RST)  Pin  40  TTPin4  Bidirektional! 

Wenn  dieses  Signal  gesetzt  wird  (auf  Low  geht),  werden  die  laufenden  Busaktivitaten  beendet. 
Alle  Teilnehmer  werden  in  den  Grundzustand  zuruckversetzt. 

Jeder  Teilnehmer  kann  Reset  auslosen.  Die  sogenannte  “Reset  hold  time”  (die  Zeit,  fiir  die  die 
_RST-Leitung  mind.  Low  sein  muB)  betragt  25ms. 

Busy  (JBSY)  Pin  36  TTPin6  Bidirektional! 

Der  Bus  ist  schon  abgefahren!  Hiermit  wird  signalisiert,  dafi  der  Bus  zur  Zeit  beiegt  ist.  Auch 
wahrend  der  Arbitration  (Entscheidung,  wer  den  Bus  bekommt)  geht  Busy  auf  Low! 

Select  (_SEL)  Pin  44  TT  Pin  19  Initiator  ->  Target 

Bei  Reselect:  Target  ->  Initiator 

Der  Initiator  signalisiert  damit  den  Targets,  doch  bitte  mal  nachzusehen,  ob  sich  nicht  viel- 
leicht  jemand  durch  die  ebenfalls  vom  Initiator  auf  dem  Datenbus  ausgegebene  Adresse  (ID- 
Bit)  angesprochen  fiihlen  konnte  (Targetauswahl).  Ein  Target  benutzt  dieses  Signal,  um  sich 
in  der  Reselect-Phase  wieder  bei  seinem  Initiator  zu  melden  (zum  Beispiel  eine  Harddisk,  die 
mit  dem  Formatieren  fertig  und  nun  bereit  zu  neuen  Taten  ist.) 

Attention  (_ATN)  Pin  32  TT  Pin  17  Initiator  ->  Target 

Achtung!  Der  Initiator  hat  eine  Message  (Nachricht)  fiir  das  Target.  Da  allerdings  das  Target 
bei  Command-,  Data-,  Status-  und  Message-Transfers  das  “Heft  in  der  Hand  halt",  also  den 
Bus  steuert,  fordert  der  Initiator  mit  diesem  Signal  eine  “Message  out”-Phase  beim  Target  an. 

Message  (_MSG)  Pin  42  TT  Pin  2  Target  ->  Initiator 

Das  Target  signalisiert  damit  den  Transfer  einer  Mitteilung  (die  Message-Richtung  wird  eben¬ 
falls  vom  Target  bestimmt!) 

Control/Data  (_C/D)  Pin  46  TTPin  15  Target ->  Initiator 

Das  Target  bestimmt  hiermit,  ob  es  sich  bei  den  Signalen  auf  dem  Datenbus  um  Befehle, 
Statusinformationen  oder  Messages  (Control-Informations)  handelt  (Low-Signal). 


Ein  Schritt  in  die  richtige  Richtung  -  Der  TT-SCSI-Port 
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Wahrend  der  eigentlichen  Dateniibertragungsphase  (Data-Phase)  liegt  dann  hier  ein  High- 
Signal. 


In-/Output  (Jt/O)  Pin  50  TT  Pin  3  Target  ->  Initiator 

Das  Target  gibt  hieriiber  die  Transportrichtung  auf  dem  Datenbus  bekannt  (High:  Initiator  - 
>  Target;  Low:  Target  ->  Initiator). 


Request  (_REQ)  Pin  48  TT  Pin  1  Target  ->  Initiator 

Fiir  den  Handshake  wahrend  des  Informationsaustauschs  iiber  den  Datenbus  fordert  das  T arget 
mit  diesem  Signal  den  Initiator  auf,  ein  Datenbyte  auf  den  Bus  zu  legen  (Initiator  ->  Target) 
oder  daB  das  Target  ein  Byte  auf  den  Bus  gelegt  hat  (T arget  ->  Initiator).  Die  Transferrichtung 
wird  ja  durch  das  _I/0~Signal  bestimmt! 


Acknwldg.  (_ACK)  Pin  38  TT  Pin  5  Initiator  ->  Target 

Das  Gegenstiick  zum  „.REQ-Signal,  Hiermit  bestatigt  der  Initiator,  daB  er  das  angeforderte 
Datenbyte  auf  den  Datenbus  gelegt  (Initiator  an  Target)  oder  daB  er  das  vom  Target  auf  den 
Bus  gelegte  Byte  eingelesen  hat  (Target  an  Initiator)! 

Datenbus  (DB7..0)  Pin  16,  14, 12,  10,  8,  6, 4,  2 

TT  Pin  13,  12,  11,  23,  10,  22,  21,  8  Bidirektional 

Hieriiber  werden  die  Daten  byteweise  zwischen  Target  und  Initiator  verschoben.  Die 
erreichbare  Geschwindigkeit  liegt  laut  “SCSI-Norm”  bei  max.  4  MByte/s. 

Paritat  (DP)  Pin  18  TTPin20  Bidirektional 

Zusatzlich  kann  die  Byteubertragung  auf  dem  Bus  mit  einem  ungeraden  Paritatsbit  gesichert 
werden.  Wenn  mit  Paritat  gearbeitet  wird,  mtissen  auch  alle  angeschlossenen  Devices  diese 
Option  verwenden.  Beim  TT  wird  diese  Option  z.  Zt.  nicht  verwendet! 


Die  Bus-Phasen 

Der  Bus  kann  sich  immer  nur  in  einer  von  vier  Hauptphasen  befinden.  Dabei  werden  diese 
Hauptphasen  zum  Teil  noch  in  weitere  Unterphasen  unterschieden. 


Alle  Phasen  werden  durch bestimmte  Zustande  der  Signale  Busy,  Message,  Select,  Input/Out¬ 
put,  Control/Data,  Request  und  Acknowledge  definiert. 
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BUS  FREE 

Diese  Phase  ist  dadurch  charakterisiert,  dafi  zur  Zeit  kern  Gerat  den  Bus  benutzt.  Alle  Bus- 
signale  sind  inaktiv.  Erkennen  kann  man  diese  Phase  daran,  daB  Busy  und  Select  deaktiviert 
(=  High)  sind! 

Die  angeschlossenen  Gerate  sollen  alle  Signale  innerhalb  des  “Bus  Clear  Delay”  (max.  800ns) 
deaktivieren,  wenn  nach  Ablauf  eines  “Bus  Settle  Delay”  (max.  400ns)  Busy  und  Select  auf 
High  gegangen  sind. 


ARBITRATION 

Diese  zweite  Hauptphase  ist  nur  dann  anzutreffen,  wenn  ein  System  mit  mehr  als  einem 
Initiator  betrieben  wird.  Dann  mu6  namlich  entschieden  (to  arbitrate  =  entscheiden)  werden, 
welcher  Initiator  die  Buskontrolle  bekommt.  Da  die  meisten  Anwendungen  beim  TT  z.  Zt. 
noch  der  Betrieb  von  SCSI-Platten  sind  und  der  TT  der  einzige  Initiator  im  System  ist,  hat  man 
die  Arbitration-Phase  bei  der  zugehorigen  Treibersoftware  noch  nicht  implementiert.  Der 
SCSI-Controller-Chip  im  TT  ist  dazu  jedoeh  fahig! 

Wie  bekommt  nun  ein  Initiator  die  Kontrolle  iiber  den  Bus? 

Warten,  bis  der  Bus  frei  ist.  Dazu  miissen  Busy  und  Select  mindestens  fur  die  Dauer  des 
Bus  Settle  Delay  (400ns)  deaktiviert  sein.  Danach  ist  fur  nochmal  800ns  (“Bus  Free 
Delay”)  zu  warten,  bevor  ein  Device  irgendein  Signal  setzen  soli. 

-  Der  Initiator  setzt  Busy  und  aktiviert  sein  eigenes  ID-Bit  auf  dem  Datenbus  (zieht  die 
entsprechende  Datenbusleitung  auf  Low!). 

-  Nach  Ablauf  des  “Arbitration  Delay”  (2,2|lis)  “untersucht”  der  Initiator  den  Datenbus  auf 
hdher  priorisierte  Initiatoren  (DB0  ist  niedrigste,  DB7  hochste  Prioritatsstufe).  Wenn 
kein  hoher  priorisiertes  Gerat  gefunden  wurde,  setzt  der  “Gewinner”  die  Select-Leitung 
auf  Low. 

-  Niedriger  priorisierte  Gerate  haben  ihr  Busy-Signal  und  ihr  ID-Bit  innerhalb  eines  Bus 
Settle  Delay  (400ns)  “vom  Bus  zu  nehmen”,  nachdem  Select  vom  “Gewinner”  aktiviert 
wurde. 

Bevor  der  “Gewinner”  nach  Setzen  von  Select  weitere  Signale  auf  den  Bus  legen  darf  (Eintritt 
in  die  folgende  Selektions-Phase),  hat  er  mindestens  400ns  (Bus  Settle  Delay)  plus  800ns  (Bus 
Clear  Delay)  abzuwarten. 
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SELECTION 

Die  dritte  Hauptphase  wird  vom  Initiator,  der  die  Buskontrolle  iibernommen  hat,  verwendet, 
um  das  gewiinschte  Target  zu  adressieren. 

Um  diese  Phase  von  der  RESELECTION-Phase  (Wiedcraufnahme  einer  Verbindung  zwi- 
schen  einem  Target  und  “seinem”  Initiator)  zu  unterscheiden,  muB  _I/0  aktiviert  sein! 

Der  Initiator  legt  nun  sein  eigenes  ID-Bit  und  das  des  Targets,  mit  dem  zusammengearbeitet 
werden  soil,  auf  den  Datenbus.  Nach  2  x  45ns  (2  x  Deskew  Delay)  aktiviert  der  Initiator  das 
Busy-Signal.  Weitere  400ns  (Bus  Settle  Delay)  spater  darf  der  Initiator  dann  mal  schauen,  ob 
denn  ein  Target  reagiert  hat. 

Das  adressierte  Target  hat  innerhalb  der  sogenannten  “Selection  Abort  Time”  (=200ns)  zu 
reagieren,  indent  es  nun  seinerseits  das  Busy-Signal  auf  Low  zieht. 

Innerhalb  zwei  Deskew  Delays  (2  x  45ns)  nachdem  der  Initiator  die  Aktivierung  von  Busy 
durch  das  Target  erkannt  hat,  wird  vom  Initiator  die  Select-Leitung  deaktiviert. 

Wenn  innerhalb  von  ca.  250ms  nach  Ausgabe  der  Targetadresse  vom  Initiator  keine  Reaktion 
vom  Target  kommt,  wird  eine  Timeout-Prozedur  eingeleitet.  Dabei  kann  der  Initiator  dann 
z.  B.  ein  Reset  durch  Setzen  der  _RST~Leitung  starten.  Die  andere  Moglichkeit  besteht  darin, 
nach  Deaktivieren  von  Select  wieder  in  die  BUS  FREE-Phase  einzutreten. 


RESELECTION 

Bei  dieser  Phase  geht  die  Initiative  zur  Herstellung  einer  Verbindung  nicht  vom  Initiator, 
sondern  vom  Target  aus.  Diese  Phase  ist  nur  in  Systemen  mit  ARBITRATION  moglich. 

Dabei  tauschen  Target  und  Initiator  eigentlich  ihre  Rollen.  Das  Target  versucht  wahrend  der 
ARBITRATION,  den  Bus  zu  iibemehmen,  und  verfahrt  dabei  genau  wie  dort  bereits  beschrie- 
ben.  Wenn  die  Busiibemahme  geklappthat,  wird  das  Target  die  Select-Leitung  aktivieren  und, 
als  Unterscheidung  zur  SELECTION,  die  RESELECTION  durch  Aktivierung  von  „I/0 
kenntlich  machen.  AuBerdem  gibt  das  Target  dann  das  eigene  ID-Bit  und  das  des  gewiinschten 
Initiators  auf  den  Bus. 

Zwei  Deskew  Delays  (2  x  45ns)  spater  deaktiviert  das  Target  Busy  und  priift  nach  weiteren 
400ns  (Bus  Settle  delay)  erstmalig  den  Bus  auf  eine  Reaktion  vom  Initiator.  Wenn  der  Initiator 
sich  innerhalb  von  ca  250ms  (^Selection  Abort  Time)  meldet  (=Busy  aktiviert),  ubemimmt 
das  Target  selbst  ebenfalls  wieder  mit  Aktivierung  von  JBSY  den  Bus.  Weitere  2  x  45ns  (2 
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Deskew  Delays)  spSter  wird  vom  Target  Select  deaktiviert.  Danach  steht  wieder  die 
Verbindung  zwischen  dem  Initiator  und  dem  Target,  und  das  Target  kann  das  Input/Output- 
Signal  abschalten. 

Auch  hierbei  gibt  es  bei  Uberschreiten  der  Selection  Abort  Time  (250ms)  (wie  bei  der  SE- 
LECTION-Phase)  die  Moglichkciteines  Bus  Reset  (allerdings  diesmal  vom  Target  veranlaBt) 
Oder  des  Ubergangs  in  die  BUS  FREE-Phase, 


Systeme  ohne  ARBITRATION 

In  Systemen  ohne  ARBITRATION/RESELECTION  und  mit  nur  einem  Initiator  (“Single 
Initiator  Systems”,  wie  im  Moment  auch  beim  TT)  steigt  der  Initiator  nach  der  BUS  FREE- 
Phase  direkt  in  die  SELECTION-Phase  ein! 

Nach  Feststellen  von  BUS  FREE  und  Ablauf  von  800ns  (Bus  Clear  Delay)  wird  vom  Initiator 
deshalb  nur  die  gewiinschte  Target-SCSI-Adresse  auf  den  Bus  gesetzt  und  _SEL  aktiviert. 
Wenn  ein  Target  nur  seine  ID  auf  dem  Bus  findet  und  keine  weitere  (die  des  Initiators),  geht 
es  von  einem  “dummen”  Initiator  aus,  der  mit  Meldungen  nichts  anfangen  kann. 


Wenn  die  Verbindung  steht  -  Die  Transferphase 

Die  vorher  beschriebenen  Phasen  sind  ja  nur  notig,  um  die  Verbindung  zwischen  zwei  SCSI- 
Devices  iiber  den  Bus  herzustellen.  Wenn  das  erfolgreich  gelungen  ist,  konnen  Befehle 
(COMMAND-Phase),  Daten  (DATA  IN/OUT-Phase),  Meldungen  (MESSAGE-Phase)  oder 
Zustandsinformationen  (STATUS-Phase)  ausgetauscht  werden.  Die  komplette  Steuemng  des 
Austauschs  liegt  dabei  jedoch  beim  Target!  Dazu  verwendet  es  die  Signale  _C/D,  _I/0  und 
_MSG.  Folgende  Phasen  konnen  durch  diese  drei  Signale  unterschieden  werden: 


MSG 

C/D 

I/O 

Phase 

Transferriehtung 

F 

F 

F 

DATA  OUT 

Initiator  an  Target 

F 

F 

T 

DATA  IN 

Target  an  Initiator 

F 

T 

F 

COMMAND 

Initiator  an  Target 

F 

T 

T 

STATUS 

Target  an  Initiator 

T 

F 

F 

Reserved 

T 

F 

T 

Reserved 

T 

T 

F 

MESSAGE  OUT 

Initiator  an  Target 

T 

T 

T 

MESSAGE  IN 

Target  an  Initiator 

F  =  False  (High!);  T  —  True  (Low!) 
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Der  Initiator  kann  lediglich  iiber  die  Aktivierung  von  _ATN  darauf  aufmerksam  machen,  daB 
er  eine  Meldung  abzusetzen  hat.  Das  Target  muB  darauf  dann  entsprechend  reagieren  und  in 
die  MESSAGE  OUT-Phase  wechseln! 

Datenaustausch  per  Handshake 

Die  Datenbytes  werden  per_REQ/_ACK-Handshake  im  Asynchronbetrieb  (Standardbetriebs- 
weise)  zwischen  den  beiden  Geraten  ausgetauscht.  Jedes  Byte  erfordert  einen  _REQ/_ACK- 
Zyklus.  Die  Transferrichtung  wird  durch  das  _I/0-Signal  festgelegt. 

Bei  einem  Transfer  vom  Target  zum  Initiator  (_J/0  =  Low!)  legt  das  Target  zunachst  das  zu 
iibertragende  Datenbyte  auf  den  Bus  (evtl.  mit  Paritatsbit  auf  der  Paritats-Leitung).  Ein 
Deskew  Delay  (45ns)  plus  ein  “Cable  Skew  Delay”  (10ns)  danach  wird  Request  aktiviert.  Der 
Initiator  liest  die  Daten  ein,  sobald  _REQ  aktiviert  wurde,  und  bestatigt  die  Ubemahme  der 
Daten  durch  Aktivierung  von  _ACK.  Sobald  das  Target  dieses  bemerkt,  kann  es  bereits  wieder 
Anderungen  auf  dem  Datenbus  vomehmen  (z.  B.  nachstes  Byte  anlegen)  und  _REQ  wieder 
deaktivieren.  Das  sollte  dann  der  Initiator  auch  schnellstens  mitkriegen  und  als  Reaktion 
darauf  dann  _ACK  ebenfalls  deaktivieren.  AnschlieBend  kann  das  Target  wieder  mit 
Aktivierung  von  _REQ  das  nachste  Datenbyte  ausgeben. 

Wenn  Daten  vom  Initiator  zumT or  get  iibertragen  werden  sollen  (_I/0 = High ! ),  gibt  das  T arget 
den  Wunsch  nach  einem  neuen  Datenbyte  durch  Aktivierung  von  _REQ  bekannt.  Der  Initiator 
setzt  die  Datenbusleitungen  auf  den  entsprechenden  Wert  und  gibt  nach  einem  Deskew  Delay 
(45ns)  plus  dem  Cable  Skew  Delay  (10ns)  die  Giiltigkeit  der  Daten  auf  dem  Bus  mit 
Aktivierung  von  _ACK  bekannt.  Sobald  das  Target  das  _ACK  bemerkt,  hat  es  die  Daten 
einzulesen  und  als  Quittung  das  Request-Signal  zuriickzunehmen.  Wenn  der  Initiator  dieses 
feststellt,  hat  er  seinerseits  _ACK  zu  deaktivieren  und  kann  anschlieBend  bereits  neue  Daten 
auf  den  Bus  legen.  Das  Target  holt  sich  diese  dann  mit  dem  nachsten  _REQ  wieder,  wie  bereits 
zuvor  geschildert,  ab. 

COMMAND-Phase 

Zunachst  einmal  sollte  das  Target  natiirlich  erfahren,  was  der  Initiator  denn  eigentlich  will. 
Die  Ubermittlung  der  dazu  erforderlichen  Informationen  geschieht  in  der  COMMAND-Phase 
(dabei  ist  dann  _C/D  aktiviert!).  Wahrend  dieser  Phase  sind  J/O  und  _MSG  deaktiviert.  Das 
T  arget  holt  sich  per  _REQ/_ACK  -Handshake  (wie  schon  zuvor  beschrieben)  den  sogenannten 
“Command  Deskriptor  Block”,  bestehend  aus  sechs,  zehn  oder  zwolf  Bytes,  beim  Initiator  ab. 

An  die  COMMAND-Phase  kann  sich  dann  eine  DATA  IN-  oder  DATA  OUT-Phase  anschlie- 
Ben,  wahrend  der  Daten  zwischen  Initiator  und  Target  ausgetauscht  werden  (z.  B.  bei  SCSI- 
Platten  am  TT  nahezu  immer  der  Fall!). 
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DATA-Phasen 

Ob  es  sich  um  eine  DATA  IN-  Oder  DATA  OUT-Phase  handelt,  wird  durch  den  Zustand  der 
_VO-Leitung  festgelegt  (Low  fur  DATA  IN).  Auch  hier  erfolgt  der  Datenaustausch  wieder 
Byte  filr  Byte  (evtl.  mit  Paritatsbit)  nach  dem  bereits  beschriebenen  _REQ/_ACK-Verfahren. 
Die  _MSG-  und  _C/D-Leitung  miissen  dabei  auf  High  gesetzt  sein! 

STATUS-Phase 

Ublicherweise  schlieBt  die  STATUS-Phase  eine  Initiator-Target-Kommunikation  ab.  Dabei 
wird  an  den  Initiator  ein  Statusbyte  iibermittelt  (also  ist  _I/0  =  Low!),  das  es  dem  Initiator 
erlaubt,  eine  Aussage  iiber  den  Zustand  der  beendeten  Operation  zu  treffen. 

Auch  diese  Ubermittlung  erfolgt  natiirlich  wieder  gemafi  dem  _REQ/_ACK-Protokoll.  Da  es 
sich  hierbei  auch  um  eine  Art  Kontroll-Information  handelt,  ist  wahrend  dieser  Phase  _C/D 
aktiviert.  _MSG  liegt  auf  High! 

Die  Bedeutung  des  Statusbytes  ist  nachfolgend  dargestellt; 


Status-Byte 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

Reserv. 

Herstellerspez. 

Status  Byte  Code 

Herst.spez. 

Hier  nun  die  mdglichen  Riickmeldungen  und  deren  Bedeutung  im  Statusbyte: 


Bits  im  Statusbyte 


7 

6 

5 

4 

3 

2 

1 

0 

Bedeutung 

R 

H 

H 

0 

0 

0 

0 

H 

GOOD 

R 

H 

H 

0 

0 

0 

1 

H 

CHECK  CONDITION 

R 

H 

H 

0 

0 

1 

0 

H 

CONDITION  MET/GOOD 

R 

H 

H 

0 

0 

1 

1 

H 

Reserviert 

R 

H 

H 

0 

1 

0 

0 

H 

BUSY 

R 

H 

H 

0 

1 

0 

1 

H 

Reserviert 

R 

H 

H 

0 

1 

1 

0 

H 

Reserviert 

R 

H 

H 

0 

1 

1 

1 

H 

Reserviert 
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7 

6 

5 

4 

3 

2 

1 

0 

Bedeutung 

R 

H 

H 

1 

0 

0 

0 

H 

INTERMEDIATE/GOOD 

R 

H 

H 

1 

0 

0 

1 

H 

Reserviert 

R 

H 

H 

1 

0 

1 

0 

H 

INTERMEDIATE/CONDmON 

MET/GOOD 

R 

H 

H 

1 

0 

1 

1 

H 

Reserviert 

R 

H 

H 

I 

1 

0 

0 

H 

RESERVATION  CONFLICT 

R 

H 

H 

1 

1 

0 

1 

H 

Reserviert 

R 

H 

H 

1 

1 

1 

0 

H 

Reserviert 

R 

H 

H 

1 

1 

1 

1 

H 

Reserviert 

GOOD  Wi  rd  zuriickgemeldet,  wenn  das  T  arget  ein  Kommando 

erfolgreich  abgeschlossen  hat. 


CHECK  CONDITION  Es  ist  bei  der  Kommandoausftihrung  irgendetwas  nicht 

so  gelaufen,  wie  vorgesehen.  Der  Initiator  sollte  sich 
ausfiihrlichere  Informationen  mit  einem  REQUEST 
SENSE-Kommando  vom  Target  iibermitteln  lassen. 

CONDITION  MET  Wird  nur  in  V erbindung  mit  den  Gruppe- 1  -Kommandos 

SEARCH ..  auftreten.  Wenn  so  eine  Suchoperation 
erfolgreich  beendet  wurde,  wird  dies  liber  diesen  Status 
mitgeteilt.  Eine  Liste  von  verketteten  Kommandos  wird 
durch  diese  Statusmeldungen  nicht  unterbrochen.  Die 
gesuchten  Daten  stehen  dann  in  der  Log.  Blockadresse, 
die  mit  REQUEST  SENSE  erfragt  werden  kann. 

BUSY  “Nicht  jetzt,  Liebling!”  Das  Target  ist  zur  Zeit  beschaf- 

tigt.  Dieser  Status  sollte  immer  geliefert  werden,  wenn 
zur  Zeit  kein  Kommando  vom  Initiator  aufgenommen 
werden  kann.  Der  Initiator  sollte  spater  wieder  einen 
neuen  Versuch  starten. 

INTERMEDIATE  In  verketteten  Kommandos  (Linked  Commands)  ist  bei 

erfolgreicher  Beendigung  eines  jeden  Teilkommandos 
(auBer  beim  letzten  Befehl!)  dieser  Status  zuriickzu- 
liefem.  Wenn  das  nicht  geschieht,  wird  die  Kette  unter¬ 
brochen  und  folgende,  verkettete  Kommandos  nicht 
mehr  ausgefuhrt. 
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RESERVATION  CONFLICT  Wenn  der  Initiator  ein  Gerat  am  Target  ansprechen  will, 

das  fiir  einen  anderen  Initiator  reserviert  wurde  (auch  das 
gibt’s  bei  SCSI!),  wird  diese  Statusinformation  geliefert. 


MESSAGE-Phasen 

Wahrend  der  MESSAGE-Phasen  konnen  zwischen  Target  und  Initiator  Meldungen  ausge- 
tauscht  werden.  Die  Informationsrichtung  wird  dabei  wieder  durch  den  Zustand  der  _I/0- 
Leitung  bestimmt  (Low  =  MESSAGE  IN). 

Das  Target  kann  jederzeit  in  die  MESSAGE  IN-Phase  umschalten,  indem  es  die  _MSG- 
Leitung  und  die  J/O-Leitung  aktiviert.  Der  Austausch  der  Message-Bytes  geschieht  wieder 
nach  dem  bereits  beschriebenen . REQ/_ACK-Protokoll . 

Der  Initiator  kann  selbst  nicht  in  die  MESSAGE  OUT-Phase  gelangen.  Alle  Kontrolle 
wahrend  der  Transferphasen  liegt  ja  beim  Target! 

So  muB  der  Initiator  dann  durch  Aktivierung  der  Attention-Leitung  (jederzeit  moglich,  auBer 
wahrend  BUS  FREE  und  ARBITRATION!)  dem  Target  signalisieren,  daB  er  Meldungen  filr 
das  Target  hat.  Das  T  arget  wird  dann  zum  nachstmoglichen  Zeitpunkt  in  die  MESSAGE  OUT- 
Phase  wechseln  (_MSG  und  _C/D  aktivieren,  _I/0  auf  High).  Datenaustausch  wieder  gemaB 
dem  _REQ/_ACK-Verfahren.  Es  werden  so  lange  Meldungen  vom  Initiator  angefordert,  bis 
dieser  _ATN  deaktiviert! 

Von  der  MESSAGE-Phase  kann  das  Target  wieder  zu  irgendeiner  der  Transferphasen 
wechseln  oder  in  die  BUS  FREE-Phase  gehen.  Alle  SCSI-Devices  sollen  zumindest  die 
Meldung  “COMMAND  COMPLETE”  beherrschen.  Diese  wird  vom  Target  zum  AbschluB 
einer  Operation  an  den  Initiator  gesendet  (nach  derSTATUS-Phase).  Der  Atari-Festplattentreiber 
(in  der  Version  4.02)  ignoriert  diese  Meldung  einfach  und  verlaBt  sich  nur  auf  das  wahrend 
der  STATUS-Phase  zuriickgegebene  Statusbyte. 

Entsprechend  der  SCSI-Norm  sollte  der  Initiator  sich  bereits  wahrend  der  SELECTION -Phase 
mit  aktiviertem  _ATN  beim  Target  vorstellen,  wenn  er  Wert  auf  einen  ausfiihrlichen  Mel- 
dungsaustausch  legt.  Dadurch  wird  das  Target  veranlaBt,  nach  erfolgreicher  SELECTION  in 
die  MESSAGE  OUT-Phase  zu  wechseln,  um  dem  Initiator  die  Moglichkeit  zu  geben,  sich  mit 
seinen  Moglichkeiten  (Identify-Message)  vorzustellen. 

Auf  die  Einzelheiten  zu  den  Meldungen  wahrend  der  MESSAGE-Phasen  soil  hier  aus  Platz- 
griinden  jedoch  nicht  weiter  eingegangen  werden. 

In  folgender  Tabelle  finden  Sie  die  wesentlichen  Messages  mit  ihrer  Kurzbezeichnung. 
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Message  Codes 


Code 

Kurzbezeichnung 

MSG-Phase 

00H 

COMMAND  COMPLETE 

In 

01H 

EXTENDED  MESSAGE 

In  Out 

02H 

SAVE  DATA  POINTER 

In 

03H 

RESTORE  POINTERS 

In 

04H 

DISCONNECT 

In 

05H 

INITIATOR  DETECTED  ERROR 

Out 

06H 

ABORT 

Out 

07H 

MESSAGE  REJECTIn 

Out 

08H 

NO  OPERATION 

Out 

09H 

MESSAGE  PARITY  ERROR 

Out 

OAH 

LINKED  COMMAND  COMPLETE 

In 

OBH 

LINKED  COMMAND  COMPLETE  (WITH  FLAG) 

In 

OCH 

BUS  DEVICE  RESET 

Out 

ODH ..  7FH 
80H ..  FFH 

Reserved  Codes 

IDENTIFY 

In  Out 

Wer  sich  dariiber  weiter  informieren  will  (oder  muB),  sollte  z.  B.  auf  die  SCSI-ANSI-Unter- 
lagen  X3T9.2,  Rev.  17B,  zuriickgreifen,  die  alle  notigen  Angaben  in  knapper  Form  auf  ca.  200 
Seiten  enthalten.  AuBerdem  lassen  sich  viele  Festplattenhersteller  in  ihren  Dokumentationen 
zu  SCSI-Platten  zum  Teil  recht  ausfiihrlich  iiber  den  SCSI-Standard  aus. 


Die  SCSI-Kommandos 

Alle  SCSI-Kommandos  gehen  davon  aus,  daB  SCSI-Gerate  Daten  in  Form  von  aufeinander 
folgenden  log.  Blocken  bereitstellen  bzw.  entgegennehmen  konnen.  Die  Ubersetzung  dieser 
log.  Blocke  in  physikalische  Strukturen  ist  Aufgabe  des  SCSI-Devices.  Bei  SCSI-Festplatten 
werden  also  solche  logischen  Blocknummem  vom  SCSI-Controller  der  Platte  in  entsprechen- 
de  Zylinder-,  Sektor-  und  Kopfnummem  umgesetzt. 

Mit  jedem  Kommando  konnen  ein  oder  mehrere  log.  Blocks  bearbeitet  werden.  Mehrere  Kom- 
mandos  konnen  hintereinander  gekettet  werden  (Linked  Commands),  ohne  vorher  iiber  BUS 
FREE,  ARBITRATION  und  SELECTION  gehen  zu  miissen. 

Nach  Beendigung  eines  Kommandos  liefert  das  Target  ein  Statusbyte  (wahrend  der  STATUS- 
Phase!)  an  den  Initiator.  Da  in  einem  Byte  nicht  besonders  viele  Statusinformationen  unterge- 
bracht  werden  konnen,  kann  ein  Target  den  sogenannten  CHECK  CONDITION-Status  zu- 
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riickmelden.  Der  Initiator  sollte  dann  mit  einem  speziellen  Kommando  (REQUEST  SENSE) 
die  zusatzlichen  Statusinformationen  von  dem  Target  einlesen. 


Der  Command  Descriptor  Block 

Der  Initiator  sendet  an  das  Target  einen  Command  Descriptor  Block  (CDB),  der  aus  6, 1 0  oder 
12  By  tes  bestehen  kann.  Zusatzlich  zu  den  in  diesem  Block  enthaltenen  Daten  konnen  weitere 
Informationen  wahrend  einer  DAT  A  OUT-Phase  hinterhergesendet  werden.  So  wird  zum  Bei- 
spiel  in  einem  CDB  einer  SCSI-Platte  mitgeteilt,  daB  ab  log.  Blocknummer  X  jetzt  eine  Anzahl 
von  Y  Datenblocken  geschrieben  werden  soil.  Die  Datenblocke  selbst  werden  dann  in  einer 
DATA  OUT-Phase  hinterhergesendet.  Der  prinzipielle  Aufbau  der  drei  moglichen  Formen 
eines  CDB  sieht  folgendermaBen  aus: 


Command  Descriptor  Block  -  6  Bytes  - 


Bit 

Byte 

7  6  5 

4  3  2  1  0 

0 

Gruppen-Code 

Command  Code 

1 

Logical  Unit 

Log.  Blockadresse  (MSB) 

2 

Log.  Blockadresse 

3 

Log.  Blockadresse  (LSB) 

4 

Transferlange 

5 

Control  Byte 

Command  Descriptor  Block  - 10  Bytes  - 


Bit 

Byte 

7  6  5 

4  3  2  1 

0 

0 

Gruppen-Code 

Command  Code 

1 

Logical  Unit 

Reserviert 

RelAdr 

2 

Log.  Blockadresse  (MSB) 

3 

Log.  Blockadresse 

4 

Log.  Blockadresse 

5 

Log.  Blockadresse  (LSB) 

6 

Reserviert 

7 

Transferlange  (MSB) 

8 

Transferlange  (LSB) 

9 

Control  Byte 
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Command  Descriptor  Block  - 12  Bytes  - 


Bit 

Byte 

7  6  5 

4  3  2  1 

0 

0 

Gruppen-Code 

Command  Code 

1 

Logical  Unit 

Reserviert 

RelAdr 

2 

Log.  Blockadresse  (MSB) 

3 

Log.  Blockadresse 

4 

Log.  Blockadresse 

5 

Log.  Blockadresse  (LSB) 

6 

Reserviert 

7 

Reserviert 

8 

Reserviert 

9 

Transferlange  (MSB) 

10 

Transferlange  (LSB) 

11 

Control  Byte 

Byte  0 


Jedes  Kommando  beginnt  mit  einem  Byte  fur  den  Operation  Code  (OP-Code). 

Dabei  wird  durch  die  hochstwertigen  drei  Bits  im  OP-Code  die  Gruppenzugehorigkeit  (Grup- 
pen-Code)  des  Kommandos  ausgedriickt. 


Gruppe  0 
Gruppe  1 
Gruppe  2-4 
Gruppe  5 
Gruppe  6-7 


Kommandos  mit  6  Bytes 
Kommandos  mit  10  Bytes 
Reserviert 

Kommandos  mit  12  Bytes 
Herstellerspezifische  Kommandos 


In  jeder  Gruppe  sind  dann  noch  5  Bits  fur  den  Command-Code  vorgesehen,  durch  die  dann 
32  verschiedene  Befehle  dargestellt  werden  konnen. 

Logical  Unit 

Da  ja  ein  Target  durchaus  mehr  als  ein  Peripheriegerat  steuem  kann,  miissen  diese  natiirlich 
voneinander  unterschieden  werden. 

Uber  die  drei  Bits  fur  die  LUN  (=Logical  Unit)  lassen  sich  so  bis  zu  acht  Gerate  pro  SCSI- 
Device  unterscheiden. 
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Log.  Blockadresse 

Hieriiber  wird  die  Nummer  des  anzusprechenden  log.  Blocks  mitgeteilt.  Log.  Blocks  beginnen 
mit  der  Nummer  0  und  werden  in  ununterbrochener  Reihe  fortgezahlt.  Bei  Gruppe  0-Kom- 
mandos  stehen  insgesamt  “nur”  21  Bits  fiir  die  LB  A  (Log.  Blockadresse)  zur  Verfiigung.  Da- 
mit  kann  man  immerhin  schon  iiber  2  Millionen  log.  Blockadressen  ansprechen. 

Bei  den  Gruppe  1-  und  5-Kommandos  sind  dann  iiber  4,2  Milliarden  (!)  Blocke  ansprechbar. 

Da  log.  Blocks  eine  unterschiedliche  Zahl  von  Datenbytes  beinhalten  konnen,  sollte  schon 
eine  Abstimmung  iiber  die  Blockgrofie  zwischen  Initiator  und  Target  vorgenommen  sein. 
Uber  Befehle  wie  MODE  SENSE  oder  READ  CAPACITY  kann  der  Initiator  zum  Beispiel 
die  BlockgroBc  vom  Target  erfragen. 

Relative  Address  Bit  (RelAdr) 

Dieses  Bit  wird  nur  bei  Gruppe  1  und  5-Kommandos  im  Zusammenhang  mit  verketteten 
Befehlen  (Linked  Commands)  verwendet.  Wenn  das  Bit  gesetzt  ist,  handelt  es  sich  bei  der  Log. 
Blockadresse  nicht  um  eine  absolute,  sondem  um  eine  relative  Blocknummer. 

Diese  relative  Blocknummer  (in  2er-Komplement-Darstellung;  positiver  oder  negativer 
Wert!)  wird  zu  der  letzten  verwendeten  absoluten  Log.  Blockadresse  addiert.  Das  Ergebnis 
ist  dann  die  gewiinschte  LB  A! 

Transferlange 

Durch  diesen  Wert  wird  iiblicherweise  angegeben,  wie  viele  log.  Blocks  iibertragen  werden 
sollen.  Manche  Kommandos  enthalten  allerdings  in  dem  Feld  Transferlange  die  Anzahl  der 
zu  iibertragenden  Bytes  (z.  B.  REQUEST  SENSE). 

Wenn  fiir  die  Angabe  der  Transferlange  nur  1  Byte  verwendet  wird,  konnen  maximal  256 
Blocks  in  einem  Rutsch  iibertragen  werden.  Dabei  steht  ein  Wert  von  Null  fiir  256  Blocks!  Alle 
anderen  Werte  zwischen  1..255  werden  durch  den  entsprechenden  Zahlenwert  ausgedriickt. 

In  Befehlen,  die  zwei  Bytes  fiir  die  Transferlange  zur  Verfiigung  stellen,  konnen  maximal 
65536  Blocke  pro  Kommando  iibertragen  werden.  Auch  hier  wird  die  hochste  Blockanzahl 
wieder  durch  den  Wert  von  Null  im  Transferlangenfeld  dargestellt. 

Control  Byte 

Das  jeweils  letzte  Byte  in  einem  CDB  ist  das  Control  Byte.  Es  hat  den  folgenden  Aufbau; 
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Control  Byte 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

LAST 

Herstellerspez. 

Reserviert 

Flag 

Link 

Link  Bei  einem  gesetzten  B  it  wird  dem  T  arget  signalisiert,  dafi  es  sich  um  eine  Verkettung 

von  Befehlen  handelt.  Es  werden  also  weitere  Befehle  vom  Initiator  ans  Target  gelie- 
fert. 

Targets,  die  diese  “Linked  Commands”  unterstiitzen,  liefem  bei  erfolgreicher  Kom- 
mandoausfiihrung  in  der  STATUS-Phase  ein  INTERMEDIATE-Statusbyte.  AuBer- 
dem  wird  eine  entsprechende  Meldung  (“LINKED  COMMAND  COMPLETE” 
bzw.  “LINKED  COMMAND  COMPLETE  (WITH  FLAG)”  in  einer  MESS  AGE  EM- 
Phase  an  den  Initiator  geliefert. 

Bei  Targets,  die  nicht  mit  “Linked  Commands”  klarkommen,  wird  am  Ende  der  Ope¬ 
ration  ein  CHECK  CONDITION-Statusbyte  geliefert.  Wenn  man  (der  Initiator) 
dann  mit  einem  REQUEST  SENSE-Befehl  beim  T arget  nachfragt,  was  denn  war,  er- 
halt  man  in  diesem  Falle  ein  “ILLEGAL  REQUEST”  signalisiert. 

Flag  Dieses  Bit  wird  nur  in  Verbindung  mit  dem  Link-Bit  benutzt  und  legt  fest,  welche 
Meldung  (LINKED  COMMAND  COMPLETE  bei  Flag = 0,  LINKED  COMMAND 
COMPLETE  (WITH  FLAG)  bei  Flag  =1 )  an  den  Initiator  gesendet  wird.  Typische 
Anwendung  fiir  dieses  Bitist  die  Verursachung  eines  Interrupts  zwischen  zwei  Link¬ 
ed  Commands  im  Initiator. 


Gruppe  0-Kommandos 

Im  folgenden  sollen  die  wichtigsten  Gruppe  0-Kommandos  fiir  “Direct- Access  Devices”  Iaut 
SCSI  erlautert  werden.  Diese  Kommandos  werden  deshalb  auch  von  nahezu  alien  SCSI- 
Festplatten  “verstanden”  und  sind  deshalb  auch  in  mancher  Harddisk-Software  (Treiber  und 
Tools  wie  AHDI  4.02,  SCSITOOL  2.09  und  HUSHI  2.12)  zu  finden. 

TEST  UNIT  READY 

Mit  diesem  Kommando  wird  getestet,  ob  die  angesprochene  LUN  (Logical  UNit)  des  ange- 
sprochenen  Targets  bereit  ist.  Damit  wird  nicht  etwa  ein  Selbsttest  angestoGen.  Wenn  die 
angesprochene  LUN  bereit  fiir  den  Zugriff  auf  das  Medium  ist,  liefert  der  TEST  UNIT 
READY-Befehl  einen  GOOD-Status  zuriick. 
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TEST  UNIT  READY  (OP-Code  00H) 


Bit 

Byte 

7 

6 

5 

■ 

3 

2 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

Logical  Unit 

Reserviert 

2 

Reserviert 

3 

Reserviert 

4 

Reserviert 

5 

Herstellerspez. 

Reserviert 

Flag  Link 

REZERO  UNIT 

Das  Target  soil  die  angesprochene  LUN  in  einen  speziellen  Anfangszustand  versetzen  (It. 
SCSI).  Bei  Festplatten  wird  man  mit  diesem  Kommando  die  Platte  auf  Zylinder  0  fahren  (nicht 
zu  verwechseln  mit  dem  “Parken”  von  Festplatten!  Das  wird  mit  dem  STOP-Befehl  reali- 
siert). 


REZERO  UNIT  (OP-Code  01H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

Logical  Unit 

Reserviert 

2 

Reserviert 

3 

Reserviert 

4 

Reserviert 

5 

Herstellerspez. 

Reserviert 

Flag 

Link 

REQUEST  SENSE 

Mit  diesem  Befehl  lassen  sich  in  der  an  die  COMMAND-Phase  anschlieBenden  DATA  IN- 
Phase  Sense-Daten  vom  Target  einlesen.  Diese  Sense-Daten  (Sense  =  Bedeutung,  Befinden) 
liefem  weitere  Informationen  Uber  die  Ursache  einer  Storung,  die  mit  einem  CHECK 
CONDITION-Status  nach  AbschluB  eines  anderen  Kommandos  an  den  Initiator  signalisiert 
wurde.  Sense-Daten  werden  vom  Target  nach  einer  Storung  so  lange  bereitgehalten,  bis  sie 
durch  diesen  Befehl  “abgeholt”  werden  oder  ein  anderer  Befehl  (vom  gleiehen  Initiator,  dem 
CHECK  CONDITION  gemeldet  wurde)  ausgefiihrt  wird. 
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REQUEST  SENSE  (OP-Code  03H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

o 

0 

0 

0 

1 

1 

T 

Logical  Unit 

Reserviert 

2 

Reserviert 

3 

Reserviert 

4 

Transferlange 

5 

Herstellerspez. 

Reserviert 

Flag 

|  Link 

Im  Feld  Transferlange  ubermittelt  der  Initiator  dem  Target,  wie  viele  Bytes  Sense-Daten  er 
vom  Target  maximal  aufhehmen  kann!  Das  Target  beendet  dann  die  folgende  DATA  IN- 
Phase,  wenn  diese  Zahl  von  Bytes  an  den  Initiator  ubermittelt  ist  (auch  wenn  noch  mehr  Bytes 
zur  Verfiigung  stiinden!)  Oder  wenn  alle  Sense-Daten  iibermittelt  sind,  Bei  einerTransferlange 
von  Null  sendet  das  Target  iibrigens  trotzdem  (gem.  SCSI-Vereinbarung)  vier  Sense-Daten- 
bytes! 

Man  unterscheidet  zwei  Formate  bei  den  iibermittelten  Sense-Daten,  wobei  das  Format  durch 
die  Art  des  Fehlers  bestimmt  wird.  Genauer  gesagt,  in  welche  Klasse  der  Fehler  eingeordnet 
wird: 

Nonextended  Sense  Fiir  die  Fehlerklassen  0..6  (Error  class  0..6)  kommt  ein  4-Byte-For¬ 
mat  zur  Anwendung. 

NONEXTENDED  SENSE  DATA  FORMAT 


Bit 

7 

6 

5 

4 

3 

2 

1  j  0 

Byte 

0 

AdValid 

Fehlerklasse 

Fehlercode 

1 

Herstellerspezifisch 

Logisehe  Blockadresse 

(MSB) 

2 

Logisehe  Blockadresse 

LJ _ 

Logisehe  Blockadresse 

(LSB) 

Ad  Valid  Wenn  dieses  Bit  gesetzt  ist,  steht  die  gelieferte  Logisehe  Blockadresse 

in  direkter  Beziehung  zu  dem  Fehler  (wenn  bei  einem  Festplatten- 
zugriff  z.  B.  ein  Lesefehler  auftrat,  wird  man  per  REQUEST  SENSE 
dann  in  der  log.  Blockadresse  die  Nummer  des  Blocks  Iibermittelt 
bekommen,  der  nicht  gelesen  werden  konnte!) 
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Fehlerklasse  Herstellerspezifische  Nummer,  mit  der  der  Fehler  klassifiziert  wird 

(Fehlerwichtigkeit). 

Fehlercode  FehlemummerineinerbestimmtenFehlerklasse.Herstellerspezifisch. 

Einige  Plattenhersteller  liefem  im  Fehlercode  den  gleichen  Wert  wie 
im  Sense  Key-Feld  beim  Extended  Sense-Format! 

Haufiger  anzutreffen  ist  das  erweiterte  Format  fur  Sense-Daten.  Vielfach  liefem  Targets  nur 
bei  einer  Transferlange  von  Null  im  REQUEST  SENSE-Befehl  das  “kurze”  Sense-Data-For- 
mat. 

Extended  Sense  Dieses  Format  umfaGt  mindestens  acht  Sense-Datenbytes!  Es  wird 

nur  bei  der  Fehlerklasse  7  verwendet 

Folgendes  Format  wird  benutzt: 

EXTENDED  SENSE  DATA  FORMAT 


Bit 

Byte 

7 

6 

5 

4 

3  2  10 

0 

Valid 

Fehlerklasse  (=  7) 

Fehlercode  (=  0) 

1 

Segmentnummer 

2 

FM 

EOM 

|  ILI 

Reserv.  Sense  Key 

3-6 

(MSB)  Informationsbytes  (LSB) 

7 

Anzahl  zusatzlicher  Sense  Bytes  (n) 

Zusatzliche  Sense  Bytes 

Die  Fehlerklasse  7  steht  fur  Extended  Sense!  Steht  dann  im  Fehlercode  eine  0,  wird  die  oben 
gezeigte  Datenstruktur  verwendet.  Die  Fehlercodes  1  ,.EH  sind  reserviert.  Bei  einem  Fehlercode 
von  FH  kommt  ein  herstellerspezifisches  Datenformat  zur  Anwendung  (bei  SCSI-Festplatten 
aber  nicht  anzutreffen!). 

Valid  Wenn  das  Bit  gesetzt  ist,  sind  die  Informationsbytes  in  den  Sense- 

Bytes  3..6  auch  giiltig.  Ublicherweise  findet  man  hier  dann  die  log. 
Blockadresse,  die  mit  der  Fehlermeldung  im  Zusammenhang  steht. 

Segmentnummer  Tritt  nur  bei  Fehlem  in  Zusammenhang  mit  speziellen  Befehlen  wie 
COPY,  COMPARE  und  COPY  WITH  VERIFY  auf.  Bei  diesen  Be¬ 
fehlen  konnen  zu  kopierende/vergleichende  Datenbereiche  in  soge- 
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FM 


EOM 


ILI 


Sense  Key 


nannten  Segmentdeskriptoren  (“Bereichs-Beschreibem”)  festgelegt 
werden.  Die  Segmentnummer  liefert  in  diesem  Fall  die  Nummer  des 
Segmentdeskriptors,  der  mit  dem  Fehler  in  Zusammenhang  steht. 

In  den  Informationsbytes  ist  dann  ein  Zahlenwert  in  Zweierkomple- 
mentdarstellung  enthalten,  der  darauf  schlieBen  laRt,  an  welcher  Stel- 
le  (Block/Byte)  in  dem  Segment  der  Fehler  aufgetreten  ist. 

File  Mark-Bit.  Nur  bei  sequentiell  arbeitenden  Peripheriegeraten 
eines  Targets  (z.  B.  Bandlaufwerke)  verwendet.  Filemarken  werden 
zum  Auffinden  bestimmter,  zusammengehoriger  Datenstrukturen 
(ahnlich  den  AdreBfeldmarken  in  einer  Spur  bei  Floppy-Disks)  be- 
nutzt.  Wenn  das  Bit  gesetzt  wird,  ist  eine  Filemarke  erkannt  worden. 

End-of-Medium-Bit.  Wird  nur  bei  sequentiellen  Peripheriegeraten 
und  Printer-Devices  gebraucht.  Bei  gesetztem  Bit  wird  auf  einen 
End-of-Medium-Zustand  aufmerksam  gemacht  (Band  befindet  sich 
am  Ende  Oder  beim  Riickspulen  ganz  am  Anfang!  Papier  ist  zu  Ende 
o.  a). 

Incorrect  length  indicator.  Wird  gesetzt,  wenn  die  im  Kommando 
geforderte  log.  BlockgroGe  nicht  mit  der  auf  dem  Medium  “harmo- 
niert"! 


“Bedeutungs-Schliisser.  HiermitistebenfallssoeineArtFehlergrup- 
pierung  moglich.  Beispielsweise  lieGen  sich  damit,  je  nach  Sense 
Key,  unterschiedliche  Fehlerbehandlungen  durch  den  Initiator  reali- 
sieren. 


Nachfolgend  eine  Tabelle  mit  den  Sense  Keys  nach  SCSI-Standard: 


Sense  Key 

Bedeutung 

Oh 

NO  SENSE.  Keine  besonderen  Vorkommnisse  (die  einer  Sense-Information 
bediirfen).  Diesen  Key  erhalt  man,  wenn  REQUEST  SENSE  nach  einem 
korrekt  ausgefuhrten  Befehl  ausgefiihrt  wird  (Statusbyte  war  GOOD!). 

Aber  auch  bei  einem  mit  CHECK  CONDITION  abgeschlossenen  Kommando 
gibt  es  diesen  Key,  wenn  z.  B.  nur  eine  Filemark  oder  End-of-Medium  erkannt 
wurde. 
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Sense  Key  Bedeutung 

1H  RECOVERED  ERROR.  Da  war  wohl  ein  Fehler,  aber  er  konnte  durchs  Target 

noch  wahrend  der  Ausfiihrung  korrigiert  werden. 

2h  NOT  READY.  Gewiinschte  LUN  ist  nicht  bereit. 

3h  MEDIUM  ERROR.  Fehler  auf  dem  Medium  (der  nicht  korrigiert  werden 

konnte!). 

4h  HARDWARE  ERROR.  Nichtbehebbarer  Fehler  in  der  Hardware. 

5h  ILLEGAL  REQUEST.  Im  Command  Descriptor  Block  oder  den  zusatzlich 

zum  Kommando  gehorenden  Daten  waren  ungiiltige  Parameter. 

6h  UNIT  ATTENTION.  Target  wurde  zuriickgesetzt  oder  das  Medium  gewech- 

selt. 

7h  DATA  PROTECT.  Der  per  Kommando  angesprochene  Block  ist  von  der 

gewiinschten  Operation  ausgenommen.  (Sehreib/Leseschutz). 

8h  BLANK  CHECK.  Bei  einem  sequentiell  arbeitenden  Device  oder  einem 

“Write-once  read-multiple”-Device  (=WORM-Device;  nur  einmal  beschreib- 
bares,  aber  beliebig  oft  lesbares  Medium  wie  z.  B.  Optical  Disk)  wurde  ein 
“blanker”  Block  (nicht  initialisierter  Block)  beim  Lesezugriff  erkannt. 

Oder  bei  einem  WORM-Device  mit  sequentiellem  Zugriff  wurde  ein  bereits 
mit  Daten  gefiillter  Block  beim  Schreibzugriff  erkannt. 

9h  Herstellerspezifischer  Sense  Key. 

Ah  COPY  ABORTED.  COPY-,  COMPARE-  oder  COPY  AND  VERIFY-Kom- 

mando  wurde  abgebrochen. 

B(1  ABORTED  COMMAND.  Der  letzte  Befehl  wurde  vom  Target  abgebrochen. 

Ein  weiterer  Versuch  vom  Initiator  konnte  nichts  schaden. 

CH  EQUAL.  Bei  einem  SEARCH  DATA-Kommando  wurde  die  Gleichheitsbedin- 

gung  erfullt. 

DH  VOLUME  OVERFLOW.  Ein  mit  Pufferspeicher  arbeitendes  Gerat  hat  bei 

einem  Schreibzugriff  das  Ende  des  Mediums  erreicht.  Dabei  konnten  nicht 
mehr  alle  Daten  im  Puffer  auf  dem  Medium  untergebracht  werden. 
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Sense  Key 

Bedeutung 

Eh 

MISCOMPARE.  Bei  einem  Vergleich  wurde  festgestellt,  daB  die  Quelldaten 
vom  Initiator  nicht  mit  vom  Medium  gelesenen  Daten  iibereinstimmen. 

Eh 

Reserviert! 

Die  meisten  Festplattenhersteller  liefern  zusatzlich  zu  diesen  Extended  Sense-Bytes  noch 
weitere  spezielle  Informationen.  Die  Verlangerung  der  Extended  Sense-Liste  ist  durch  das 
Feld  Additional  Length  urn  die  dort  eingetragene  Byteanzalil  moglich. 

Nahezu  alle  SCSI-Festplatten  liefem  in  den  zusatzlichen  Sense-Bytes  an  Byte-Position  12 
einen  zusatzlichen  Sense-Code.  AuBerdem  wird  dieser  Sense-Code  bei  manchen  Festplatten 
auch  im  ersten  Byte  des  Nonextended  Sense-Format  geliefert. 

Der  zusatzliche  Sense  Code  gibt  dann  noch  genaueren  AufschluB  iiber  Fehlerzustande  der 
Platte  oder  des  Controllers.  Man  wird  aber  dann  nicht  umhin  kommen,  sich  mit  der  Hersteller- 
Dokumentation  zu  “bewaffnen”,  um  den  Fehlerursachen  genau  auf  den  Grnnd  zu  gehen.  Zum 
Gltick  hatten  viele  Plattenhersteller  “die  gleichen  Ideen”,  was  diesen  Sense-Code  angeht.  Man 
entdeckt  so  viele  “Gemeinsamkeiten”  beim  Vergleich  der  Sense-Codes  unterschiedlicher 
Plattenhersteller. 


FORMAT  UNIT 

Mit  diesem  Befehl  wird  das  Peripheriegerat  angewiesen,  das  Medium  zu  formatieren. 

Damitistnach  AbschluB  des  Kommandos  gewahrleistet,  daB  auf  alle  verfiigbaren  Datenblocke 
zugegriffen  werden  kann. 


FORMAT  UNIT  (OP-Code  04H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

o 

0 

0 

0 

1 

0 

_  0 

1 

Logical  Unit 

FmtDa 

CmpLst 

Defektlistenformat 

2 

Herstellerspezifisch 

3 

Interleave  (MSB) 

4 

Interleave  (MSB) 

|  5 

Herstellerspez.  Reserviert 

Flag  |  Link 
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Im  Byte  2  des  Kommandos  erlauben  manche  Plattenhersteller  die  Angabe  des  Bitmusters, 
welches  beim  Formatiervorgang  in  die  Sektoren  geschrieben  wird.  Ahnlich  dem  Virgin-Byte 
bei  der  Floppy-Disk-Formatierroutine  des  XBios  (Flopfmt)  im  XBios  des  ST(E)/TT. 

Bei Interleave  kann  eine  spezielle  Zuordnung  zwischen  der  Reihenfolge  der  log.  Blocke  und 
den  dazugehorigen  physikalischen  Blocks  angegeben  werden. 


FmtData  NachdemFORMATUNIT-KommandofolgteineDATAOUT-Pha- 

se,  wenn  dieses  Bit  gesetzt  ist.  Damit  wird  iiblicherweise  eine  Liste 
mit  defekten  Stellen  an  das  T arget  iibermittelt,  die  beim  Formatiervor¬ 
gang  iibersprungen  werden  sollen. 

CmpLst  Wenn  das  Bit  gesetzt  ist,  mu£S  das  T arget  davon  ausgehen,  daB  in  der 

wahrend  der  DATA  OUT-Phase  gelieferten  Liste  alle  bekannten 
Defektstellen  enthalten  sind.  Eine  im  Target  vorhandene,  aitere 
Defektliste  ist  dann  nicht  mehr  zu  verwenden !  Wenn  das  Bit  geloscht 
ist,  soli  zu  der  bereits  im  Target  existierenden  Liste  mit  Defektstellen 
die  vom  Initiator  gesendete  Defektliste  zusatzlich  verwendet  werden. 

Alle  beim  Formatiervorgang  gefundenen  neuen  Defektstellen  wer¬ 
den  zu  den  bereits  bekannten  Defekten  (ob  im  Target  vorhanden  oder 
vom  Initiator  wahrend  einer  DATA  OUT-Phase  geiiefert)  “dazu- 
gepackt”! 


Defektlistenformat  Diese  drei  Bits  bestimmen,  zusammen  mit  den  FmtData-  und  CmpLst- 

Bits,  den  Aufbau  der  resultierenden  Defektliste  und  deren  Verwen- 
dung  fur  den  Formatiervorgang.  Nicht  alle  SCSI-Platten  beherrschen 
alle  nachfolgenden  Kombinationen! 


4  3  2  1  0 

Fmt  Data 

('nip  Lst 

|  Defektlistformat 


Bemerkungen 


0  X  X  X  X  Formatieren  ohne  Defektliste  vom  Initiator!  Es  wird  nur 

die  im  T arget  vorhandene  Defektliste  (bestehend  aus  vom 
Hersteller  eingetragenen  Defekten  und  bisher  erkannten 
Defektstellen)  verwendet.  Diese  Option  verstehen  wohl 
alle  Platten! 
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4  3  2  1  0 

Fmt  Data 

Cmp  Lst 


Bemerkungen 


1  0  0  X  X  Zusatzlich  zu  den  bekannten  Defektstellen  im  Target 

(Known  defect  list)  sollen  die  vom  Initiator  gelieferten 
Defektstellen  berucksichtigt  werden.  Fur  die  Defektliste 
vom  Initiator  wird  das  log.  Blockformat  (Format  A) 
benutzt. 

1  1  0  X  X  Die  vom  Initiator  gelieferte  Defektliste  soil  als  vollstdn- 

dige  Liste  aller  Defekte  benutzt  werden  (also  keine  Liste 
aus  dem  Target  benutzen!).  Die  gelieferte  Defektliste  ent- 
halt  die  Defektstellen  im  log.  Blockformat  (Format  A). 

10  10  0  Zusatzlich  zur  Known  defect  list  im  Target  sind  die  vom 

Initiator  gelieferten  Defektstellen  zu  beriicksichdgen. 
Die  Liste  liegt  als  Liste  derphys.  Sektoren  vor  (Format  B). 

1110  0  Die  vom  Initiator  gelieferte  Defektliste  soil  als  vollstan- 

dige  Liste  aller  Defekte  benutzt  werden  (also  keine  Liste 
aus  dem  Target  benutzen!).  Die  gelieferte  Defektliste 
enthalt  die  Defektstellen  als  Liste  von  phys.  Sektoren 
(Format  B). 

10  10  1  Zusatzlich  zur  Known  defect  list  im  Target  sind  die  vom 

Initiator  gelieferten  Defektstellen  zu  beriicksichtigen. 
Die  Liste  liegt  in  Form  von  Byte-Abstanden  vom  Index- 
impuls  vor  (Format  C). 

1110  1  Die  vom  Initiator  gelieferte  Defektliste  soli  als  vollstan- 

dige  Liste  aller  Defekte  benutzt  werden  (also  keine  Liste 
aus  dem  Target  benutzen!).  Die  Liste  liegt  in  Form  von 
Byte-Abstanden  vom  Indeximpuls  vor  (Format  C). 

Andere  Kombinationen  sind  herstellerspezifisch  bzw.  reserviert!  Nachfolgend  die  drei 

moglichen  Formate  fur  die  Defektliste,  welche  wahrend  einer  DATA  OUT-Phase  vom  Initia- 
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tor  an  das  Target  iibermittelt  werden  kann.  Dabei  weist  jede  Liste  zu  Beginn  den  sogenannten 
Defect  List  Header  auf,  der  letztlich  enthalt,  wie  viele  Bytes  an  eigentlicher  Defektinformation 
noch  folgen. 

Defektliste  im  log.  Blockformat  (Format  A) 


Byte 

Defect  List  Header 

0 

Reserviert 

1 

Reserviert 

2 

Defektlistenlange  (MSB) 

3 

Defektlistenlange  (LSB) 

Defect  Descriptor(s) 

0 

Def.  Blockadr.  (MSB) 

1 

Def.  Blockadr. 

2 

Def.  Blockadr. 

3 

Def.  Blockadr.  (LSB) 

Jeder Defect  Descriptor  enthalteine  Log.  Blockadresseundbelegt4Bytes  in  der  Descriptorliste. 
Die  Defect  Deskriptoren  sind  in  aufstei gender  Form  zu  liefem. 

Defektliste  im  phys.  Sektorformat  (Format  B) 


Byte 

Defect  List  Header 

0 

Reserviert 

1 

Reserviert 

2 

Defektlistenlange  (MSB) 

3 

Defektlistenlange  (LSB) 

Defect  Descriptor(s) 

0 

Zylindemummer  (MSB) 

1 

Zylindemummer 

2 

Zylindemummer  (LSB) 

3 

Kopfnummer 

4 

Sektomummer  (MSB) 

5 

Sektomummer 

6 

Sektomummer 

7 

Sektomummer  (LSB) 
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Jeder  Defect  Descriptor  enthalt  die  Position  des  Defekts  durch  Angabe  des  Zylinders,  der 
Kopfhummer  und  der  Sektomummer. 

Jeder  Defect  Descriptor  belegt  8  Bytes  in  der  Liste. 

Auch  hier  sind  die  Defekte  in  aufsteigender  Folge  anzugeben.  Dabei  wird  die  Zylindemummer 
am  starksten  gewichtet,  dann  die  Kopfnummer,  und  als  niedrigste  Gewichtung  wird  die  Sek- 
tomummmer  verwendet.  Wird  bei  Sektomummer  $FFFFFFFF  angegeben,  so  ist  der  ganze 
Track  als  defekt  anzusehen, 

Defektliste  im  “Byte-from-Index” -Format  (Format  C) 


Byte 

Defect  List  Header 

0 

Reserviert 

1 

Reserviert 

2 

Defektlistenlange  (MSB) 

3 

Defektlistenlange  (LSB) 

Defect  Descriptor(s) 

0 

Zylindemummer  (MSB) 

1 

Zylindemummer 

2 

Zylindemummer  (LSB) 

3 

Kopfnummer 

4 

Bytes-from-Index  (MSB) 

5 

Bytes-from-Index 

6 

Bytes-from-Index 

7 

Bytes-from-Index  (LSB) 

Jeder  Defect  Descriptor  enthalt  die  Position  des  Defekts  dutch  Angabe  des  Zylinders,  der 
Kopfnummer  und  der  Entfemung  des  Defekts  in  Bytes  vom  Indeximpuls.  Dabei  umfafit  eine 
Defektstelle  It.  SCSI  immer  einen  Bereich  von  8  Bytes! 

Jeder  Defect  Descriptor  belegt  8  Bytes  in  der  Liste. 

Auch  hier  sind  die  Defekte  in  aufsteigender  Folge  anzugeben.  Dabei  wird  die  Zylindemummer 
am  starksten  gewichtet,  dann  die  Kopfnummer,  und  als  niedrigste  Gewichtung  wird  die  Ent- 
femungsangabe  in  Bytes  vom  Indeximpuls  gewertet. 

Bei  $FFFFFFFF  in  “Bytes-from-Index”  ist  der  gesamte  Track  als  defekt  zu  betrachten. 
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Die  meisten  Plattenhersteller  benutzen  noch  einige  Bits  in  Byte  1  des  Defect  List  Headers,  urn 
bestimmte  “Anweisungen”  an  die  Platte  zu  iibermitteln. 


Defect  List  Header 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

B 

0 

0 

Reserviert 

1 

FOV 

DPRY 

DCRT 

STPF 

2 

Defektlistenlange  (MSB) 

3 

Defektlistenlange  (LSB) 

FOV  Format  Options  Valid.  Wenn  dieses  Bit  gesetzt  ist,  werden  die  Bits  4..6  in 

diesem  Byte  in  ihrer  Einstellung  beim  Formatiervorgang  beriicksichtigt.  Bei 
geloschtem  FOV-Bit  wird  mit  Standardvorgaben  fiir  die  Bits  4..6  dieses  Bytes 
gearbeitet. 

DPRY  Disable  Primary  Defect  List.  Bei  gesetztem  Bit  wird  die  bei  der  Fabrication  der 

Platte  aufgebrachte  Defektliste  beim  Formatiervorgang  nichi  beriicksichtigt! 

DCRT  Disable  Media  Certification.  Bei  gesetztem  Bit  werden  die  wahrend  eines  For- 

matiervorgangs  gefundenen  neuen  Defektstellen  nicht  mit  in  die  Defektliste 
aufgenommen\ 

STPF  Stop  Format  on  Error.  Bei  gesetztem  Bit  wird  ein  Formatiervorgang  abgebro- 

chen  (mit  Status  =  CHECK  CONDITION),  wenn  die  Defektliste  nicht  vom 
Medium  gelesen  werden  konnte.  Also  dann,  wenn  die  Defektliste  der  Platte 
selbst  einen  Defekt  aufweist.  Bei  geloschtem  Bit  wird  normal  weiterformatiert. 

REASSIGN  BLOCKS 

Mit  diesem  Befehl  lassen  sich  defekte  log.  Blocks  ausklammem  und  statt  dessen  (fiir  solche 
Zwecke  vorgesehene)  Reserveblocks  verwenden.  Der  Peripherie-Controller  wird  dann  bei 
einem  Zugriff  auf  einen  urspriinglich  defekten  Block  diesen  Zugriff  auf  den  Reserveblock  um- 
lenken.  Auch  bereits  schon  mal  neu  zugeordneteBlocke  (Reassigned  Blocks),  die  sich  im  Lau- 
fe  der  Zeit  als  defekt  herausstellen,  konnen  wiedemm  durch  andere  Reserveblocks  ersetzt  wer¬ 
den,  bis  halt  keine  Reserven  mehr  da  sind! 

Die  bei  einem  Reassign  herbeigefiihrte  Neu-Zuordnung  eines  log.  Blocks  ist  in  der  Regel  mit 
der  Anderung  des  Blockinhalts  verbunden! 
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Viele  SCSI-Platten  fiihren  eine  solche  Reassign-Operation  selbst  durch,  wenn  bei  einem  Zu- 
griff  festgestellt  wurde,  daB  der  gewiinschte  Block  defekt  ist. 


REASSIGN  BLOCKS  (OP-Code  07H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

Logical  Unit 

Reserviert 

2 

Reserviert 

3 

Reserviert 

4 

Reserviert 

5 

Herstellerspez. 

Reserviert 

Flag 

Link 

Auch  bei  diesem  Kommando  folgt  eine  DATA  OUT-Phase,  in  der  die  Liste  mit  den  defekten 
Blocken  (Defektliste)  an  das  Target  zum  Reassign  iibergeben  wird.  Der  Aufbau  dieser  Liste 
ist  der  gleiche  wie  bei  der  Defektliste  im  log.  Blockformat  (Format  A)  beim  FORMAT  UNIT- 
Befehl! 

READ 

Mit  diesem  Befehl  wird  das  Target  veranlaBt,  Daten  von  der  gewiinschten  LUN  an  den  Initiator 
zu  senden.  An  das  Kommando  schlieBt  sich  also  eine  DATA  IN-Phase  an.  Es  lassen  sich  dabei 
bis  zu  256  Blocke  vom  Target  einlesen.  Die  Blockanzahl  ist  im  Feld  Transferlange  einzutragen 
(0 = 256  Blocks !).  Durch  die  21  Bits  fiir  die  Blockadresse  kann  mit  diesem  6-Byte-Kommando 
immerhin  schon  auf  iiber  2  Millionen  Blocks  zugegriffen  werden.  Bex  einer  log.  BlockgroBe 
voniiblicherweise512  Bytes  erlaubtdieserBefehl  also  Zugriffeauf  immerhin  1  GByte  Daten! 


READ  (OP-Code  08H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

1 

Logical  Unit 

Log.  Blocknummer  (MSB) 

2 

Log.  Blocknummer 

3 

Log.  Blocknummer  (LSB) 

4 

Transferlange 

5 

Herstellerspez. 

Reserviert 

Flag  Link 
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WRITE 

Dieses  Kommando  ist  das  Gegenstiick  zum  READ-Befehl  und  zieht  eine  DATA  OUT-Phase 
nach  sich,  wahrend  der  die  zu  schreibenden  Daten  an  das  Target  iibergeben  werden. 

Fiir  Transferlange  und  log.  Blockadresse  gilt  sinngemaB  das  gleiche,  wie  bereits  beim  READ- 
Befehl  erwahnt. 


WRITE  (OP-Code  OAH) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

0 

1 

0 

1 

0 

1 

Logical  Unit 

Log.  Blocknummer  (MSB! 

2 

Log.  Blocknummer 

3 

Log.  Blocknummer  CLSB) 

4 

Transferlange 

5 

Herstellerspez. 

Reserviert 

Flag 

Link 

SEEK 


Die  angesprochene  Logical  Unit  (LUN)  des  Targets  wird  durch  den  SEEK-Befehl  veranlaBt, 
den  im  Kommmando  iibergebenen  Block  anzusteuem. 

BeiPlattenwirddieses  Kommando  wohlkaumgebraucht.weilZugriffeauflog.Blockadressen 
immer  direkt  mit  READ-  Oder  WRITE-Kommandos  durchgefiihrt  werden. 


SEEK  (OP-Code  OBH) 


Bit 

Byte 

7~1 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

1 

0 

1 

1 

1 

Logical  Unit 

Log.  Blocknummer  (MSB) 

2 

Log.  Blocknummer 

3 

Log.  Blocknummer  (LSB) 

4 

Reserviert 

5 

Herstellerspez. 

Reserviert 

Flag 

Link 
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INQUIRY 

Mit  diesem  “Erkundigungs’-Kommando  kann  man  mehr  liber  die  am  Target  angeschlossenen 
LUNs  erfahren. 

In  einer  DATA  IN-Phase  liefert  das  Target  dann  Informationen  tiber  die  angesprochene 
Logical  Unit. 

Zum  Teil  sind  in  den  Daten  “Klartextinformationen”  iiber  den  Typ  der  LUN  enthalten. 


INQUIRY  (OP-Code  12H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

1 

0 

0 

1 

0 

1 

Logical  Unit 

Reserviert 

2 

Reserviert 

Reserviert 

Transferlange 

5 

Herstellerspez. 

Reserviert 

Flag 

Link 

Im  Feld  Transferlange  wird  angegeben,  wie  viele  Bytes  der  Initiator  max.  wahrend  der  DATA 
IN-Phase  vom  Target  aufnehmen  kann. 

Die  wahrend  der  DATA  IN-Phase  gelieferten  INQUIRY-Daten  weisen  dabei  folgende 
Struktur  auf: 


INQUIRY  DATA 


Bit 

Byte 

■ 

6 

5  4  3 

2  10 

Permheriegerate-Tvn 

1 

Device-TvDe  Qualifier 

2 

ISO-Version 

ECMA-Version 

ANSI-Version 

3 

Reserviert 

4 

Zusatzliche  Bvtes  (N  ) 

5..N+4 

Herstellerspezifische  Daten 
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Peripheriegerate-Typ 


00H  Direct-access  Device  (z.  B.  Platte) 

01H  Sequ.-access  Device  (z.  B.  Bandlaufwerk) 

02h  Drucker 

03h  Prozessor-Device 

04h  Write  once,  read-mult.  (z.  B.  opt.  Disk) 

05h  Read-only,  dir.- Access  (z.  B.  CD-ROM) 

Die  weiteren  Codekombinationen  sind  reserviert! 


RMB  Removable  Medium  Bit.  Wenn  das  Medium  wechselbar  ist,  wird 

dieses  Bit  gesetzt,  sonst  nicht. 

Device-Type  Qualifier  DiesesiebenBitsstehendemAnwenderfiirspezielleldentifikatio- 

nen  der  im  System  verwendeten  LUNs  zur  Verfiigung.  Damit 
kann  der  Anwender  zum  Beispiel  durch  Vergabe  von  solchen 
Device-Type  Qualifiem  (meistens  mit  dem  Befehl  MODE  SE¬ 
LECT  einstellbar)  mehrere  gleichartige  Peripheriegerate  mit 
Wechselmedien  auseinanderhalten  (Wechselplatte,  Streamer, 
Bandlaufwerk  usw.). 

Version-Byte  In  diesem  Byte  lassen  sich  Informationen  unterbringen,  welcher 

Normenversion  (ISO,  ECMA  und  ANSI)  die  SCSI-Ausstattung 
(Moglichkeiten)  das  verwendete  Gerat  gerecht  wird. 


Im  Byte  4  steht  dann  eine  Information,  wie  viele  herstellerspezifische  Bytes  noch  folgen 
werden.  Wenn  noch  Herstellerbytes  folgen,  findet  man  in  den  Bytepositionen  8..  15  der 
INQUIRY-Daten  iiblicherweise  den  Herstellemamen  (im  erweiterten  ASCII  (8  Bit))  wieder. 
Bytes  16..3 1  dienen  meistens  zur  Produktbezeichnungundevtl.  der  AngabevonSeriennummem 
(ebenfalls  in  ASCII).  Weitere  Bytes  liefern  zum  Teil  ebenfalls  Seriennummem  oder 
Versionsnummem  der  Hard-  und  Firmware  sowie  das  Fabrikationsdatum. 


MODE  SELECT 


Mit  diesem  Kommando  lassen  sich  in  einer  anschlieBenden  DATA  OUT-Phase  eine  Meiige 
Parameter  an  das  Target  iibermitteln.  Wie  viele  Parameterbytes  wahrend  der  DATA  OUT- 
Phase  iibermittelt  werden,  ist  in  dem  Feld  Transferldnge  anzugeben. 

In  der  Parameterliste  sind  solche  Angaben  enthalten  wie  max.  Blockzahl  und  log.  BlockgroBe 
in  Bytes!  AuBerdem  lassen  sich  verschiedene  Betriebsmodi  einstellen.  Bei  Festplatten  mit 
Cache  kann  z.  B.  die  Anzahl  der  Cachesegmente  und  deren  GroBe,  bei  Platten  mit  Shutdown- 
Funktion  die  Zeit,  nach  der  diese  bei  “Nichtgebrauch”  in  einen  stromsparenden  Standby- 
Modus  gehen,  usw.  eingestellt  werden. 
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Ublicherweise  gelten  die  mit  MODE  SELECT  gemachten  Einstellungen  nur  bis  zum  nachsten 
Reset/Ausschalten.  Sollen  diese  Einstellungen  allerdings  ab  jetztimmer  gelten  (bis  zu  irgend- 
einer  emeuten  Anderung),  so  miissen  diese  gespeichert  werden.  Die  Speicherung  wird  durch 
Setzen  des  SP-Bits  im  MODE  SELECT-Befehl  veranlaBt. 


MODE  SELECT  (OP-Code  15H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

— 

1 

0 

0 

0 

0 

0 

1 

0 

1 

0 

1 

1 

Logical  Unit 

Reserviert 

SP 

2 

Reserviert 

3 

Reserviert 

4 

Transferlanae 

5 

Herstellerspez. 

Reserviert 

Flag 

Link 

Die  MODE  SELECT-Parameterliste  weist  nachfolgende  Struktur  auf,  wobei  es  moglich  ist, 
diese  Liste  um  herstellerspezifische  Angaben  zu  erweitem. 

Dabei  werden  diese  zusatzlichen  Angaben  in  Funktionsgruppen  zusammengefaBt.  So  eine 
Funktionsgruppe  wird  als  Page  bezeichnet. 

Jede  Page  wird  durch  den  Page-Code  identifiziert,  der  jeweils  im  ersten  Byte  der  Page  auf- 
taucht.  Damit  eine  Abgrenzung  zu  nachfolgenden  Pages  moglich  ist,  wird  im  zweiten  Byte 
jeder  Page  ein  entsprechender  Langenwert  angegeben. 

Dieser  Wert  enthalt  die  Anzahl  der  Pagebytes,  die  noch  nach  dem  Langenbyte  kommen! 


Byte 

MODE  SELECT  Header 

0 

Reserviert 

1 

Medium-Typ  (0) 

2 

Reserviert 

3 

Lange  des  Blockdescriptors 

Blockdescriptor(s) 

0 

Density  Code 

1 

Blockanzahl  (MSB) 

2 

Blockanzahl 
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Byte 

MODE  SELECT  Header 

3 

Blockanzahl  (LSB) 

4 

Reserviert 

5 

BlockgroBe  (MSB) 

6 

BlockgroBe 

7 

BlockgroBe  (LSB) 

Bei  Medium-Typ  sieht  SCSI  eine  ganze  Reihe  von  moglichen  Codes  vor,  die  sich  aber 
hauptsachlich  auf  Flexible  Disks  und  Magnetbanderbeziehen.  Bei  Fest-  und  Wechselplatten 
steht  dort  00„! 

n 

Der  Density-Code  im  Blockdescriptor  ist  auch  wiederum  nur  fur  Flexible  Disks  gedacht  und 
bei  Fest-/Wechselplatten  =  00H. 

Blockanzahl  spezifiziert,  wie  viele  Blocks  auf  dem  Medium  die  vorgenannte  Density  und  die 
nachfolgende  BlockgroBe  aufweisen.  Es  ist  gemaB  SCSI  zwar  moglich,  auf  einer  LUN  mehre- 
re  Bereiche  zu  vereinbaren,  die  unterschiedliche  BlockgroBen  und  Densities  aufweisen.  Dann 
sind  natiirlich  entsprechend  viele  Blockdeskriptoren  erforderlich.  Bei  Platten  wird  man  solche 
Einstellungen  aber  nicht  finden! 

Page  Descriploren 

Die  bereits  erwahnten  Pages  mit  hersteilerspezifischen  Parametem  sind  optional  und  schlie- 
Ben  bei  Bedarf  unmittelbar  an  die  Blockdeskriptoren  an.  Die  Reihenfolge,  in  denen  die  Pages 
gesendet  werden,  ist  beliebig.  Es  ist  auch  nicht  erforderlich,  daB  jeweils  immer  alle  Pages  mit 
einem  MODE  SELECT-Kommando  ubermittelt  werden.  So  konnen  spezielle  Einstellungen 
jederzeit  durch  Obermittlung  nur  dieser  speziellen  Page  bei  Bedarf  vorgenommen  werden. 


Page 

Code 

Bedeutung 

00H 

Allgemeine  Betriebsparameter 

01H 

Parameter  fur  Fehlerbehebung 

02h 

Parameter  fiir  Disconnect/Reconnect-Verhalten 

03h 

Format-Parameter 

04„ 

Unveranderbare  Plattenparameter  (Disk  Geometry)  * 

05„..1Fh 

Reserviert 

20„ 

Seriennummer  der  Platte  (manchmal!)  * 

21H-3FH 

Reserviert  bzw.  (sehr)  herstellerspezifisch 

*  =  Diese  Pages  konnen  nur  mit  MODE  SENSE  ausgelesen  werden! 
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Es  handelt  sich  hierbei  um  keinerlei  bindende  Zuordnung  gem.  SCSI.  Zum  Teil  findet  man 
jedoch  bei  vielen  Plattenherstellem  iibereinstimmende  Bedeutungen  bei  den  Parametem. 


AHgemeine  Betriebsparameter  (Page  Code  00H) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

Reserv. 

Page  Code  -  00,., 

1 

Page-Lange  (iiblicherweise  =  02H) 

2 

USG  |  RECY  |  STAT  |  UNIT  ATN  |  Reserviert 

3 

Device-Type  Qualifier 

USG  Usage  Counter.  SCSI-Platten  fiihren  genau  Buch  iiber  Schreib-/Lese- 

zugriffeund  Seek-Operationen.  Die  dabei  entstehendenZahlerstande 
konnen  bei  Uberschreiten  von  einstellbaren  Grenzwerten  zu  einer 
Fehlermeldung  fiihren.  Wenn  dieses  Bit  nicht  gesetzt  ist,  wird  auch 
bei  Uberschreiten  von  Zahlerstanden  keine  Fehlerbedingung  gemel- 
det. 

RECY  Recovery.  Bei  gesetztem  Bit  werden  alle  Fehler  gemeldet  (auch 

solche,  die  korrigiert  bzw.  durch  einen  emeuten  Versuch  beseitigt 
werden  konnten!),  und  auf  eine  Korrektur  durch  den  Controller  wird 
verzichtet.  Standardeinstellung  ist  ein  geloschtes  Bit.  Damit  werden 
nur  “emsthafte”  Fehler  an  den  Initiator  gemeldet. 

STAT  Status.  Bei  gesetztem  Bit  werden  auch  Fehler  gemeldet,  die  vom 

Kontroller  durch  eigene  MaBnahmen  behoben  werden  konnten. 
Normalerweise  geschieht  das  nicht,  weshalb  dieses  Bit  dann  auch 
geloscht  ist! 

UNIT  ATN  Unit  Attention.  Wenn  dieses  Bit  gesetzt  ist,  wird  das  Target  beim 

ersten  Kommando  (aufier  REQUEST  SENSE  und  INQUIRY)  nach 
einemResetoderEinschalteneinCHECKCONDlTIONimStatusbyte 
melden.  Bei  manchen  Platten  ist  das  die  Defaulteinstellung,  und 
somit  kann  man  dann  von  diesen  Platten  nicht  booten.  Das  TOS  ist 
namlich  auf  ein  CHECK  CONDITION  beim  Lesezugriff  auf  den 
Rootsektor  einer  Festplatte  nicht  vorbereitet  und  interpretiert  diesen 
CHECK  CONDITION-Status  als  “Platte  nicht  ansprechbar”.  Bei  den 
meisten  Platten  kann  man  dieses  Bit  “ausknipsen”,  und  damit  ist  das 
Problem  dann  wieder  gelost  (wenn  nicht  die  Firmware  des  Controllers 
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fehlerhaft  ist  und  dadurch  der  Zustand  dieses  Bits  immer  als  gesetzt 
angesehen  wird.  Alles  schon  dagewesen!).  Es  wird  dann  nach  Ein- 
schalten  oder  Reset  kein  CHECK  CONDITION-Status  gemeldet. 

Das  By  te  3  wird  in  der  Page  0  haufig  verwendet,  urn  den  Device-Type  Qualifier  setzen  zu  kon- 
nen.  Siehe  dazu  auch  beim  Befehl  INQUIRY. 

Parameter  fur  Fehlerbehebung  (Page  Code  01H) 


Bit 

Byte 

7 

6  5  4  3  |  2  1  0 

0 

Reserv. 

Page  Code  =  01 H 

1 

Page-Lange  (ublicherweise  =  06„) 

2 

AWRE  1  ARRE  1  TB  1  RC~1  EEC"!  PERl  DTEl  DCR 

Korrekturversuche 

4 

Korrekturspanne 

L5 

Reserviert 

Reserviert 

7 

Reserviert 

Mit  Page-l-Parametem  laBt  sich  bei  Platten  einstellen,  wie  im  Fehlerfall  verfahren  werden 

soil. 

AWRE  Automatic  Write  Reallocation.  Bei  gesetztem  Bit  fiihrt  der  Controller 

bei  einem  Schreibfehler  wegen  eines  Mediumdefekts  eine  Art  RE¬ 
ASSIGN  durch  und  legt  die  zu  schreibenden  Daten  in  einem  Reserve- 
block  ab.  Die  fehlerhafte  Stelle  auf  dem  Medium  wird  in  die  Defekt- 
liste  im  Controller  eingetragen. 

ARRE  Automatic  Read  Reallocation.  Funktioniert  genau  wie  AWRE,  nur 

fiir  Fehler  bei  Lesezugriffen. 

TB  Transfer  Block.  In  Verbindung  mit  dem  DTE-Bit  zu  sehen.  Wenn  bei- 

de  Bits  gesetzt  sind,  wird  bei  Lesezugriffen  auch  ein  fehlerhafter 
Block  an  den  Initiator  iibermittelt.  Ist  DTE  gesetzt,  TB  aber  nicht, 
wird  der  fehlerhafte  Block  nicht  gesendet. 

RC  Read  Continuous.  Bei  gesetztem  Bit  wird  bei  einem  Lesezugriff  das 

Aussenden  der  Daten  an  denlnitiatornicht  durch  evtl.Pausen  fur  Feh- 
lerkorrekturmaBnahmen  unterbrochen.  Das  bedeutet,  dafi  evtl.  auch 
fehlerhafte  Daten  gesendet  werden  konnen. 
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EEC 


PER 


DTE 


DCR 


Korrekturversuche 

Korrekturspanne 


Enable  Early  Correction.  Wenn  das  Bitgesetztist,  wird  erst  versucht, 
den  Fehler  durch  Fehlerkorrektur  nach  einem  Fehlerkorrektural- 
gorithmus  “rauszurechnen”.  Erst  wenn  das  nicht  klappt,  wird  ein  er- 
neuter  Zugriffsversuch  aufs  Medium  gestartet.  Wenn  das  Bit  geloscht 
ist,  wird  zuerst  mit  weiteren  Zugriffen  versucht  (max.  Anzahl  im  Feld 
“Korrekturversuche”  enthalten),  den  Fehler  zu  beheben. 

Post  Error-Bit. 

Geloscht:  CHECK  CONDITION  wird  nichterzeugt,  wenn  es  sich  um 
einen  Fehler  handelt,  der  im  Rahmen  der  Einstellungen  dieser  Page 
behoben  werden  konnte. 

Gesetzt:  CHECK  CONDITION  wird  fiir  behebbare  Fehler  ebenfalls 
erzeugt  und  der  Sense  Key  fiir  ein  folgendes  REQUEST  SENSE- 
Kommando  auf  “Recovered  Error”  gesetzt. 

Disable  Transfer  on  Error.  Bei  gesetztem  B  it  (PER-Bit  muB  ebenfall  s 
gesetzt  sein)  wird  sofort  der  CHECK  CONDITION-Status  geliefert. 
Datentransfers  zum  Initiator  werden  gestoppt.  Der  fehlerhafte  Block 
wird  abhangig  vom  TB-Bit  evtl.  noch  gesendet! 

Wenn  das  Bit  geloscht  ist,  wird  der  Datentransfer  komplett  durchge- 
fiihrt  (wenn  evtl.  Fehler  behoben  werden  konnten)  und  erst  danach 
wird  ein  CHECK  CONDITION  (falls  notig)  erzeugt! 

Disable  Correction.  Bei  gesetztem  Bit  wird  bei  einem  Fehler  nur 
versucht,  durch  wiederholte  Zugriffe  den  Fehler  zu  beheben.  Ein 
“Herausrechnen”  des  Fehlers  wird  nicht  durchgefiihrt.  Bei  gelosch- 
tem  Bit  wird  auch  versucht,  den  Fehler  mit  Hilfe  ernes  Error  Correct¬ 
ing  Codes  (ECC)  zu  beseitigen. 

Anzahl  der  Korrekturversuche  durch  emeutes  Lesen,  bevor  evtl.  mit 
Fehlerkorrekturcode-Einsatz  (ECC)  gearbeitet  wird. 

Max.  Grofte  in  Bits,  die  ein  Lesefehler  “lang”  sein  darf,  bei  dem  es 
sich  noch  lohnt,  mit  Fehlerkorrekturcode  eine  Behebung  durchzufiih- 
ren  (Werte  um  8..  10  sind  gebrauchlich). 


Da  im  TT  nicht  mit  DISCONNECT  und  RECONNECT -Messages  gearbeitet  wird,  wird  auf 
den  Aufbau  der  Page  2  nicht  weiter  eingegangen.  AuBerdem  bieten  nur  wenige  Plattentypen 
Einstellmoglichkeiten  in  dieser  Page! 
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Format-Parameter  (Page  Code  03H) 


Bit 

Byte 

7 

6 

5 

3  |  2 

1 

0 

- - 

0 

Reserv. 

Page  Code  =  03H 

1 

Page-Lange  (iiblicherweise  =  16H) 

Behandlung  von  Defektstellen 

2-3 

(MSB) 

Anzahl  Spuren  pro  Zone  (Zylinder) 

(LSB) 

4-5 

(MSB) 

Anzahl  Ausweichsektoren  pro  Zone 

(LSB) 

6-7 

(MSB) 

Anzahl  Ausweichspuren  pro  Zone 

(LSB) 

8-9 

(MSB) 

Anzahl  Ausweichspuren  pro  Medium 

(LSB) 

Angaben  zum  Svurformat 

10-11 

(MSB) 

Sektoren/Spur  (bei  variabler  Zahl  =  0!) 

(LSB) 

Angaben  zum  Sektorformat 

12-13 

(MSB) 

Bytes  pro  Sektor 

(LSB) 

14-15 

(MSB) 

Interleave 

(LSB) 

16-17 

(MSB) 

Track  Skew  Faktor 

(LSB) 

18-19 

(MSB) 

Zylinder  Skew  Faktor 

(LSB) 

Angaben  zum  Plattentyp 

20 

SSEC  1 

HSEC 

|  RMB 

T~ 

Reserviert 

. 

21-23 

Reserviert 

Track  Skew  Faktor  Anzahl  phys.  Sektoren  zwischen  dem  letzten  log.  Block  einer  Spur 
und  dem  ersten  log.  Block  auf  der  direkt  anschlieBenden  Spur. 

Zylinder  Skew  Faktor  Anzahl  phys.  Sektoren  zwischen  dem  letzten  log.  Block  eines  Zylin- 
ders  und  dem  ersten  log.  Block  auf  dem  direkt  anschlieBenden  Zylin¬ 
der. 


SSEC 


Soft  Sectored.  Bei  gesetztem  Bit  ist  die  Platte  softsektoriert.  Bit 
HSEC  mufi  dann  geloscht  sein! 


HSEC 


Hard  Sectored.  Bei  gesetztem  Bit  handel  t  es  sich  um  eine  hardsektorier- 
te  Platte.  Dann  mufi  das  SSEC-Bit  geloscht  sein! 


RMB 


Removable.  Bei  Wechselplatten  ist  dieses  Bit  gesetzt,  sonst  geloscht. 


Viele  dieser  Angaben  sind  Read-Only-Daten,  d.  h.,  sie  werden  wohl  beim  MODE  SENSE- 
Kommando  geliefert,  konnen  aber  nicht  geandert  werden.  AuBerdem  gilt  hier  die  Regel,  daB 
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in  dieser  Page  gemachte  EinsteUungen  erst  nach  einem  unmittelbar  folgenden  FORMAT 
UNIT-Befehl  giiltig  werden! 

MODE  SENSE 

Dieser  Befehl  ist  das  Gegenstiick  zum  MODE  SELECT-Befehl.  Mit  ihm  lassen  sich  die 
EinsteUungen  des  Peripheriegerates  vom  Initiator  einlesen. 

MODE  SENSE  (OP-Code  1AH) 


Bit 

Byte 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

1 

1 

0 

1 

0 

1 

Logical  Unit 

Reserviert 

2 

PCF 

Page  Code 

3 

Reserviert 

4 

Transferlange 

5 

Herstellerspez, 

Reserviert 

Flag 

Link 

PCF  Page  Control  Field.  Mit  diesen  beiden  Bits  Mt  sich  festlegen,  welche  Art  von 

Page-Parametem  zuriickgeliefert  werden  soil. 

PCF  —  00:  Report  Current  Values.  Die  im  Moment  eingestellten  Parameter 
sollen  zuriickgeliefert  werden.  Das  sind  entweder  jene  Parameter,  die  durch 
den  letzten,  erfolgreich  durchgefiihrten  MODE  SELECT-Befehl  eingestellt 
wurden,  oder  gespeicherte  Werte  (Saved  Parameter),  weil  seit  dem  Einschal- 
ten  des  Gerdts  noch  kein  MODE  SELECT-Befehl  ausgefiihrt  wurde. 

PCF  ~  01:  Report  Changeable  Values.  Es  wird  in  den  angeforderten  Pages 
lediglich  durch  gesetzte  Bits  signalisiert,  welche  Parameter  anderbar  sind. 
Nicht  anderbare  Bits  oder  Felder  werden  mit  0  zuruckgegeben. 

PCF  =  10:  Report  Default  Values.  Angeforderte  Pages  werden  mit  den 
Standardeinstellungen  ab  Werk  zuriickgeliefert. 

PCF  -11:  Report  Saved  Values.  Die  angeforderten  Pages  werden  mit  den 
zuletzt  gespeicherten  EinsteUungen  zuruckgegeben. 

Page  Code  In  diesem  Feld  ist  anzugeben,  welche  Page  zuriickgeliefert  werden  soli.  Sollen 

alle  Pages  geliefert  werden,  ist  hier  3FH  einzutragen. 
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Transferlange  Anzahl  der  Bytes,  die  der  Initiator  bei  der  auf  dieses  Kommando  folgenden 

DATA  IN-Phase  aufnehmen  kann.  Das  Target  liefert  so  Iange  Daten,  bis 
diese  Lange  erreicht  ist  Oder  bis  im  Target  keine  weiteren  Daten  mehr  vor- 
liegen. 


MODESENSE-Daten 


Bit 

Byte 

7 

6  5  4  3  2  1  0 

0 

Anzahl  Sense-Daten 

1 

Medium-Tyn 

2 

WP 

Reserviert 

3 

Blockdeskriptor-Lanee  (=8) 

Blockdeskriptoii  en) _ 

0 

Density  Code 

1-3 

(MSB)  Blockanzahl  (LSB) 

4 

Reserviert 

wm 

1MSB1  Blocklanee  (LSB) 

WP  steht  fiir  Write  Protected  und  signalisiert  mit  einem  gesetzten  Bit,  daB  das  Medium 
schreibgeschiitzt  ist. 

Medium-Typ ,  Density  Code ,  Blockamahl  und  Blocklange  enthalten  die  gleichen  Angaben, 
wie  bereits  beim  MODE  SELECT-Kommando  erlautert. 

Die  mit  der  auf  dieses  Kommando  folgenden  DATA  IN-Phase  eingelesenen  Daten  sind 
ebenfalls  wieder  Page-strukturiert. 

Der  Aufbau  dieser  Pages  ist  im  Prinzip  der  gleiche,  wie  beim  MODE  SELECT-Kommando 
bereits  beschrieben.  Lediglich  die  beiden  obersten  Bits  im  jeweils  ersten  Page-Code  Byte  sind 
reserviert. 

Das  hochstwertige  dieser  beiden  Bits  wird  manchmal  benutzt,  um  anzuzeigen,  ob  die 
Parameter  in  der  Page  auch  dauerhaft  gespeichert  werden  konnen. 

Da  die  Page  4  Parameter  zur  “Geometry”  einer  Platte  enthalt  und  somit  einiges  an  Informa- 
tionen  iiber  die  Platte  liefert,  soil  der  Aufbau  dieser  Page  (die  nur  gelesen  werden  kann!)  hier 
noch  kurz  gezeigt  werden. 
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Unveranderbare  Plattenparameter  (Disk  Geometry)  Page  04H 


Bit 

Byte 

7  1  6 

5  4  3  2  1  0 

0 

Reserviert 

Page  Code  (=  04„) 

1 

Page-Lange  (iiblichenveise  12H) 

2-4 

(MSB)  Anzahl  Zylinder  (LSB) 

5 

Anzahl  Kopfe 

6-8 

(MSB)  Startzyl.  mit  Schreibvorkompensation  (LSB) 

9-11 

(MSB)  Startzyl.  mit  reduz.  Schreibstrom  (LSB) 

12-13 

(MSB)  Steprate  (LSB) 

14-16 

(MSB)  Zylindemummer  der  Ladezone  (LSB) 

17-19 

Reserviert 

START/STOP  UNIT 

Mit  diesem  Kommando  ist  es  moglich,  eine  LUN  des  Targets  “Ein”  und  “Aus”  zu  schalten. 

Bei  Flatten  ist  es  so  moglich,  diese  mit  dem  STOP  UNIT-Befehl  in  eine  ArtRuhezustand  zu 
versetzen,  in  dem  sie  wenig  Strom  verbrauchen  und  auch  entsprechend  weniger  Gerausche 
verursachen. 

Platten  ohne  Autopark-Funktion  (heutzutage  selten  zu  finden)  lassen  sich  mit  diesem  Befehl 
in  eine  Art  Transportstellung  bringen,  so  daB  sie  nicht  mehr  so  empfmdlich  auf  Erschiitterun- 
gen  reagieren. 


START/STOP  UNIT  (OP-Code  1B„) 


Bit 

Byte 

7 

s 

4 

3 

2 

TH 

0 

0 

0 

0 

0 

1 

1 

0 

i 

1 

1 

Logical  Unit  Reserviert 

IMMED 

2 

Reserviert 

3 

Reserviert 

4 

Reserviert 

START 

5 

Herstellerspez.  Reserviert 

Flag 

Link 
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IMMED  Bei  gesetztem  Bit  wird  direkt  nach  Einleitung  der  Aktion  (Start  oder  Stop)  das 
Statusbyte  zuriickgegeben.  Bei  geloschtem  Bit  wird  der  Status  erst  geliefert, 
wenn  das  Kommando  beendet  ist. 

START  Ein  gesetztes  Bit  bedeutet  “START”.  Bei  geloschtem  Bit  wird  gestoppt! 

PREVENT/ALLOW  MEDIUM  REMOVAL 

Dieses  Kommando  existiert  natiirlich  nur  fur  Peripheriegerate  mit  Wechselmedien,  wie  z.  B. 
Wechselplatten.  Mit  diesem  Kommando  lafit  sich  eine  Ver-/Entriegelung  des  Mediums  vor- 
nehmen.  Damit  kann  z.  B.  bei  entsprechender  Implementation  der  Systemsoftware  ein  nicht 
zulassiger  Mediumwechsel  verhindert  werden. 


PREVENT/ALLOW  MEDIUM  REMOVAL  (OP-Code  IE,,) 


Bit 

Byte 

7 

6 

5 

4 

3 

~ - - - 

2 

1 

0 

0 

0 

0 

0 

1 

1 

,  1 

1 

0 

1 

Logical  Unit 

Reserviert 

2 

Reserviert 

3 

Reserviert 

4 

Reserviert 

PREVENT 

5 

I-Ierstellerspez.  Reserviert 

Flag 

Link 

PREVENT  Bei  gesetztem  Bit  ist  ein  Mediumwechsel  gesperrt,  sonst  zulassig!  Nach  einem 
Reset  ist  eine  evtl.  Verriegelung  jedoch  wieder  aufgehoben! 

Doch  nun  zum  praktischen  Umgang  mit  den  SCSI-Informationen  in  Verbindung  mit  dem  TT. 


Das  SCSI-Interface  beim  TT 

ATARI  verwendet  im  TT  fur  die  Bedienung  des  SCSI-Ports  einen  alteingefuhrten  Controller- 
Chip,  den  “5380”.  Alle  erforderlichen  Komponenten  fiir  das  Betreiben  eines  SCSI-Ports  sind 
in  diesem  Chip  enthalten. 

So  ist  der  Chip  durch  entsprechende  Ausgangsstufen  in  der  Lage,  direkt  den  SCSI-Bus  zu 
treiben.  Bis  zu  48mA  bei  einem  Low-Pegel  von  0,5  V  “verkraftet”  der  Chip  pro  Ausgang  ohne 
zusatzliche  Treiber-Chips. 
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Abb.  6.2:  Die  SCSI-Hardware  des  TT 
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Nur  durch  Softwareeinstellung  ist  der  5380  sowohl  als  Initiator  als  auch  als  Target  betreibbar. 
ARBITRATION  und  RESELECTION  sind  moglich  (aber  z.  Zt.  nicht  verwendet). 

Der  5380  kann  in  DMA-Umgebungen  verwendet  werden,  wobei  er  im  TT  durch  einen  eigenen 
SCSI-DMA-Controller  (bestehend  aus  zwei  Custom-Chips)  unterstiitzt  wird.  Eine  Transferrate 
bis  zu  1 ,5  MByte/s  im  Asynchronbetrieb  (Synchronbetrieb  kann  der  Chip  nicht!)  ist  zu  errei- 
chen. 

Natiirlich  kann  der  5380  auch  einige  Interrupts  erzeugen.  Folgende  Interrupts  sind  moglich: 
SELECTION/RESELECTION,  SCSI-Bus-Reset,Parity-FehlerwahrendeinesDatentransfers, 
SCSI-Bus-DISCONNECTION,  Endedes  DMA-Transfers  oder  bei  unzulassigenBuszustanden 
wahrend  einer  Busphase.  Ausgenutzt  wird  die  Interruptfahigkeit  des  5 380  im  TT  jedoch  nicht. 
Sein  Interrupt-Ausgang  IRQ  wird  lediglich  bei  manchen  Aktionen  per  Polling  abgefragt  (Bit 
7  des  I/O-Ports  vorn  TT-MFP,  Adr.  $FF  FA81,  “GPIP_TT”). 


Die  Register  des  SCSI-Controllers 

Der  5380  wird  als  Peripheriebaustein  in  Form  von  acht  Registem  mit  einer  Registerbreite  von 
8  Bit  angesprochen.  Dabei  liegt  im  TT  der  5380  mit  seinen  Registem  auf  ungeraden  Adressen. 
Auch  hier  gilt  wieder,  daB  diese  Adressen  sowohl  im  ST-AdreKraum  (24  Bit)  bei  $FF  878X 
als  auch  im  32  Bit-AdreiJraum  der  68030-CPU  “ganz  oben”  bei  $FFFF  878X  auftauchen.  Je 
nachdem,  ob  auf  den  5380  ein  Lese-  oder  Schreibzugriff  stattfindet,  erfiillen  die  Register  zum 
Teil  verschiedene  Aufgaben. 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  878 1 

R 

Aktueller  Inhalt  des  SCSI-Datenbusses 

“s_data” 

Bei  einem  Lesezugriff  auf  diese  Adresse  erhalt  man  die  Daten,  die  sich  im  Moment  auf  dem 
SCSI-Datenbus  befinden.  Wenn  mit  Paritat  gearbeitet  wird,  wird  diese  immer  zu  Beginn  des 
Lesezyklusses  getestet.  Verwendet  wird  dieses  Register  wahrend  eines  Lesevorgangs  “von 
Hand”  oder  wahrend  der  ARBITRATION-Phase  zur  Uberpriifung,  ob  noch  ein  hoherwertiges 
Device  sich  um  den  Bus  bemiiht. 


Adresse 

Zugriff 

Bezeichnung 

Label 

SFF8781 

W 

Ausgabedaten 

“s_data” 

Bei  einem  Schreibzugriff  findet  man  an  der  gleichen  Adresse  wie  zuvor  das  Register  fiir  die 
Daten,  die  iiber  den  Bus  gesendet  werden  sollen. 
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Sowohl  wahrend  eines  normalen  Schreibzugriffes  durch  die  CPU  auf  den  SCSI-Bus  als  auch 
wahrend  DMA-Betrieb  wird  dieses  Register  fiir  die  Datenausgabe  verwendet.  Au/Serdem  wer- 
den  wahrend  der  ARBITRATION-  und  SELECTION-Phase  iiber  dieses  Register  die  BD-Bits 
ausgegeben. 


Adresse 

Zugriff 

Bezeichimng 

Label 

$FF  8783 

R/W 

|  Initiator-Befehlsregister 

“s_icr” 

Mit  Hilfe  dieses  Registers  Iassen  sich  bestimmte  Bussignale  im  Initiatorbetrieb  beeinflussen 
und  auch  bei  einem  Lesezugriff  auswerten.  Der  Stand  des  ARBITRATION-Prozesses  laBtsich 
in  diesem  Register  durch  entsprechende  Bits  ebenfalls  ablesen. 

Obwohl  die  meisten  dieser  Bits  nur  bei  Initiatorbetrieb  interessant  sind,  gibt  es  doch  auch  eini- 
ge,  die  fiir  den  Betrieb  des  Chips  als  Target  verwendet  werden  (was  im  TT  jedoch  nicht  vor- 
kommt!). 


Initiator-Befehlsregister  (WRITE) 


Bit  7 

6 

5 

4 

3 

2 

1 

0 

Assert 

Test 

Assert 

Assert 

Assert 

Assert 

Assert 

JRST 

Modus 

0 

_ACK 

_BSY 

_SEL 

_ATN 

Data 
to  Bus 

Initiator-Befehlsregister  (READ) 


Bit  7 

6 

5 

4 

3 

2 

1 

0 

Assert 

AIP 

LA 

Assert 

Assert 

Assert 

Assert 

Assert 

_RST 

_ACK 

_BSY 

_SEL 

_ATN 

Data 
to  Bus 

Bit  7 

Assert  _RST  (R/W)  Aktiviere  RESET. 

Solange  dieses  Bit  gesetzt  ist,  wird  auf  dem  SCSI-Bus  die  RESET- 
Leitung  aktiviert!  Mit  Einschalten  von  RESET  wird  auch  der  IRQ- 
Ausgang  des  5380  aktiviert!  Bei  einem  Lesezugriff  wird  derZustand 
dieses  Registerbits  zuriickgeliefert. 
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Bit  6 

Test  Modus  (W)  Nur  fiir  Testzwecke  gedacht!  Im  Normalbetrieb  mu8  dieses  Bit  ge- 
loscht  sein! 


AIP  (R)  Arbitration  in  Progress.  Am  Zustand  dieses  Bits  kann  abgelesen 

werden,  ob  der  Chip  sich  gerade  in  einer  ARBITRATION-Phase 
befindet.  Damit  der  Chip  sich  iiberhaupt  an  der  ARBITRATION- 
Phase  beteiligt,  muB  das  ARBITRATE-Bit  (Bit  0)  im  Betriebsarten- 
register  (s_mode)  gesetzt  sein.  Werrn  der  Chip  sich  an  der  ARBI¬ 
TRATION  beteiligt,  wird  AIP  gesetzt,  sobald  eine  BUS  FREE-Phase 
erkannt  wurde,  der  5380_BSY  aktiviert  hat  und  seine  ID  auf  den  Bus 
gelegt  ist. 


Lost  Arbitration.  Der  5380  hatte  sich  urn  den  SCSI-Bus  bemiiht, 
jedoch  die  ARBITRATION  verloren.  Damit  eine  Auswertung  des 
LA-Bits  moglich  ist,  muB  das  ARBITRATE-Bit  im  Betriebsarten- 
register  (s_mode)  gesetzt  sein. 

Bit  4 

Assert  _ACK  (RAV)  Aktiviere  _ACK-Ltg.  Dieses  Bit  wird  von  einem  Initiator  wahrend 
des  Datenaustauschs  verwendet,  um  den  _REQ/_ACK-Handshake 
abzuwickeln.  Bei  gesetztem  Bit  wird  die  _ACK-Leitung  aktiviert. 
Damit  der  Handshake  funktioniert,  muB  das  TARGETMODE-Bit  im 
Betriebsartenregister  (s_mode)  geloscht  sein. 

Bei  einem  Lesezugriff  erhalt  man  die  im  Moment  giiltige  Einstellung 
des  Registerbits. 

Bit  3 

Assert  _BSY  (RAV)  Aktiviere  _BSY-Ltg.  Mit  diesem  Bit  wird  direkt  die  _BSY-Ltg.  ge- 
steuert. 


Bit  5 

LA  (R) 


Bei  einem  Lesezugriff  erhalt  man  die  im  Moment  giiltige  Einstellung 
des  Registerbits. 


Bit  2 

Assert  _SEL  (RAV)  Aktiviere  _SEL-Ltg.  Direkte  Beeinflussung  der  _SEL-Ltg. 

Bei  einem  Lesezugriff  erhalt  man  die  im  Moment  giiltige  Einstellung 
des  Registerbits. 
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Bit  1 

Assert  _ATN  (R/W)  Aktiviere  _ATN-Ltg.  Nur  wirksam,  wenn  der  5380  als  Initiator 

arbeitet.  Dazu  muB  das  TARGETMODE-Bit  im  Betriebsarten- 
register  (s_mode)  gelbscht  sein. 

Bei  einem  Lesezugriff  erhalt  man  die  im  Moment  giiltige  Ein- 
stellung  des  Registerbits. 


BitO 

Assert  Data  to  Bus  (R/W)  Bei  gesetztem  Bit  konnen  die  Daten  im  Ausgabedatenregister 

(s_dat)  auf  den  SCSI-Datenbus  gelangen. 

Aufierdem  wird  die  zugehorige  Paritat  erzeugt  und  ausgegeben. 

Die  Datenbusausgange  des  5380  werden  bei  Initiatorbetrieb 
jedoch  nur  dann  freigegeben,  wenn  das  TARGETMODE-Bit  im 
Betriebsartenregister  (s_mode)  geloscht  ist,  J/O-Signal  vom 
Bus  deaktiviert  ist  und  die  Signale  _C/D  und  _MSG  mit  den 
entsprechenden  Einstellungen  im  Target-Befehlsregister  (s„tcr) 
iibcreinstirnmen,  also  “in  Phase  liegen”. 

Dieses  Bit  sollte  bei  DMA-Sendebetrieb  naturlich  ebenfalls 
gesetzt  sein! 

Bei  einem  Lesezugriff  erhalt  man  die  im  Moment  giiltige 
Einstellung  des  Registerbits. 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8785 

R/W 

Betriebsartenregister 

“s_mode” 

Mit  einem  Schreibzugriff  lassen  sich  die  einzelnen  Betriebsarten  des  5380  einstellen. 
Ein  Lesezugriff  liefert  dann  die  im  Moment  eingestellte  Betriebsart. 


Bit  7 

6 

5 

4 

3 

2 

1 

0 

Block 

Tar- 

Enable 

Enable 

Enable 

Moni- 

DMA 

Arbi- 

Mode 

get- 

Parity 

Parity 

EOP- 

tor 

Mode 

trate 

DMA 

mode 

Check 

Interr. 

Inter. 

Busy 

L 
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Blockmode-DMA 

TARGETMODE 

Enable  Parity  Checking 

Enable  Parity  Interrupt 

Enable  EOP-Interrupt 

Monitor  Busy 

DMA-Mode 

ARBITRATE 


Mit  diesem  Bit  wird  die  Art  des  Handshakes  zwischen  DMA- 
Baustein  und  5380-Chip  festgelegt.  Im  TT  ist  kein  Blockmode- 
DMA  mbglich,  Folglich  muB  bei  alien  DMA-Operationen  das 
Bit  geloscht  sein! 

Mit  diesem  Bit  wird  festgelegt,  ob  der  5380  als  Initiator 
(Bit  =  0)  Oder  als  Target  (Bit  =  1)  arbeiten  soil! 

Bei  gesetztem  Bit  werden  Paritatsfehler  signalisiert.  Wenn 
Parit&tsfehler  aufgetreten  sind,  wird  dies  in  Form  eines  gesetz- 
ten  Bit  5  im  Statusregister  angezeigt. 

Bei  gesetztem  Bit  wird  bei  einem  Paritatsfehler  ein  entspre- 
chender  Interrupt  ausgelost.  Dazu  muB  naturlich  auch  das 
“Enable  Parity  Checking”-Bit  gesetzt  sein! 

EOP  steht  fiir  End  of  Process.  Bei  gesetztem  Bit  reagiert  der 
5380  damit  auf  das  EOP-Signal  vom  DMA-Baustein,  der  damit 
das  Ende  eines  DMA-Prozesses  signalisiert.  Es  wird  bei  ge¬ 
setztem  Bit  dann  ein  entsprechender  Interrupt  ausgelost. 

Bei  gesetztem  Bit  wird  die  _BSY-Leitung  des  SCSI-Busses 
iiberwacht  und  bei  unerwartetem  Deaktivieren  von  Busy  ein 
Interrupt  ausgelost.  Wenn  das  geschieht,  werden  die  untersten 
sechs  Bits  des  Initiator  Befehlsregisters  (s_icr)  geloscht,  und 
der  5380  nimmt  alle  Signale  vom  SCSI-Bus  herunter! 

Dieses  Bit  wird  benutzt,  um  einen  DMA-Transfer  in  die  Wege 
zu  leiten.  Es  ist  dazu  vor  dem  Beschreiben  der  DMA-Register 
des  5380  zu  setzen.  Ein  DMA -Transfer  kann  durch  Riicksetzen 
dieses  Bits  abgebrochen  werden,  Bei  einem  EOP-Signal  vom 
DMA-Baustein  wird  dieses  Bit  allerdings  nicht  zuriickgesetzt! 

Durch  Setzen  dieses  Bits  wird  der  5380  veranlaBt,  in  die 
ARBITRATION-Phase  einzutreten.  Dazu  muB  das  Ausgabeda- 
tenregister  (s_data)  die  eigene  SCSI-Device-ID  enthalten.  So- 
bald  der  5380  eine  BUS  FREE-Phase  erkennt,  wird  der  Chip 
versuchen,  den  Bus  “fur  sich  zu  gewinnen”!  Erfolg  Oder  MiB- 
erfolg  und  auch  der  Zustand  der  ARBITRATION  kann  ja  iiber 
die  AIP-  und  LA-Bits  im  Initiator-Befehlsregister  (s_icr)  ermit- 
telt  werden. 
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Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8787  | 

R/W 

Target  Befehlsregister 

“s_tcr” 

Wenn  der  5380  als  Target  (TARGETMODE-Bit  im  Betriebsartenregister  (s_mode)  gesetzt!) 
betrieben  wird,  erlaubt  dieses  Register  die  Kontrolle  Uber  die  SCSI-Bus-Transferphasendurch 
direktes  Steuem  der_MSG-,  _C/D-  und  _I/0-Leitungen, 

AuBerdem  wird  Uber  dieses  Register  die  _REQ-Handshakeleitung  direkt  gesteuert. 


Bei  DMA-Betrieb  wird  durch  ein  Bit  signalisiert,  wann  das  letzte  Datenbyte  uber  den  SCSI- 
Bus  gesendet  wurde  (nur  53C80-Chip!). 


Bit  7 

6 

5 

4 

3 

2 

1 

0 

Last 

Byte 

Sent 

nicht 

be- 

nutzt 

nicht 

be- 

nutzt 

nicht 

be- 

nutzt 

Assert 

_REQ- 

Assert 

_MSG 

Assert 

_C/D 

L_ 

Assert 

J/O 

Last  Byte  sent  Nur  lesbar!  Bei  gesetztem  Bit  ist  das  letzte  Byte  auf  den  SCSI-Bus 
gegeben  worden.  Dieses  Flag  wird  gebraucht,  weil  das  “End  of  DMA”- 
Bit  im  Statusregister  (s_idstat)  lediglich  dariiber  informiert,  wann  das 
letzte  Byte  vom  DMA-Baustein  ubergeben  wurde!  ATARI  verwendet 
im  TT  jedoch  noch  den  5380-Chip,  der  dieses  Bit  noch  nicht  kennt! 

Wenn  der  53 80  als  Initiator  betrieben  wird,  miissen  wahrend  eines  Datentransfers  die  Zustande 
der  Bits  0..2  mit  den  Zustanden  auf  den  SCSI-Bus-Leitungen  iibereinstimmen.  Sonst  entsteht 
ein  Phasen-Mischmasch,  ah..,  “Phase-mismatch”,  der,  wenn  eingeschaltet,  zu  einem  Interrupt 
fuhrt.  Bei  Initiatorbetrieb  hat  das  Assert  _REQ-Bit  keine  Funktion! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8789 

R 

Busstatusregister 

“sjdstat” 

Aus  diesem  Register  konnen  die  jeweils  aktuellen  Zustande  der  sieben  wichtigsten  SCSI- 
Steuer-Leitungen  abgelesen  werden. 

Man  erhalt  dabei  jeweils  einen  “SchnappschuB”  der  aktuellen  Busphase.  So  kann  bei  Initia¬ 
torbetrieb  z.  B.  ein  _REQ-Signal  vom  Target  an  dem  entsprechenden  Bit  erkannt  werden.  An- 
schlieBend  wird  das  angeforderte  Byte  ausgegeben  und  mit  _ACK  quittiert. 
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Bit  7 

6 

~  5 

4 

3 

2 

1 

0 

JRST 

_BSY 

_REQ 

_MSG 

_C/D 

J/o 

_SEL 

Paritat 

Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8789 

|  W 

AdreJIregister 

“s_idstat” 

Dieses  Register  kann  wahrend  der  SELECTION-Phase  benutzt  werden.  Es  ist  als  Maskenregister 
zu  verwenden,  in  dem  das  ID-Bit  gesetzt  wird,  auf  dessen  “Auftauchen”  wahrend  der 
SELECTION-Phase  gewartet  wird.  Wenn  dieses  ID-Bit  auf  dem  Bus  erkannt  wird  und  zudem 
_BSY  deaktiviert  und  _SEL  aktiviert  ist,  wird  ein  Interrupt  veranlaBt.  Wenn  auf  diesen  Inter- 
mpt  verzichtet  werden  soli,  sind  alle  Bits  in  diesem  Register  auf  0  zu  setzen! 


Adresse 

Zugriff 

Bezeichnung 

1  Label 

$FF  878B 

R 

Statusregister 

|  “s_dmastat” 

In  diesem  Statusregister  findet  man  zum  einen  die  SCSI-Bussignale  wieder,  die  im 
Busstatusregister  (sjdstat)  nicht  zu  finden  sind,  und  zum  anderen  sechs  weitere  Statusbits. 


Bit  7 

6 

5 

4 

3 

2 

1 

0 

End 

of 

DMA 

DMA 

Re¬ 

quest 

Parity 

Error 

IRQ 

aktiv 

Phase 

match 

Busy 

Error 

„ATN 

_ACK 

End  of  DMA 


DMA  Request 


Ende  eines  DMA-Prozesses.  Zuriickgesetzt  wird  dieses  Bit,  wenn  das 
“DMA-Mode”-Bit  im  Betriebsartregister  (s_mode)  geloscht  wird. 

Damit  kann  die  CPU  den  Zustand  des  DRQ-Anschlusses  des  5380 
iiberwachen.  Wird  normalerweise  nicht  benotigt. 


Parity  Error  Hieriiber  wird  ein  Paritatsfehler  wahrend  eines  Datenempfangs  oder 

wahrend  der  SELECTION-Phase  mitgeteilt.  Natiirlich  nur  dann, 
wenn  das  “Enable  Parity  Checking”-Bit  im  Betriebsartregister 
(s_mode)  gesetzt  ist.  Geloscht  wird  diese  Fehlermeldung  durch 
Auslesen  des  Resetregisters  fur  Interrupts  und  Parityfehler  (s_inircv) . 
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IRQ  aktiv 


Phase  match 


Busy  Error 


Der  Zustand  des  IRQ-Pins  des  5380  kann  hier  zusatzlich  abgelesen 
werden.  Interrupts  werden  durch  Auslesen  des  Resetregisters  fiir 
Interrupts  und  Parityfehler  (sjnircv)  geloscht. 

Dieses  Bit  ist  nur  fiir  Initiatorbetrieb  interessant  und  enthalt  eine 
standige  Aussage  dariiber,  ob  die  unteren  3  Bits  des  Target-Befehls- 
registers  (s_tcr)  mit  den  SCSI-Signalen  _MSG,  _C/D  und  _I/0  kor- 
respondieren.  Nur  bei  einem  Phase  match  ist  Datentransfer  zulassig. 

Dieses  Bit  wird  aktiviert,  wenn  JBSY  unerwartet  inaktiv  wird. 


_ATN 


Der  Zustand  der  Attention-Leitung. 


_ACK 


Der  Zustand  der  Acknowledge-Leitung. 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  878B 

W 

Start  DMA-Ausgabe 

“s_dmastat” 

Bei  einem  Schreibzugriff  auf  dieses  Register  (Wert  ist  dabei  egal!)  wird  die  DMA-Ausgabe 
gestartet.  Vorher  mufi  das  “DMA-Mode”-Bit  im  Betriebsartregister  (s_mode)  gesetzt  sein! 

AuBerdem  sind  alle  notigen  Einstellungen  wie  Initiator/Targetbetrieb  und  “Block-Mode- 
DMA”  oder  “Normal  DMA-Mode”  natiirlich  ebenfalls  vorher  vorzunehmen. 

Im  TT  steuert  eine  eigene  SCSI-DMA-Einheit  (zwei  Custom  Chips)  den  DMA-Betrieb  mit 
dem  5380! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  878D 

W 

Start  Target-DMA-Eingabe 

“s_targrcv” 

Wenn  der  5380  als  Target  arbeitet,  wird  fiir  lesenden  DMA-Betrieb  (vom  SCSI-Bus  lesen!) 
die  Aktion  durch  einen  Schreibzugriff  auf  dieses  Register  (Wert  egal)  gestartet. 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  878D  1 

R 

Eingaberegister 

'  “s„targrcv” 

Uber  einen  Lesezugriff  auf  dieses  Register  erhalt  man  die  Daten  vom  SCSI-Datenbus.  Jeweils 
bei  Aktivierung  von  _ACK  (bei  Target-DMA-Eingabe)  oder  bei  Aktivierung  von_REQ  (bei 
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Initiator-DMA-Eingabe)  wirddas  Dateby  te  auf  dem  SCSI-Bus  in  diesem  Register  zwischenge- 
speichert  (latched). 


Der  DMA-Baustein  liest  die  Daten  Byte  fiir  Byte  aus  diesem  Register  aus.  Dabei  werden  die 
_IOR-  und  _DACK-Anschliisse  entsprechend  durch  den  DMA-Baustein  bedient. 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  878F 

W 

|  Start  Initiator-DMA-Eingabe 

“sjnircv” 

Ein  Schreibzugriff  (Wert  ist  egal)  startet  den  lesenden  DMA-Betrieb  bei  Programmierung  des 
5380  als  Initiator.  Fiir  DMA-Betrieb  muB  natiirlich  wieder  das  “DMA-Mode”-Bit  im 
Betriebsartregister  (s„mode)  und  der  5380  auf  Initiatorbetrieb  eingestellt  sein. 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  878F 

R 

Resetreg.  fiir  Interrupts  +  Parityfehler 

“sjnircv” 

Interrupts  und  Parity-Fehleranzeigen  werden  durch  Lesen  dieses  Registers  geloscht.  Dabei 
erhalt  man  keinen  sinnvollen  Wert  zuriick.  Es  kommt  nur  auf  den  Lesezugriff  an! 


Damit’s  einfacher  wird  -  SCSI-Datentransfer  mit 
DMA-Unterstiitzung 

Fiir  den  Datenaustausch  wahrend  der  Datentransferphasen  hat  ATARI  dem  5380  eine  eigene 
DM  A-Einheit  zur  Seite  gestellt.  Gleiches  gilt  fur  den  im  TT  vorhandenen  Serial  Communications 
Controller  SCC. 

Da  der  5380  Daten  nicht  in  der  auf  dem  Systembus  verwendeten  Long-Form  (32  Bit-Zugriff) 
verarbeiten  kann,  ist  die  DMA-Einheit  fiir  die  Umsetzung  zustandig.  Dabei  arbeitet  der  DMA- 
Baustein  immer  mit  zwei  Longs.  Wahrend  also  die  DMA-Einheit  darauf  wartet,  das  eine  Long 
auf  den  Systembus  zu  geben,  wird  schon  das  nachste  Long  im  DMA-Baustein  zusammenge- 
setzt.  Wenn  das  zweite  Long  bereits  gefiillt  sein  sollte,  bevor  der  DMA-Baustein  die  Kontrolle 
iiber  den  Systembus  wieder  abgegeben  hat,  wird  das  zweite  Long  direkt  hinterher  geschrieben. 

SCSI-DM  A-Betrieb  ist  dabei  auf  jede  R  AM- Adresse  moglich.  Also  im  Gegensatz  zum  DMA- 
Betrieb  mit  ACSI-Geraten  gibt  es  keinerlei  Beschrankung  auf  den  Bereich  des  ST-RAMs, 

Fiir  den  Programmierer  stellt  sich  der  DMA-Kanal  folgendermaBen  dar: 


Ein  Schritt  in  die  richtige  Richtung  -  Der  TT-SCSI-Port 


1125 


-  Ein  Status-  und  Control-Register  in  Word-Breite,  auf  das  schreibend  und  lesend 
zugegriffen  werden  kann. 

-  Ein  32-Bit-AdreBregister  (Pointer)  fiir  die  DMA-Adresse  (liegt  in  Form  von  vier 
Registem  mit  Bytebreite  vor). 

-  Ein  Restdatenregister,  welches  benutzt  wird,  um  mit  CPU-Hilfe  Transfers  auf  nicht  im 
Long-Raster  (durch  4  teilbare)  liegende  Adressen  zu  ermoglichen.  Gleiches  gilt  fiir 
DMA-Transfers  mit  BIockgroBen.  die  nicht  im  Long-Raster  (4-Byte-Raster)  Iiegen. 

-  Ein  32-Bit-BytezahIer  fiir  DMA-Daten.  Dieses  Zahlregister  wird  durch  Kombination 
von  vier  Bytes  gebildet. 


Die  SCSI-DMA-Register 

Die  Registeradressen  des  SCSI-DMA-Chips  Iiegen  sowohl  am  oberenEnde  des  ST-AdreBraums 
($FF  87XX)  als  auch  ganz  oben  im  TT-AdreBraum  ($FFFF  87XX).  Angegeben  isthier  je- 
weils  die  Lage  im  ST-AdreBraum! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8701 

R/W 

DMA-Address-Pointer  (Highest  Byte) 

“tt_dmabas” 

$FF  8703 

R/W 

DMA-Address-Pointer  (High  Byte) 

“tt_dmabas”+2 

$FF  8705 

RAV  | 

DMA-Address-Pointer  (Low  Byte) 

“tt_dmabas”+4 

$FF  8707 

RAV 

DMA-Address-Pointer  (Lowest  Byte) 

“tt_dmabas”+6 

$FF  8709  1 

RAV 

DMA-Bytezahler  (Highest  Byte) 

“tt„dmacnt” 

$FF  870B 

RAV 

DMA-Bytezahler  (High  Byte) 

“tt_dmacnt”+2 

$FF  870D 

RAV 

DMA-Bytezahler  (Low  Byte) 

“tt_dmacnt”+4 

$FF  870F 

RAV 

DMA-Bytezahler  (Lowest  Byte) 

“tt_dmacnt”+6 

Da  diese  vier  Byte  breiten  Register  alle  so  schon  hintereinanderliegen,  kann  fiir  den  Long- 
Zugriff  darauf  in  Maschinensprache  ein  “movep.l”-Befehl  benutzt  werden! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8710 

R 

Restdatenregister  (High-Word) 

“tt_dmarsd” 

$FF  8712 

R 

Restdatenregister  (Low-Word) 

“tt_dmarsd”+2 

Wenn  am  SchluB  einer  DMA-Operation  kein  voller  Long  mehr  in  den  Speicher  ttbertragen 
wurde,  muB  hier  der  Rest  an  Datenbytes  “per  Hand”  ausgelesen  und  durch  die  CPU  an  die 
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richtigen  Adressen  gebracht  werden!  Wie  viele  Restby  tes  das  sind,  erfahrt  man  aus  den  letzten 
beiden  AdreBbits  des  DMA- Address-Pointers. 

Die  Startadresse  n  fiir  die  Restbytes  ergibt  sich  aus  dem  Inhalt  des  DMA-Address-Pointers 
minus  der  Anzahl  an  Restbytes.  Die  Restbytes  sind  “linksbiindig”  im  Restdatenregister  ange- 
ordnet.  Also  gehort  das  Highbyte  im  High-Word  an  die  Startadresse  n.  Das  Lowby  te  im  High- 
word  kommtnach  Startadresse  n+1  usw.! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8714 

|  R/W 

Kontrollregister  (Word) 

“tt.dmactl” 

Obwohl  dieses  Register  mit  Wordzugriffen  bearbeitet  wird,  sind  nur  die  untersten  S  Bits 
benutzt.  Man  kann  deshalb  auch  mit  Bytezugriffen  auf  die  Adresse  $(FF)FF  8715  arbeiten, 
um  diese  Kontrollbits  zu  beeinflussen  bzw.  auszuwerten.  Hier  deshalb  nur  die  interessanten 
unteren  8  Bits  des  Registers: 


Bit  7 

6 

5 

4 

3 

2 

1 

0 

Bus 

Error 

_ 

Byte 

count 

zero 

Reser- 

viert 

Reser- 

viert 

Reser- 

viert 

Reser- 

viert 

DMA 

Enable 

DMA- 

Direc¬ 

tion 

Bus  Error 


Byte  count  zero 


DMA-Enable 

DMA-Direction 


Ein  gesetztes  Bit  weist  auf  einen  Busfehler  wahrend  des  DMA- 
Betriebs  hin.  Durch  Auslesen  dieses  Registers  wird  der  Busfehler- 
Status  wieder  zuriickgesetzt.  Diese  Fehlersignalisierung  geht  auch  an 
den  TT-MFP,  I/O-Port  #5  und  kann  bei  entsprechender  Program- 
mierung  einen  Interrupt  auslosen. 

Ein  gesetztes  Bit  zeigt  an,  daB  der  DMA-Bytezahler  auf  Null  gezahlt 
hat,  also  alle  Bytes  transferiert  sind. 

Bei  gesetztem  Bit  ist  der  DMA-Baustein  “eingeschaltet”. 

Bit  gesetzt:  Schreiben  an  SCSI-Controller.  Bit  geldscht:  Lesen  von 
SCSI-ControIler. 


Um  einen  DMA-Betrieb  durchzufiihren,  ist  zunachst  die  Transferrichtung  im  DMA-Baustein 
(Bit  0  in  “tt_dmactl”)  einzustellen.  AnschlieBend  wird  die  Basisadresse  im  DMA-Address- 
Pointer  (“tt_dmabas”)  gesetzt  und  die  Zahl  der  zu  iibertragenden  Bytes  im  DMA-Bytezahler 
(“tt_dmacnt”)  eingestellt. 
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Wenn  dann  auch  der  SCSI-Controller  entsprechend  programmiert  ist,  wird  durch  Setzen  des 
“DMA-Enable”-Bits  in  “tt_dmactl”  der  DMA-ProzeB  gestartet. 


Die  Programmierung  des  TT-SCSI-Ports 

Das  nachfolgende  Listing  zeigt  in  Form einer  kommentierten  Beispielroutine  den  Umgang  mit 
der  SCSI-Hardware  im  TT.  Der  TT  arbeitet  dabei  als  Initiator  in  einer  Single-Initiator-Umge- 
bung  (also  ohne  ARBITRATION-Phase)  und  best  mit  dem  INQUIRY -Befchl  die  Daten  von 
dem  SCSI-Device-#0  in  einen  Buffer  ein. 

Bei  diesem  Code-Beispiel  ist  also  sowohl  die  SELECTIONS-Phase,  die  COMMAND-Phase 
und  anschlieBend  eine  DATA  IN-Phase  mit  abschbeBender  STATUS-  und  MESSAGE-Phase 
enthalten. 


;  Beispielroutine  fiir  die  Programmierung  des  TT-SCSI-Ports 
;  von  Hans-Dieter  Jankowski  fiir  ATARI  ST/STE/TT  Profibuch 


device 

equ 

2 

tr length 

equ 

$A0 

kurz 

equ 

200 

lang 

equ 

400 

bsy  da 

equ 

13 

(~250ms) 

_hz_200 

equ 

$4BA 

GPIP_TT 

equ 

$FFFFFA81 

tt_dmabas 

equ 

$FFFF8701 

tt_dmacnt 

equ 

$FFFF8709 

tt  draarsd 

equ 

$FFFF8710 

tt_dmactl 

equ 

$FFFF8714 

s_data 

equ 

$FFFF8781 

s  icr 

equ 

s  data+2 

s_rnode 

equ 

s_data+4 

s_tcr 

equ 

s  data+6 

;  Target-ID  (0  =  int.  Platte) 
;  160  Bytes  Einlesen  reicht! 

;  Timeout -Wert  fiir  1  Sekunde 
;  Timeout -Wert  fur  2  Sekunden 
;  Timeout -Wert  f.  SELECTION 


;  Adr.  200  Hz-Systemtimer 

;  TT-MFP  Port register 

;  SCSI-DMA-Addrefi-Pointer 
;  SCSI-DMA-Bytezahler 
;  SCSI-DMA-Restdatenbytes 
;  SCSI-DMA-Controlregister 

;  Erstes  Register  im  5380 
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s_idstat  equ 
s_dmastat  equ 
s_targrcv  equ 
s  jinircv  equ 


s_data+8 
s_data+$A 
s_data+$C 
s  data+$E 


;  Fur  das  SCSI-Device-Nr.  "device"  werden  die  INQOIRY-Daten  ein- 
;  gelesen 

;  Die  per  DMA  gelesenen  Daten  stehen  dann  im  Speicher  ab  Adr. 

;  "buffer" 

;  Bei  korrekter  Ausfuhrung  liefert  dO  im  Low-Word  das  Statusbyte 
;  und  im  High-Word  das  MESSAGE-Byte  zum  Abschluft  der  Operation. 

;  Ein  neg.  Wert  in  dO  weist  auf  eine  Zeituberschreitung  in  be- 
;  stimmten  Phasen  hin. 


inquiry: 

lea 

lea 

lea 


s__data,  a5 
tt_dmabas,  a6 
_hz_200,  a  4 


;  Ptr.  auf  5380-Register  setzen 
;  Ptr.  auf  SCSI-DMA-Baustein  setzen 
;  In  a4  Ptr.  auf  Systemtimer  halten 


Erstmal  testen,  ob  der  SCSI-Bus  zur  Zeit  frei  ist 


move . 1 

(a4) ,d7 

/ 

addi .  1 

#kurz,d7 

r 

bsyO: 

f 

btst 

#6, 8 (a5) 

7 

beq.s 

doselect 

/ 

cmp.l 

(a4) ,d7 

r 

bcc.s 

chk  bsyO 

moveq 

#-2,d0 

7 

bra 

error 

Aktuellen  Systemtimerwert  holen 
Bis  zu  diesem  Timerwert  versu- 
chen. 

_BSY-Leitung  testen 
_BSY  aktiviert? 

Timerwert  mit  Endwert  vergleichen 
Dauert  zu  lange,  also  raus  hier. 


Nix  mehr  los  auf 'm  SCSI-Bus!  Also  dann  in  die  SELECTION-Phase ! 

/ 

doselect : 

moveq.l  #0,d0  ;  4  Bytes  mit  Null  in  Reg.  DO! 

movep.l  d0,2(a5)  ;  s_icr/s_mode/s_tcr/s__idstat 

;  loschen 

;  Target-ID-Bit  in  s__data  einstel- 
;  len . 


bset 


#device, (a5) 
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inove.b 

#1,2 (a5) 

ID-Bit  auf  SCSI-Bus  ausgeben. 

move.b 

#5,2 (a5) 

__SEL-Ltg.  aktivieren 

move . 1 

(a4),d7 

Aktuellen  Systemtimerwert  holen 

addi . 1 

#bsy_da, d7 

In  250ms  mufi  Targ.  sich  melden 

chk  bsyl: 

btst 

#6, 8 (a5) 

_BSY~Leitung  testen 

bne.s 

docmnd 

__BSY  aktiviert? 

cmp.l 

(a4),d7 

Timerwert  mit  Endwert  vergleichen 

bcc.s 

chk  bsyl 

Dauert  zu  lange,  also  raus  hier. 

moveq 

#-3,d0 

bra 

error 

f 

Target  hat 

sich  gemeldet 

(BUSY  ist  aktiviert  worden) .  Also  ab 

;  in  die  COMMAND-Phase . 

r 

docmnd: 

move.b 

#0, 2  (a5) 

r 

Initiator  deaktiviert  alle  Ltg, 

move.w 

#0,tt_dmactl 

r 

DMA-Baust.  auf  Lesen  einstellen 

move . 1 

#buf fer,  dO 

r 

Anfangsadr.  des  DMA-Puffers  in 

movep . 1 

dO,  (a6) 

} 

DMA-Address-Ptr .  ablegen 

move . 1 

#trlength, dO 

r 

Transferlange  in 

movep . 1 

dO, 8 (a6) 

r 

DMA-Bytezahler  ablegen 

DMA-Baustein  ist  vorbereitet !  Jetzt  "per  Hand"  die  Command- 
Bytes  ans  Target  ubermitteln.  Dabei  wird  der  _REQ/_ACK- 
Handshake  unter  CPU-Kontrolle  erledigt! 

Die  Aktion  sollte  nicht  langer  als  "kurz"  x  5ms  dauern,  sonst 
Abbruch  und  Sprung  in  die  Fehlerroutine. 


lea 

cmdtable, aO 

r 

T 

Ptr.  auf  1.  Byte  vom  SCSI- 
Kommando 

moveq 

#5,dl 

r 

(Anzahl-1)  der  zu  sendenden  Bytes 

move . 1 

(a4),d7 

r 

Akt .  Sys-Timerwert  holen  und  End¬ 

addi . 1 

#kurz, d7 

r 

wert  berechnen  (steht  in  d7) 

move.b 

#2, 6  (a5) 

r 

"Assert  C/D"  in  s_tcr  (CMD- 

r 

Phase ! ) 

move.b 

#1,2 (a5) 

} 

"Assert  Data  to  Bus"  in  s_icr 

1130 


ATARI  Profibuch 


sndcmd: 


bsr 

w4reqa 

Auf  REQ-Aktivierung  warten 

bpl.s 

gotreq 

7 

REQ  aktiviert? 

moveq 

#-4,  dO 

f 

Nein! 

bra 

error 

t 

Dann  raus  hier! 

gotreq: 

move.b 

(a0)  +,  (a5) 

7 

Command-Byte  auf  SCSI-Bus  legen. 

bset 

#4,2 (a5) 

7 

ACK  aktivieren  (Bit  4  in  s  icr) 

bsr 

w4reqd 

/ 

Auf  REQ~Deaktivierung  warten 

bpl.s 

nxtbyte 

/ 

REQ  wieder  deaktiviert? 

moveq 

#-5,d0 

/ 

Nein! 

bra 

error 

/ 

Dann  raus  hier! 

nxtbyte : 

bclr.b 

#4,2 (a5) 

f 

Target  hat  Byte!  _ACK 

r 

deaktivieren! 

dbra 

dl , sndcmd 

7 

Schleife,  bis  alle  Bytes  raus 

7 

sind! 

move .  b 

#0,2 (a5) 

7 

Initiator  deaktiviert  alle  Ltg. 

t 

Command- 

-Descriptor-Block  wurde  erfolgreich  ubertragen! 

;  Jetzt  wird  auf  DMA-Betrieb  geschaltet,  und  das  Target 

;  ubernimmt  die  Steuerung  der  DATA  IN-Phase. 

/ 

move . b 

#l,6(a5) 

r 

"Assert  _I/0"  in  s_tcr  (DATA  IN!) 

tst  .b 

14 <a5) 

f 

RESET  Int . +Parity-Fehler 

/ 

(s  inircv) 

move .b 

#2,4 (a5) 

/ 

"DMA-Mode"  in  s_mode  einstellen 

move.w 

#2,tt_dmactl 

/ 

DMA-Baustein  freigeben  (DMA 

/ 

Enable) 

move .  b 

#0,14(a5) 

/ 

Start  Initiator-DMA-Eingabe ! 

Nun  mussen  wir  uns  in  Geduld  fassen,  bis  die  DMA-Phase 
beendet  ist.  Dazu  wird  gewartet,  bis  der  5380  einen  IRQ  an 
den  TT-MFP  gibt.  Da  alle  anderen  Interrupts  des  5380  ausge- 
schaltet  sind,  kann  es  sich  bei  einem  5380-Interrupt  nur  um 
die  "Fertigmeldung"  des  5380  handeln! 

move.l  (a4),d7  ;  Akt.  Sys-Timerwert  holen  und  End- 

addi.l  #lang,d7  ;  wert  berechnen  (steht  in  d7) 
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wait4int: 

btst  #7 ,  GPIP  TT 


bne.s 

scsint 

btst 

#5,GPIP_TT 

beq.s 

dmaint 

cmp.  1 

(a4)  ,d7 

bcc.s 

wait4 int 

moveq 

#-6,d0 

bra 

error 

dmaint : 

btst 

#7 , tt_dmactl+l 

beq.s 

wait 4 int 

moveq 

#-7,d0 

bra 

error 

scsint: 

tst.b 

14 (a5) 

moveq. 1 

#0,d0 

move . w 

dO,tt_dmactl 

move.b 

dO, 4 (a5) 

move.b 

d0,2 (a5) 

t 

Jetzt  wird  das  Statusbyte 

;  Da  evtl 

ein  MESSAGE-Byte 

;  MESSAGE 

IN-Phase  gewartet 

t 

move . 1 

(a4)fd7 

addi . 1 

#kurz, d7 

move.b 

#3, 6 (a5) 

bsr 

w4reqa 

bpl.s 

getstat 

moveq 

#-8,d0 

bra 

error 

get st at : 

move . b 

(a5) ,d0 

bset 

#4,2 (a5) 

;  Auf  Int.  vom  5380  Oder  DMA- 
;  Baustein 

;  warten.  Dabei  Ze it limit  im  Auge 
;  behalten! 


;  Zeituberschreitung !  Raus  hier! 

;  Bus  error-Bit  testen ! 

;  Bus  error  bei  DMA  aufgetreten? 


;  DMA-Baustein  ausschalten 
■  ;  5380  aus  DMA-Betrieb  holen 
;  (s_mode) 

;  Alle  SCSI-Ltg.  deaktivieren 
;  (s__icr) 

vom  Target  geholt. 

folgt,  wird  anschlieBend  auf  die 

und  das  MESSAGE-Byte  eingelesen! 

;  Akt.  Sys-Timerwert  holen  und  End- 
;  wert  berechnen  (steht  in  d7) 

;  _C/D  +  _I/0  aktivieren  (s_tcr) 

;  __REQ  vom  Target  abwarten 
;  _REQ  aktiviert? 

;  Nein! 

;  Dann  raus  hier! 


;  Statusbyte  (s_data)  nach  dO 
;  holen. 

;  ACK  aktivieren  (s  icr)  . 


;  Ja!  Dann  aber  raus  hier! 

;  RESET  Int . +Parity-Fehler 
;  (s  inircv) 
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bsr 

w4reqd 

REQ-Deaktivierung  abwarten 

bpl.s 

getmsg 

REQ  deaktiviert? 

moveq 

#-9,  dO 

Nein! 

bra 

error 

Dann  raus  hier! 

/ 

/ 

Jetzt  wird  auf  die  MESSAGE 

IN-Phase  gewartet  und  das 

t 

MESSAGE-Byte  eingelesen! 

r 

getmsg : 

move.b 

#0,2 (a5) 

Alle  Initiatorltg.  deaktivieren 

move.b 

#7,  6 (a5) 

MSG,  C/D  und  I/O  sind  bei 

w4msg: 

btst 

#3,  8 (a5) 

der  MESSAGE  IN-Phase  aktiviert ! 

bne.  s 

msg  in 

MESSAGE  IN-Phase  erreicht? 

cmp.  1 

(a4) ,d7 

Noch  nicht !  Zeituberwachung ! 

bcc.s 

w4msg 

Zeituberschreitung? 

moveq 

#-10, dO 

Ja! 

bra 

error 

Dann  raus  hier! 

msg_ 

in: 

bsr 

w4reqa 

_REQ-Aktivierung  testen 

bpl .  s 

hole  msg 

REQ  aktiviert? 

moveq 

#-11, dO 

Nein! 

bra 

error 

Dann  raus  hier! 

hole_msg : 

swap 

dO 

Statusbyte  ins  High-Word  swappen 

move.b 

(a5)  ,d0 

MESSAGE-Byte  ins  Low-Word  holen 

swap 

dO 

Statusbyte  wieder  ins  Low-Word 

bset 

#4, 2 (a5) 

ACK  aktivieren  (s  icr) . 

bsr 

w4reqd 

Warten,  bis  REQ  deaktiviert  ist 

bpl .  s 

das_wars 

_REQ  deaktiviert? 

moveq 

#-12,  dO 

Nein! 

bra 

error 

Dann  raus  hier! 

das_ 

wars : 

move.b 

#0,2 (a5) 

Initiator  deaktiviert  alle  Ltg. 

Wenn  der  DMA-Transfer  nicht  auf  einer  Long-Grenze  endete, 
befinden  sich  im  DMA-Restdatenreg.  noch  ein  paar  Bytes,  die 
"von  Hand"  in  den  Bufferspeicher  gebracht  werden  miissen! 
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ende: 


movep . 1 

(a6) ,dl 

r 

Aktuell.  DMA-Adr . -Ptr .  holen 

move . 1 

dl,d2 

t 

Kopie  davon  in  d2 

andi.w 

#3,d2 

r 

Anzahl  Bytes  im  Restdatenregister 

beq.s 

ende 

r 

Keine  (Transf.  auf  Long-Grenze) ? 

subq.w 

#l,d2 

f 

Docb!  Einen  weniger  wg.  Schleife! 

andi .b 

#$FC, dl 

t 

Letzte  Long-Grenze  ansteuern. 

move . 1 

dl,aO 

T 

Zielpointer  in  aO 

lea 

tt  dmarsd, al 

f 

Quellptr.  (Restreg.)  nach  al 

oop: 

move . b 

(al) +, (a0)+ 

f 

Restliche  Bytes  aus  Restdatenreg . 

dbra 

d2, restloop 

r 

in  den  Buffer  ubertragen. 

bra 

ende 

s:  cuo-ciauDou-icy  ; 

Bei  irgendeinem  Fehler  wird 

zur  Sicherheit  ein  RESET  auf 

dem  SCSI 

-Bus  ausgefiihrt! 

move . 1 

(a4),d7 

t 

Akt.  Sys-Timerwert  holen  und  End- 

addi.l 

#kurz,d7 

/ 

wert  berechnen  (steht  in  d7) 

move . b 

#$80,2 (a5) 

t 

RST-Ltg.  aktivieren 

cmp.l 

(a4) ,d7 

f 

Timerende  testen 

bcc.  s 

waitl 

r 

Timer  abgelaufen? 

move.b 

#0, 2  (a5) 

r 

Ja!  Dann  RST-Ltg.  deaktivieren 

move . 1 

(a4) ,d7 

r 

Akt.  Sys-Timerwert  holen  und  End- 

addi . 1 

#kurz,d7 

r 

wert  berechnen  (steht  in  d7) 

cmp.l 

<a4) ,d7 

r 

Timerende  testen 

bcc.s 

wait  2 

i 

Timer  abgelaufen? 

rts 

; -  Unterprogramm:  Warten  auf  die  Aktivierung  von  _REQ - 


In:  d7 . 1  = 

a4 .1  = 
Out :  dO  = 


Timerendwert 
Pointer  auf  _hz_200 
0  :  Alles  klar!  _REQ  ist  aktiviert 

-1  :  Zeituberschreitung 
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w4reqa : 


moveq 

#0,  dO 

btst 

#5,  8  (a5) 

bne.s 

gtrqend 

cmp.  1 

(a4) ,  d7 

bcc.  s 

w4reqa 

bra.  s 

gtrqerr 

;  Default  ist  kein  Timeout ! 

;  _KEQ-Ltg.  uberwachen. 

;  _REQ  vom  Target  aktiviert? 
■r  Nein!  Zeituberwachung! 

;  Zeituberschreitung? 


. -  Unterprogramm:  Warten  auf  die  Deaktivierung  von  _REQ  — 


In :  d7 . 1  =  Timerendwert 


r 

a4 . 1 

=  Pointer  auf  hz  200 

r 

Out:  dO 

=  0 

Alles  klar!  REQ  ist  aktiviert 

r 

-1 

Zeituberschreitung 

w4reqd: 

moveq 

#0,d0 

;  Default  ist  kein  Timeout ! 

btst 

#5,  8  <a5) 

;  REQ-Ltg .  uberwachen . 

beq.  s 

gtrqend 

;  _REQ  vom  Target  deaktiviert? 

cmp.l 

<a4) ,d7 

;  Nein!  Zeituberwachung! 

bcc.s 

w4reqd 

;  Zeituberschreitung? 

gtrqerr: 

moveq 

#-l,d0 

;  Ja!  Mit  -1  in  dO  raus 

gtrqend : 
rts 


.data 

/ 

; - Hier  folgt  der  komplette  Command-Descriptor-Block  (6-Byte-CDB) 


cmdtable: 

dc.b 

$12 

;  Inqiry-Befehl 

dc.b 

$00 

;  LUN  =  0 

dc.b 

$00 

dc.b 

$00 

;  Reserved  Bytes 

dc.b 

trlength 

;  max.  Transferlange 

dc.b 

$00 

;  Kein  Linked  Command! 

.bss 

; -  In  den  folgenden  Puffer  werden  die  INQUIRY-Daten  eingelesen 

buffer: 

ds.w 


$100 


;  256-Bytes  Puffer  reicht  aus! 
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Kapitel  7:  Seriell,  aber  schnell!  - 
Der  SCC  macht’s  moglich 

Im  Zeitalter  der  schnellen  Kommunikation  wollte  wohl  auch  ATARI  seine  neuen  Maschinen 
(TT  und  MEGA  STE)  bei  den  Kommunikationsschnittstellen  etwas  aufwerten.  So  findet  sich 
dann  auch  im  TT  (und  MEGA  STE)  ein  eigener  Schnittstellen-Steuerbaustein  vom  Typ  85C30 
wieder.  Dieser  Serial  Communications  Controller  (kurz  SCC)  ubemimmt  eine  ganze  Menge 
Steuerungsaufgaben,  wenn  es  um  den  Austausch  von  seriellen  Daten  geht. 

Der  SCC  besitzt  zwei  voneinander  unabhangige  duplexfahige  Kanale,  die  im  TT  sogar  durch 
einen  eigenen  DMA-Chipsatz  (gleiche  Bausteine  wie  beim  SCSI-DMA-Chipsatz)  fur  schnel¬ 
len  Datentransfer  unterstiitzt  werden.  Die  beiden  Kanale  erlauben  die  Realisierung  von 
Multiprotokoll-Schnittstellen  fiir  die  gangigsten  Datentibertragungsteuerungsverfahren. 

Dabei  besitzt  der  SCC  fiir  jeden  Kanal  einen  eigenen  Baudratengenerator,  mit  dem  im  asyn- 
chronen  Start/Stop-Betriebbis  zu  250  KBit/s  moglich  sind  (imTT  nur  125  KBit/s!).  Im  Start/ 
Stop-Verfahren  konnen  5. .8  Bit-Zeichen  mit  1/1 ,5  oder  zwei  Stop-Bits  und  optionaler  Erzeu- 
gung/Auswertung  eines  Paritatsbits  verwendet  werden. 

Im  Synchronbetrieb  (verbundene  Computer  sind  durch  Mitilbertragung  der  Taktsignale 
immer  bitsynchron!)  erlaubt  der  SCC  DU-Raten  bis  zu  4  MBit/s,  wobei  aber  durch  einen 
PrimMrtakt  PCLK  im  TT  von  8  MHZ  “nur”  maximal  2  MBit/s  erreichbar  sind.  Wenn  im  Syn¬ 
chronbetrieb  die  Taktsignale  nicht  mitiibertragen  werden,  kann  der  SCC  durch  eine  Digital 
Phase  Locked  Loop-Einheit  (DPLL)  aus  den  Datenflanken  der  empfangenen  Bits  den  Takt  re- 
konstruieren  und  damit  die  einlaufenden  Daten  abtasten  als  auch  diesen  Takt  fiir  das  Aussen- 
den  der  eigenen  Sendedaten  verwenden.  Dazu  braucht  der  DPLL  einen  Takt,  der  bei  der  16fa- 
chen  bzw.  32fachen  Baudrate  der  Empfangsdaten  liegt.  Im  TT  liegt  die  realisierbare  DU-Rate 
wegen  der  hdchstmoglichen  Taktfrequenz  fiir  den  SCC  von  8  MHz  bei  max  1 25  KBit/s. 


Vom  SCC  unterstiitzte  Datenubermittlungs- 
Steuerungsverfahren 

Diese  Steuerungsverfahren  regeln  unter  anderem  die  Organisation  des  Datenflusses  wahrend 
der  Datenaustausch-Phase.  Da  es  hierbei  unter  anderem  zur  Blockbildung  der  zu  iibermitteln- 
den  Daten  kommt  und  Sicherungsinformationen  zur  Fehlererkennung  durch  die  Gegen- 
station  eingefiigt  werden,  kann  ein  Teil  dieser  Aktionen  durch  den  Schnittstellenbaustein  des 
Computers  erledigt  werden. 
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Asynchrone  Steuerungsverfahren 

Das  am  haufigsten  verwendete  asynchrone  Steuerungsverfahren  ist  das  Start/Stop-Verfahren. 
Dabei  wird  jedes  Zeichen  (beim  SCC  5.. 8  Bit  plus  evtl.  Paritatsbit)  als  eine  Einheit  (Block) 
betrachtet.  Zwischen  den  einzelnen  iibermittelten  Zeichen  konnen  unterschiedlich  lange 
Ruhepausen  auftreten. 


- Ein  Zeichen  - ► 

_  DRTR  +  Parity  ST 

3P  ff  ff 

It  II 

STRRT 

Abb.  7.1:  Das  Start-IStop-Verfahren 


Im  Ruhezustand  befindet  sich  die  Sendedatenleitung  auf  log.  1 .  Sobald  ein  Zeichen  gesendet 
werden  soli,  wird  fiir  eine  vereinbarte  Zeit  (Einheitsschrittdauer.  Anzahl  der  Einheitsschritte 
je  Sekunde  ergibt  die  Baudrate!)  eine  log.  0  ausgegeben.  Auf  diesen  Startschritt  folgen  dann 
die  eigentlichen  Informationsschritte  eines  Zeichens  plus  evtl.  einer  Paritatsinformation  (da 
hier  ausschlieBlich  Signale  mit  zwei  Kennzustanden,  log.  1  und  log.  0,  betrachtet  werden, 
kann  man  auch  fiir  Schritt  gleich  Bit  setzen ! ) .  Die  Abtastung  der  Empfangsdatenleitung  erfolgt 
sinnvollerweise  jeweils  in  Bitmitte.  Dazu  erzeugt  sich  der  Empfanger  Abtastsignale  aus  einer 
eigenen  Taktquelle,  die  ein  Vielfaches  der  Datenubertragungsrate  betragt  (meistens  16fache 
Datenrate).  Die  Abtastung  wird  jeweils  durch  den  Startschritt  neu  gestartet! 

Nach  Ubermittlung  aller  Datenbits  eines  Zeichens  geht  die  Sendedatenleitungen  fiir  eine 
vereinbarte  Mindestdauer  wieder  in  den  Ruhezustand  log.  1 ,  bevor  das  nachste  Zeichen  ( wie- 
der  mit  einem  Startbit  beginnend)  ausgesendet  werden  darf.  Diese  Mindestdauer  fiir  den  Ruhe¬ 
zustand  zwischen  zwei  Zeichen  (in  Bitlangen  ausgedriickt)  betragt  mindestens  1  Stopbit.  Der 
SCC  kann  auf  1,  1,5  oder  2  Stopbits  eingestellt  werden. 


Synchrone  Steuerungsverfahren 

Bei  der  Verwendung  von  Steuerungsverfahren  fiir  synchrone  Ubertragung  ist  gewahrleistet, 
dalj  Taktinformationen  zusammen  mit  den  Daten  iibermittelt  werden  oder  daB  bei  Verwen¬ 
dung  von  Modemverfahren  zur  Dateniibermittlung  der  Takt  im  Modu  IationsprozeB  mit 
“eingepackt”  wird.  So  kann  also  davon  ausgegangen  werden,  daB  B itsynchronismus  zwischen 


Seriell,  aber  schneil!  -  Der  SCC  macht’s  moglich 
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den  beteiligten  Endstellen  besteht.  Der  Empfanger  kann  anhand  des  mitgelieferten  Takts  die 
sichere  Abtastung  der  Bitinformation  vomehmen. 

Wenn  die  Bitsynchronitat  besteht,  muB  in  der  nachsten  Phase  der  Zeichensynchronismus 
hergestellt  werden.  Das  heiBt,  daB  der  Empfanger  herausfinden  muB,  wie  die  einzelnen  emp- 
fangenen  Bits  zu  Gruppen  (Zeichen)  zusammenzufassen  sind.  Dazu  hat  der  Empfanger  den 
einlaufenden  Bitstrom  auf  charakteristische  Synchronisierzeichen  zu  untersuchen. 


Zeichenorientierte  Steuerungsverfahren 

Hierbei  werden  Daten  in  Zeichenblocken  (iiblicherweise  Textinformation)  zusammengefaBt 
und  iibertragen.JederTextblockwird  durch  ein  oder  mehrere  8  oder  16  Bit-Synchronzeichen 
eingeleitet.  “Umrahmf  ’  sind  Textblocke  durch  Steuerzeichen,  welche  den  Beginn  (STX  = 
Start  of  Text)  und  das  Ende  (ETX  =  End  of  Text)  des  Informationsblocks  kenntlich  machen. 

Meistens  werden  die  iibermittelten  Blocke  noch  um  Priifzeichen  erganzt,  die  durch  spezielle 
Sicherungsverfahren  gebildet  werden,  Anhand  dieser  Priifzeichen  und  einer  auf  gleiche  Weise 
im  Empfanger  durchgefiihrten  Prufung  konnen  Fehler  in  der  Ubertragung  erkannt  und  eine 
Blockwiederholung  veranlaBt  werden.  Dabei  wird  sowohl  das  Langsparitatsverfahren  (iiber 


s 

S 

S 

Y 

Y 

o 

H 

Kopf in- 
for nation 


Text  oder 
TentteiL 


E 

DCS 

T 

od. 

X 

BCC 

BISVNC-Fornat  (BSC-Fornat) 


SYHC 

16  Bi  t 


Data 


CRC 


HDHOSVHC-Fornat 


Abb.  7.2:  Zeichenorientierte  Steuerungsverfahren 
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alle  Bits  gleicher  Wertigkeiteines  Textblocks  wird  jeweils  ein  Paritatsbit  gebildet  und  die  Zu- 
sammenfassung  alter  so  gewonnenen  Paritatsbits  als  Blockpriifzeichen  mitiibertragen)  als 
auch  das  CRC-Verfahren  verwendet  (“Berechnung”  einer  16-Bit-Priifbitfolge  aus  alien  Bits 
des  Textblocks  und  Anhangen  an  den  Datenblock  in  Form  von  zwei  8  Bit-Zeichen).  Der  SCC 
kann  die  Priifzeichen  nach  dem  CRC-Verfahren  nach  zwei  verschiedenen  “Berechnungsregeln” 
(CRC-16  und  CRC-CCITT)  ermitteln  und  auswerten. 

Zeichenorientierte  Steuerungsverfahren  arbeiten  vom  Prinzip  her  nur  halbduplex,  auch  wenn 
die  Ubertragungsstrecke  und  die  beteiligten  Datenstationen  duplexfahig  sind.  Es  ist  namlich 
jeweils  nach  Aussenden  eines  Textblocks  eine  Quittung  von  der  Gegenstelle  erforderlich, 
bevor  der  nachste  Block  gesendet  wird.  Eine  weitere  Einschrankung  besteht  darin,  da(.i 
tiblicherweise  eine  Codebindung  besteht.  AuBerdem  werden  sowohl  die  Textinformationen 
als  auch  die  Steuerzeichen  aus  dem  gleichen  Code  benutzt,  so  daB  normalerweise  im  Text  kei- 
ne  Steuerzeichen  vorkommen  diirfen!  Es  gibt  allerdings  Ausnahmen,  indem  durch  ein  speziel- 
ies  Zeichen  (als  Data  Link  Escape  =  DLE  bezeichnet)  die  Steuerzeichen  als  solche  kenntlich 
gemacht  werden. 


Bitorientierte  Steuerungsverfahren 

Auch  hier  werden  die  Daten  zu  Blocks  zusammengefaBt.  Dabei  ist  aberkeinerlei  Bindung  an 
einen  bestimmten  Code  erforderlich,  sondem  es  wird  mit  Bitblocken  gearbeitet.  Die  weitver- 
breiteten  Steuerungsverfahren  SDLC/HDLC  (SDLC  =  Synchronous  Data  Link  Control  von 
IB  M/  HDLC = High-Level  Data  Link  Control,  vom  CCITT  empfohlen)  verwenden  zum  Infor- 
mationsaustausch  einen  standardisierten  Blockaufbau,  den  Frame.  Die  Unterschiede  zwi- 
schen  SDLC  und  HDLC  sind  von  geringer  Natur  und  bestehen  aus  Abweichungen  in  der  Be- 
handlung  einiger  Bits  im  Adress-  und  Control-Feld. 


F  n  an  n 

n  n  ariL  —  ► 

Flag 

n 

Hdr 

Ctrl. 

Datenfeld  nit 

CRC 

Flag 

Feld 

Feld 

beliebiger  ZahL 

S  Bit 

8  Bit 

von  Datenblts 

16  Bit 

8  Bit 

SDLC/HDLC-Fornat 


Abb.  7.3:  Bitorientierte  Steuerungsverfahren 
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Der  Unterschied  eines  Steuer-/Meldeframes  zu  einem  Informationsframe  besteht  lediglich 
darin,  daft  Steuer-  und  Meldeframes  kein  Datenfeld  beinhalten. 

Jeder  Frame  beginnt  mit  einem  FLAG.  Dafiir  wird  die  8-Bitfolge  0 1 1 1 1 1 1 0bta  =  7Ehw  verwen- 
det.  Der  Empfanger  “rastet”  seine  Synchronisierung  auf  diese  Bitfolge  ein.  Da  ja  alle  Bitmu- 
ster  bei  diesem  Verfahren  z.  B.  auch  im  Datenfeld  verwendet  werden  diirfen,  muft  der  Sender 
dafiir  sorgen,  daft  die  FLAG-Sequenz  nicht  im  eigentlichen  Datenstrom  auftaucht.  Vom  Sen¬ 
der  wird  daher  immer  nach  fiinf  “1”-Bits  automatisch  ein  “0”-Bit  in  den  Datenstrom  eingefiigt 
(aufter  beim  FLAG!).  Der  Empfanger  muB  dann  zwischen  dem  Start-FLAG  und  dem  End- 
FLAG  eines  Frames  diese  “0”-Bits  wieder  entfemen. 

Bei  SDLC/HDLC  wird  zurBlocksicherung  das  CRC- Verfahren  angewendetunddie  “berech- 
nete”  CRC -Bitfolge  in  Form  von  16-Bits  unmittelbar  vor  dem  End-FLAG  mitubertragen. 

Mit  SDLC/HDLC-Steuerungsverfahren  ist  Duplexbetrieb  moglich.  Informationsfirames  ent- 
halten  im  Control-Feld  Zahlerwerte,  mit  denen  die  Gegenstelle  A  ihrem  Gegeniiber  B  mitteilt, 
welche  Nummer  der  gerade  ubermittelte  Frame  besitzt.  Des  weiteren  wird  von  Station  A  durch 
eine  Framenummer  im  Control-Feld  der  Station  B  iibermittelt,  bis  zu  welcher  Nummer  die 
Station  A  die  von  B  gesendeten  Frames  bereits  empfangen  und  verarbeitet  hat.  Das  bedeutet, 
daB  mit  dem  Aussenden  eines  Informationsfirames  gleichzeitig  eine  Bestatigung  der  bereits 
von  der  Gegenstelle  empfangenen  Frames  erfolgen  kann. 

Das  AdreBfeld  bei  SDLC/HDLC  kann  benutzt  werden,  urn  in  Mehrpunktverbindungen,  die 
gewiinschteZielstation  zu  adressieren.  Aber  auch  bei  Punkt-zu-Punkt-Verbindungen  werden 
Adressen  verwendet.  Jede  Station  versendet  Informations-  und  Steuerfir  ames  mit  der  Zieladresse 
im  AdreBfeld.  Meldungen/Quittungen  werden  mit  der  eigenen  (Absende-)Adresse  versehen. 


Codierungsverfahren  fiir  Datensignale 

Wenn  Datensignale  nicht  mittels  MODEM-Verfahren  auf  Ubertragungswegen  iibermittelt 
werden  sollen,  sondem  im  sogenannten  Basisbandverfahren  (Basisband  deshalb,  weil  keine 
Umsetzung  der  Datensignale  in  einen  anderen  Frequenzbereich  erfolgt!)  auf  die  Leitung 
gelangen,  werden  unterschiedliche  Methoden  verwendet,  um  das  Signal  z.  B.  moglichst  frei 
vonGleichstromkomponenten  (sonstbekommtman  die  Signale  so  schlechtdurchUbertrager!) 
zu  halten.  Einige  dieser  Verfahren  codieren  die  Daten  so  um,  daB  sich  rnoglichst  viele 
Zustandswechsel  ergeben.  Damit  laBt  sich  dann  einfacher  aus  diesem  Datenstrom  wieder  die 
Taktinformation  zuruckgewinnen! 


Die  Umcodierung  kann  sowohl  in  Software  realisiert  als  auch  (wie  beim  SCC)  durch  Hardware 
erledigt  werden. 
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NRZ-Verfahren 

Aon  Return  to  Zero.  Hier  erfolgt  eigentlich  keine  weitere  Umcodierung. 

Alle  Daten  werden  durch  ihre  entsprechenden  log.  Zustande  dargestellt.  Um  einen  moglichst 
geringen  Gleichanteil  zu  haben,  wird  z.  B.  die  log.  1  dutch  eine  positive  Spannung  und  die 
log.  0  durch  eine  negative  Spannung  bezogen  auf  Masse  dargestellt. 

Bei  langeren  Null-  oder  Eins-Folgen  ist  eine  Taktriickgewinnung  aus  dem  Datenstrom  kaum 
sicher  moglich. 


NRZI-Verfahren 

Non  Return  to  Zero  -  Inverted.  Bei  jedem  Null-Bit  wird  ein  Zustandswechsel  durchgefiihrt! 
Damit  ist  auch  gewahrleistet,  das  bei  langeren  Null-Folgen  Zustandswechsel  auftauchen. 
Normalerweise  kann  auch  aus  diesem  umcodierten  Signal  nicht  besonders  effizient  die 
Taktinformation  zuriickgewonnen  werden  (z.  B.  bei  langeren  Eins-Folgen!). 

Da  aber  bei  SDLC/HDLC  ja  durch  die  “Zero  bit  insertion”  nach  spatestens  fiinf  Eins-Bits  eine 
Null  eingefugt  wird,  hat  man  doch  noch  eine  einigermafien  “wechselhafte”  Bitfolge  vor  sich. 


Biphase  Mark-Verfahren  oder  FMl-Verfahren 

Bei  dieser  Umcodierung  wird  an  jeder  Datenbitgrenze  ein  Zustandswechsel  durchgefiihrt.  Hat 
das  darzustellendeDatenbit  den  Wert  Eins,  so  wirdinBitmitteeinzusatzlicher  Zustandswechsel 
durchgefiilirt.  Dieses  Umcodierungsverfahren  stellt  ausreichend  Zustandswechsel  zur  Takt- 
riickgewinnung  bereit. 


Biphase  Space- Verfahren  oder  FMO-Verfahren 

Hierbei  handelt  es  sich  lediglich  um  eine  Umkehrung  des  vorgenannten  Verfahrens.  Also  bei 
Null-Bits  wird  in  der  Bitmitte  ein  zusatzlicher  Zustandswechsel  ausgefiihrt. 


Manchester-Codierung 

Hierbei  wird  in  Bitmitte  immer  ein  Zustandswechsel  durchgefiihrt.  Die  Richtung  des  Zu- 
standswechsels  gibt  dabei  den  Datenbit-Wert  an! 


Seriell,  aber  schnell!  -  Der  SCC  macht’s  moglich 
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Abb.  7.4:  Daten-Umcodierungsverfahren 


Der  SCC 

Um  all  die  geschilderten  Gleichlaufverfahren  (Asynchron/Synchronbetrieb),  Umcodierungs- 
und  DU-Steuerungsverfahren  abwickeln  zu  konnen,  besitzt  der  SCC  einen  komplexen 
Aufbau. 

Zwei  voneinander  unabhangige  Kommunikationskanale  existieren  im  S  CC.  Im  TT  kann  dabei 
der  SCC-Kanal  A  zwischen  einem  8pol.  Miniatur-D1N-Netzwerkanschlu6  mit  elektrischen 
Werten  entsprechend  RS422  (als  LAN  bezeichnet)  und  einem  9pol.  SubD-Anschlufi  (als 
SERIAL  2  bezeichnet)  mit  elektrischen  Werten  nach  RS232C  umgeschaltet  werden. 

Die  Umschaltung  erfolgt  durch  den  IOA7-Port  (Pin  14)  des  Soundchips  (Low  -  LAN  /  High 
=  SERIAL  2).  Als  Taktquelle  fiir  Kanal  A  des  SCC  kann  sowohl  der  PCLK  mit  8  MHz 
verwendet  werden  (maximale  Datenrate  125  KBit/s)  als  auchein  3,672  MHz-Takt  von  einem 
eigenen  Oszillator  (maximale  Datenrate  ca.  230  KBit/s).  AuSerdem  laftt  sich  bei  LAN-Be- 
trieb  ein  ext.  Takt  aus  dem  LAN  verwenden. 

Der  Kanal  B  kann  im  TT/MEGA  STE  als  RS232C-Schnittstelle  fiir  unterschiedliche,  max. 
Datenraten  programmiert  werden.  Wird  der  PCLK-Takt  von  8  MHz  als  Ausgangstakt  verwen¬ 
det,  konnen  bis  zu  125  KBit/s  erreicht  werden.  Wenn  als  Taktquelle  der  2,4576  MHz-Takt 
der  MFPs  benutzt  wird,  geht  die  maximale  Datenrate  bis  maximal  153600  Bit/s.  Auch  der 
Ausgang  des  Timers  C  des  ST-MFP  kann  als  Taktquelle  verwendet  werden.  Dann  reduziert 
sich  die  maximale  Datenrate  auf  19200  Bit/s. 
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Abb.  7.5:  Block-Diagramm  des  SCC 


Die  zuvor  genannten  Datenraten  gelten  fur  eine  Betriebsweise  mit  einer  Art  Vorteiler  durch 
16,  um  bei  Start/Stop-Betrieb  eine  stabile  Abtastung  in  Bitmitte  erreichen  zu  konnen. 

Im  Synchronbetrieb,  wenn  ein  zu  den  Daten  passendes  Taktsignal  vorliegt,  lassen  sich  natiir- 
lich  Geschwindigkeiten  erreichen,  die  dann  um  den  Faktor  16  (Vorteiler  nicht  erforderlich!) 
hoher  liegen! 

Ein  Blick  ins  Innenleben  des  SCC 

Um  die  verschiedenen  Gleichlauf-  und  DU-Steuerungsverfahren  unterstUtzen  zu  konnen,  ist 
der  SCC  “ein  wenig”  komplexer  aufgebaut  als  z.  B.  ein  MFP  oder  6850!  Auf  alle  Details  des 
SCC  hier  einzugehen  wiirde  den  Rahmen  des  Buches  sprengen  (allein  das  kurzgef  aBte  “Daten- 
blatt”  zum  Z85C30  umfaBt  schon  mehr  als  130  Seiten  komprimierte  Informationen  zu  dem 
Baustein!). 
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Der  EmpfangsteH  des  SCC 

Deshalb  hier  erstmal  eine  Kurzbeschreibung  des  Empfangerteils  im  SCC  (jeder  Kanal  besitzt 
Tiatiirlich  einen  eigenen  Empfangsteil!). 


Abb.  7.6:  Block-Diagramm  des  SCC-Empfangers 


Die  Daten  von  der  Empfangsdatenleitung  gelangen  nach  einer  1  Bit-Verzogerungsstufe  (wird 
im  SDLC -Loop-Mode  benutzt;  dazu  spater  mehr),  abhangig  von  dereingestellten  Betriebsart, 
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in  die  NRZI-Decoderlogik,  das  S  YNC-Empfangsregister  oder  das  Empfangsschieberegister. 
Das  SYNC-Empfangsregister  hat  im  SDLC/HDLC-Betrieb  zudem  die  Aufgabe,  das  vom 
Sender  nach  jeweils  ftinf  Eins-Bits  eingefiigte  Null-Bit  wieder  herauszunehmen. 

Sobald  ein  Zeichen  im  Empfangsschieberegister  “zusammengebaut”  ist,  gelangt  es  in  ein  3- 
By te-Empfangs-FIFO-Buffer.  Damit  lassen  sich  also  bis  zu  drei  Bytes  zwischenspeichem,  um 
der  CPU  Oder  dem  DMA-Baustein  etwas  “Luft”  fur  das  Auslesen  der  Empfangsdaten  zu 
lassen.  Jedes  Auslesen  liefert  immer  das  “oberste”  Zeichen  des  FIFO-Buffers  und  bewirkt 
nach  dem  Lesezugriff  ein  Nachriicken  der  “darunterliegenden”  Zeichen! 

Jedes  Zeichen,  welches  in  den  3-Byte-FIFO  ubertragen  wird,  enthalt  in  einem  parallel  gefiihr- 
ten  3-Byte-Condition-FIFO-Buffer  eine  Statusinformation  zum  Zeichen.  Also  kann  fur  jedes 
Empfangszeichen  die  zugehOrige  Statusinformation  aus  dem  Condition-FIFO-Buffer  entnom- 
men  werden!  Dabei  sollte  beachtet  werden,  immer  erst  den  Status  zum  Zeichen  auszulesen, 
bevor  das  eigentliche  Zeichen  geholt  wird.  Umgekehrt  bekommt  man  namlich  sonst  evtl.  den 
Status  vom  nachsten,  bereits  “aufgeriickten”  Zeichen! 

Wenn  mit  “Special  Receive  Condition”-Interrupts  gearbeitet  wird,  geschieht  eine  Interrupt- 
anforderung  fur  das  “oberste”  Zeichen  des  FIFO-Buffers  erst  dann,  wenn  das  Zeichen  aus- 
gelesen  wurde!  Beimanchen  Special-Condition-Interrupt-Betriebsweisen  wird  zusiitzlich  der 
gesamte  FIFO-Buffer“eingefroren”.  So  kann  dann  in  “aller  Ruhe”  die  Special  Condition  aus- 
gewertet  werden.  Erst  nach  Ausfiihrung  eines  entsprechenden  ERROR-RESET-Kommandos 
wird  der  FTFO-Buffer  wieder  “aufgetaut”.  Dieses  Verhalten  erscheint  bei  DMA-Betrieb  recht 
sinnvoll,  weil  die  CPU  ja  ohne  Interrupts  nichts  vom  Datentransfer  mitbekommen  wiirde. 

Zusatzlich  zum  3-Byte-Condition-  und  Daten-FIFO-Buffer  wird  fiir  SDLC/HDLC-Betrieb 
noch  ein  lOfach-Frame-Status-FIFO-Buffer  mit  19  Bit  Breite  verwendet.  Hierin  werden, 
ahnlich  dem  3  Byte-Condition-PIFO-Buffer  fiir  Zeichen,  die  Statusinformationen  der  letzten 
zehn  Frames  aufbewahrt.  Ein  14-Bit-Zahler  zahlt  zusatzlich  die  Datenbytes  je  Frame  (bei 
14  Bit  also  maximal  16  KByte  pro  Frame!)  und  legt  diese  Zahlerstande  zusammen  mit  einer 
5-Bit-Statusinformation  in  diesem  Frame-Status-FIFO-Bufferab.  Werden  so  z.  B.  Frames  per 
DMA-Betrieb  im  RAM  abgelegt,  kann  anhand  der  Zahlerstande  nachtraglich  jeder  einzelne 
Framebeginn  im  RAM  ermittelt  und  “defekte”  Frames  ausge”mapped”  werden! 

Ebenfalls  im  Empfangsteil  untergebracht  ist  die  CRC-Priiflogik  (ein  16-Bit-Schieberegister 
mit  entsprechenden  Riickkopplungspunkten).  Je  nach  Betriebsart  laufen  die  Daten  zur  CRC- 
’’Berechnung”  iiber  das  S  YNC-Register  (SDLC-CRC)  oder  das  Empfangsschieberegister  und 
eine  8-Bit-Puffersmfe  (SYNC-CRC)  in  die  Priiflogik  ein. 

Das  Ergebnis  der  Blocksichemng  wird  ebenfalls  durch  die  “Receive-Error-Logic”  ausgewer- 
tet  und  als  Statusinformation  zuganglich  gemacht. 
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Im  Empfangsteil  fmdetsich  auchdie  DPLL-Stufe,  die  aus  den  Flanken  im  Empfangsdatensignal 
einen  Takt  abzuleiten  versucht.  Dabei  kann  der  Quelltakt  far  die  DPLL-Stufe  sowohl  vom 
eingebautenBaudraten-Generator(durch  einen  16-Bit-WertinderAusgangsfrequenzprogram- 
mierbar!)  als  aueh  vom  RTxC-Eingang  gespeist  werden  (Takt  z.  B.  durch  extemen  Oszillator 
erzeugt). 


Der  Sendeteil  des  SCC 

iibemimmt  die  Umsetzung  der  parallel  eingegebenen  Daten  in  einen  seriellen  Datenstrom. 
Dazu  verfiigt  der  Sender  iiber  ein  8-Bit-Sendedatenregister  und  ein  Sendeschieberegister. 
Wenn  synchron  zeichenorientiert  gearbeitet  wird  (z.  B.  Bisync-  oder  Monosync- Verfahren), 
werden  die  entsprechenden  SYNC-Register  bei  der  Bedienung  des  Sendeschieberegisters 
natiirlich  mit  beriicksichtigt. 


Abb  7.7:  Blockdiagramm  des  SCC-Senders 
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Immer  wenn  ein  Zeichen  aus  dem  Sendedatenregister  ins  Sendeschieberegister  iibergeben 
wurde,  wird  durch  ein  entsprechendes  Statusbit  (oder  einen  Interrupt)  signalisiert,  dafi  das  Sen¬ 
dedatenregister  nachgeladen  werden  kann.  Auf  diese  Weise  erfolgt  im  Prinzip  die  Pufferung 
eines  ganzen  Zeichens,  so  dafi  fiir  die  CPU  genug  Zeit  zum  “Nachladen”  bleibt. 

Je  nach  Steuerungsverfahren  gelangen  die  Sendedaten  noch  evtl.  fiber  eine  Stufe  fiir  die  “Zero 
Bit  Insertion”  (bei  SDLC/HDLC-Betrieb)  und  eine  Umcodierstufe.  Aufierdem  wird  bei  Ver- 
wendung  von  Biocksicherungsverfahren  nach  der  CRC-Methode  der  Datenstrom  noch  durch 
die  CRC-Stufe  “geschleust”,  um  die  CRC-Priifsumme  zu  “berechnen”. 


Die  Register  des  SCC 

Fiir  die  Steuerung  des  Z85C30  und  die  Abfrage  von  Statusinformationen  sind  eine  Menge  von 
Registem  vorgesehen.  Zur  Steuerung  existieren  fiir  jeden  Kommunikationskanal  14  Write- 
Register  (konnen  nur  beschrieben  werden).  Fiir  Statusinformationen  und  zum  Auslesen  der 
Daten  existieren  je  Kanal  noch  einmal  zehn  Read-Register!  Aufierdem  haben  beide  Kanale 
noch  gemeinsam  ein  Write-Register  fiir  den  Interrupt- Vektor,  den  der  SCC  erzeugen  kann, 
und  ein  Write-Register  fiir  die  Interrupt-Steuerung.  Ahnliches  gilt  fiir  zwei  Read-Register,  die 
von  beiden  KanSlen  gemeinsam  benutzt  werden. 

Im  TT  (MEGA  STE)  findet  man  fiir  jeden  der  beiden  SCC-Kanale  nun  nicht  jedes  Register 
unter  einer  eigenen  Adresse.  Vielmehr  werden  zur  Ansteuerung  des  SCC  immer  die  beiden 
DMA-Bausteine  “zwischengeschaltet”.  Der  DCU  iibemimmt  die  Umsetzung  des  32-Bit-Da- 
tenbusses  auf  den  8-Bit-Bus  des  SCC.  Der  DMAC  ist  fiir  die  Adressierung  und  die  Erzeugung/ 
Auswertung  der  Control-Signale  zum  SCC  zustandig.  Beide  Bausteine  “spielen  zusammen”, 
wenn  der  SCC  im  DMA-Betrieb  verwendet  wird. 


An  welcher  Stelle  im  Adrefiraum  des  TT/MegaSTE  findet  man  nun  den  SCC  bzw.  seine 
Register? 

Fiir  jeden  SCC-Kanal  existieren  zwei  Adressen,  unter  denen  alle  Register  des  jeweiligen  SCC- 
Kanals  erreicht  werden  konnen. 


Adr.  $(FF)FF  8C81 
Adr.  $(FF)FF  8C83 
Adr.  $(FF)FF  8C85 
Adr.  $(FF)FF  8C87 


Control-Reg.  SCC 
Data-Reg.  SCC 
Control-Reg.  SCC 
Data-Reg.  SCC 


Kanal  A 
Kanal  A 
Kanal  B 
Kanal  A 


Label:  “sccctl  a” 
Label:  “sccdat  a” 
Label:  “sccctl  b” 
Label:  “sccdatb” 


Die  Data-Register  erlauben  mit  einem  Schreibzugriff  direktes  Einschreiben  eines  Bytes  in  den 
Sendebuffer  (Write  Register  8).  Bei  einem  Lesezugriff  erhalt  man  das  Byte  aus  dem  Emp- 
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fangsbuffer  (Read  Register  8).  Also  ist  ein  Zugriff  auf  die  “zeitkritischen  Daten”  ohne  grofle 
Umwege  moglich.  Die  Control-Register  werden  auf  folgende  Weise  in  zwei  Stufen  “bedient”: 

Der  erste  Schreibzugriff  auf  die  Control-Register  “landet”  in  Write  Register  0  des  ent- 
sprechenden  SCC-Kanals  und  wird  zur  Einstellung  der  gewiinschten  Registemummer 
verwendet. 

-  Der  nachste  Zugriff  (Schreiben  oder  Lesen)  auf  das  Control-Register  erreicht  dann  das 
im  ersten  Zugriff  ausgewahlte  Register! 


Write-Register 

Write-Register  0 

(Kommando-Register) 


Mit  diesem  Register  wird  festgelegt,  welches  Register  beim  nachsten  Zugriff  auf  die  gleiche 
Adresse  angesprochen  werden  soli.  Auferdem  konnen  durch  Schreibzugriffe  mit  entspre- 
chenden  Bitkombinationen  z.  B.  die  CRC-Stufen  im  Sende-  und  Empfangsteil  zuriickgesetzt 
werden,  Fehlersignalisierungen  und  “anhangige”  Interrupts  geloscht  werden. 


Die  nachfolgende  Abbildung  zeigt  die  Bitbelegung  des  Registers, 


Null  Code  (NOP) 

Rx  CRC-Check  Reset  — 
Tx  CRC-Gener,  Reset  — 
Tx  Underrun  Reset 

Null  Code  (NOP)  — 

POINT  HIGH 
Reset  Ext./Status  Int.  — 
Send  abort  (SDLC/HDLC) 
Enbl.Int.on  next  Rx  Char 
Reset  TxINT  Pending  - — 
Error  Reset  — 

Reset  highest  IUS-Bit  — 


0  0 
0  1 
1  0 
1  1 


4  3 


0  0  0 
0  0  1 


1  0 
1  1 
0  0 
0  1 
1  0 
1  1 


0  0  0 
0  0  1 
0  10 
Oil 
10  0 
10  1 
110 


111 


-Reg.  0(8) 
-Reg.  1(9) 
-Reg.  2  (10) 
-Reg.  3  (11) 
-Reg.  4  (12) 
-Reg.  5  (13) 
-Reg.  6  (14) 
-Reg.  7  (15) 


Werte  in  Klammern  gelten  dam,  wenn  das  POINT  HIGH-Kommando  in  den  Bits  5.3  ein- 
gestellt  ist! 
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Null  Code 


Rx-CRC  Check  Reset 


Tx  CRC-Generator  Reset 


Tx  Underrun  Reset/EOM 


Diese  Einstellung  bewirkt  keinerlei  Anderung  im 
SCC  und  wird  verwendet,  wenn  bei  einem  Zugriff  auf 
das  Write-Register  0  lediglich  eingestellt  werden 
soli,  welches  Write-Register  beim  nachsten  Zugriff 
adressiert  werden  soli. 

Dieses  Kommando  wird  verwendet,  um  den  CRC- 
Priifer  im  Empfanger  zuriickzusetzen.  Der  Program- 
mierer  braucht  dies  nur  dann  “von  Hand”  zu  machen, 
wennim  zeichenorientierten  Synchronbetrieb  (Bisync 
oderMonosync-Betrieb)zwischenempfangenenText- 
blocken  der  Empfanger  nicht  so  wieso  wieder  auf  den 
“Hunt  mode”  (Suchen  nach  SYNC-Zeichen)  einge¬ 
stellt  wurde. 

Im  SDLC/HDLC-Modus  wird  der  CRC-Priifer  bei 
Erkennen  eines  Flags  automatisch  zuriickgesetzt, 
ebenso  bei  “Abschalten”  (disablen)  des  Empfangers. 

Durch  dieses  Kommando  wird  im  Sender  der  CRC- 
Generator  initialisiert.  Das  passiert  iiblicherweise 
wiihrend  der  Initialisierung  des  SCC  Oder  nachdem 
die  CRC-Daten  fiir  einen  Datenblock  ausgesendet 
wurden. 

Latch  Reset  Mit  diesem  Kommando  wird  das  Aussenden  der 
CRC-Information  zum  Ende  eines  Datenblocks  (EOM 
=  End  of  Message)  gesteuert. 

Wenn  durch  dieses  Kommando  das  EOM-Flag  zu- 
riickgesetzt  wurde,  wird  automatisch  bei  Auftreten 
der  Tx  Underrun-Bedingung  (Keine  Daten  mehr  zum 
Aussenden  da,  weil  anscheinend  alles  ausgesendet 
wurde!)  die  CRC-Prufinformation  ausgesendet!  Mit 
dem  Aussenden  der  CRC-Information  wird  dann  das 
EOM-Flag  gesetzt! 

Dieses  Kommando  kann  jederzeit  wahrend  des 
Aussendens  eines  Blocks  gegeben  werden.  Bei  aus- 
geschaltetem  Sender  erfolgt  durch  dieses  Kommando 
kein  Riicksetzen  des  EOM-Flags. 


Seriell,  aber  schnell!  -  Der  SCC  macht’s  moglich 


1149 


POINT  HIGH  Wenn  dieses  Kommando  gesetzt  wird,  wirkt  sich  das 

ineiner  Addition  von  8  zum  WertderRegistemummer 
in  den  Bits  0..2  aus.  Damit  ist  dann  auch  eine  Adres- 
sierung  der  Register  8..  15  moglich. 

Reset  External  /Status  Interrupts  Wenn  eine  Steuerleitung  (CTS,  DCD)  sich  geandert 

hat,  wird  dies  in  einem  entspreehenden  Statusbit  “ge- 
merkt”.  Gleiches  gilt  fur  spezielle  Zustande  wie  z.  B. 
“Break  detect”  (im  Asynchronveifahren  wird  eine 
Dauer-Null-Bitfolge  empfangen). 

Im  SDLC/HDLC-Modus  ist  eine  Sendeabbruch-Fol- 
ge  mit  mehr  als  sieben  Eins-Bits  festgestellt  worden). 
Durch  dieses  Kommando  lassen  sich  die  Statusbits 
wieder  zurucksetzen,  und  Interrupts,  die  auf  diesen 
Statusbits  beruhen,  konnen  damit  emeut  ausgelost 
werden! 

Send  abort  (SDLC/HDLC)  Durch  dieses  Kommando  wird  im  SDLC/HDLC-Mo¬ 

dus  ein  Sendeabbruch  signalisiert.  Der  Sender  gibt 
nach  Empfang  dieses  Kommandos  zunachst  noch  den 
Inhalt  des  Sendepuffers  und  danach  8..  13  Eins-Bits 
aus.  AnschlieBend  wird  das  EOM-FIag  gesetzt. 

Enable  Int.  on  next  Rx  Character  Empfanger-Interrupts  konnen  durch  dreivoreinstellba- 

re  Bedingungen  ausgelost  werden.  Zum  ersten  kann 
jedesZeichen,  welches  in  den  Empfangs-FIFO-Buffer 
gelangt,  einen  Interrupt  auslosen.  Zum  zweiten  lafit 
sich  die  Interruptsignalisierung  fur  den  Empfanger  so 
programmieren,  daS  nur  bei  speziellen  Empfanger- 
ZustSnden  (z.  B.  Empfangeriiberlauf,  Paritatsfehler) 
‘  ‘interrupted”  wird.  Und  zum  dritten  kann  immer  dann 
ein  Interrupt  signalisiert  werden,  wenn  das  erste 
Zeichen  eines  Textblocks  (nicht  SYNC-Zeichen!)  in 
den  Empfangs-FIFO-Buffer  gelangt.  Damit  diese 
dritte  Interrupt-Betriebsart  jeweils  nach  Empfang 
eines  Textblocks  emeut  aktiviert  werden  kann,  wird 
dieses  Kommando  verwendet. 


Reset  TxINT  pending 


Dieses  Kommando  wird  benutzt,  um  zu  verhindem, 
daB  ein  weiterer  Sender-Interrupt  ausgelost  wird, 
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obwohl  alle  zu  sendenden  Zeichen  ausgegeben  wur- 
den  und  der  Sendebuffer  “leerlauft”. 

Es  sorgt  dafiir,  daB  erst  wieder  ein  Senderinterrupt 
auftreten  kann,  wenn  das  nachste  zu  sendende  Zei¬ 
chen  (eines  neuen  Textblocks!)  in  das  Sendeschiebe- 
register  iibcrgeben  wurde  Oder  wenn  eventuelle  CRC- 
Bytes  komplett  ausgesendet  wurden. 

Error  Reset  BeibestimmtenBetriebsartenwerdendieStatusinfor- 

mationen  ftir  die  Empfangszeichen  “eingefroren”. 

Mit  diesem  Kommando  konnen  diese  Statusbits  zu- 
riickgesetzt  und  der  eingefrorene  Zustand  aufgeho- 
ben  werden. 

Reset  Highest  IUS-Bit  IUS  steht  ftir  “Interrupt  under  Service”.  Mit  diesem 

Kommando  laBt  sich  gezielt  der  im  Moment  am  hoch- 
sten  priorisierte  Interrupt  “abschalten”.  Das  sollte  im- 
mer  am  Ende  einer  Interrupt-Service-Routine  ge- 
schehen,  um  dann  den  “weniger  wichtigen”  Interrupts 
auch  die  Moglichkeit  zur  Bearbeitung  zu  geben. 

Die  Interrupt-Prioritaten  sind  beim  SCC  wie  folgt 
gesetzt: 


Empfanger  Interrupt  Kanal  A  High 

Sender  Interrupt  Kanal  A  i 

Ext./Status-Int.  Kanal  A  1 

Empfanger  Interrupt  Kanal  B  i 

Sender  Interrupt  Kanal  B  i 

Ext./Status-Int.  Kanal  B  Low 


Write-Register  1 

(Sender/Empfanger  Interrupts  und  Modus-Register  fur  Datentransfer) 

Dies  ist  das  Steuerregister  fur  verschiedene  Interrupts  des  SCC.  AuGerdem  kann  hier  das 
Handshaking  zwischen  SCC  und  DMA-Baustein  eingestellt  werden. 

Der  SCC  besitzt  fur  diese  Zwecke  je  Kanal  einen  programmierbaren  AnschluB. 
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Freigabe  fur  Ext,/Status-Interrupts 
Freigabe  fur  Senderinterrupts 
Paritatsfehler  als  Special  Condition  ansehen 
Empfangerinterrupts  (RxINT)  sperren 
RxINT  bei  erstera  Zeichen  Oder  Special  Condition 
RxINT  bei  jedem  Zeichen  oder  Special  Condition 
RxINT  nur  bei  Special  Condition 
WAIT/DMA-Request  beim  Senden  oder  Empfangen 
WAIT  oder  DMA-Request  fiir  Pin  JW/JREQ 
Freigabe  fiir  WAIT  oder  DMA-Request 

Freigabe  fiir  Ext./Status-Interrupts  Dieses  Bit  ist  der  “Hauptschalter”  fiir  Ext./Status-Inter- 

rupts.  Mit  Setzen  dieses  Bits  werden  alle  Interruptquellen, 
deren  Freigabe-Bits  im  Write  Register  15  gesetzt  sind, 
“scharfgeschaltet”. 

Freigabe  fiir  Senderinterrupts  Bei  gesetztem  Bit  wird  durch  den  Sender  immer  dann  ein 

Interrupt  ausgelost,  wenn  der  Sendepuffer  leer  wird. 

Paritatsfehler  als  Special  Condition  ansehen 

Bei  gesetztem  Bit  wird  ein  Paritatsfehler  bei  einem  emp- 
fangenen  Zeichen  als  Special  Condition  angesehen  und 
kann  einen  entsprechenden  Interrupt  auslosen. 

Empfangerinterrupts  (RxINT)  sperren 

Wenn  der  SCC  im  Polling-Betrieb  benutzt  wird  (die 
CPU  schaut  immer  mal  nach,  wie  der  SCC-Status  ist.  Da- 
zu  werden  z.  B.  die  Statusbits  im  Read  Register  0  be¬ 
nutzt),  konnen  durch  diese  Einstellung  die  Empfangerin¬ 
terrupts  gesperrt  werden. 

RxINT  bei  erstem  Zeichen  oder  Special  Condition 

Ein  Interrupt  wird  ausgelost,  sobald  ein  erstes  Zeichen 
im  Empfangs-FIFO-Buffer  vorliegt  oder  wenn  ein  Zei¬ 
chen  ausgelesen  wird,  bei  dem  eine  Special  Condition 
aufgetreten  ist.  Eine  Special  Condition  ist  z.  B.  ein  Pari¬ 
tatsfehler  (kann  separat  als  Special  Condition  program- 
miert  werden !),  ein  Uberlauf  des  Empfangsregisters,  ein 
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CRC-Fehler  oder  ein  Framing  Error  (=  kein  Stopbit  bei 
Asynchronbetrieb  erkannt).  DerEmpfangs-FIFO-Buffer 
bleibtso  lange  “eingefroren”,bis  ein  Error  Reset  ilber  das 
Write  Register  0  ausgelost  wird. 

RxINT  bei  jedem  Zeichen  oder  Special  Condition 

Jedes  empfangene  Zeichen  lost  einen  Interrupt  aus. 
AuBerdem  wird  ebenfalls  ein  Interrupt  ausgelost,  wenn 
eine  Special  Condition  auftrat.  Jedoch  wird  der  Emp- 
fangs-FIFO-Buffer  nicht  “eingefroren”,  bis  ein  Error 
Reset  ausgelost  wird. 

RxINT  nur  bei  Special  Condition  Bei  dieser  Einstellung  wird  nur  ein  Interrupt  ausgelost, 

wenn  beim  Zeichenempfang  eine  Special  Condition 
auftrat.  Das  zugehorige  Zeichen  bleibt  wieder  bis  zu 
einem  Error  Reset  im  Empfangs-FIFO-Buffer  “einge¬ 
froren”. 

Fur  beide  SCC-Kanale  gibt  es  einen  AnschluB,  der  fur  Betrieb  des  SCC  mit  z.  B.  DMA-Bau- 
steinen  benutzt  werden  kann.  Im  TT  ist  dieser  AnschluB  aber  nur  fur  den  SCC-Kanal  A  be- 
nutzt.  Der  _W/_REQ-AnschluB  kann  dabei  auf  verschiedene  Betriebsmodi  eingestellt  wer¬ 
den. 


-  Wait  on  Transmit .  (Bits  7. .5  -  ‘TOO”) 

Bei  dieser  Einstellung  liefert  der  _W/_REQ-Pin  so  lange  ein  Low,  wie  der  Sendepuffer 
noch  gefiillt  ist.  Sobald  der  Sendepuffer  ein  neues  Zeichen  aufnehmen  kann,  geht  der  _W/ 
_REQ-Anschlu8  in  einen  hochohmigen  Zustand. 

Wait  on  Receive.  (Bits  7..5  =  “101”) 

Bei  dieser  Einstellung  liefert  der  _W/_REQ-Pin  ein  “Wartesignal”  (Low-aktiv),  welches 
die  CPU  bei  einem  Lesezugriff  auf  einen  leeren  Empfangs-FTFO-Buffer  zum  “Warten” 
auffordert,  bis  ein  Zeichen  zum  Auslesen  vorliegt.  Sobald  ein  Zeichen  vorliegt,  geht  _W/ 
_REQ  in  den  hochohmigen  Zustand. 

-  DMA-Request  on  Transmit.  (Bits  7..5  =  “110”) 

Mit  diesem  Low-aktiven  Signal  an  _W/_REQ  bekommt  der  DMA-Baustein  mitgeteilt, 
wenn  der  Sendepuffer  leer  ist  und  ein  neues  Zeichen  eingeschrieben  werden  soil.  Erst 
wenn  ein  Zeichen  “nachgefiillt”  wurde,  geht  _W/_REQ  wieder  auf  High  (wird  nicht 
hochohmig!). 

-  DMA-Request  on  Receive.  (Bits  7..5  =  “111”) 

Auchhierfordert  derSCC  mit  einerfallendenFlankean_W/_REQ  einen  DMA-Baustein 
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zur  Aktion  auf.  Nur  daB  jetzt  signalisiert  wird,  daB  ein  Zeichen  ausdemEmpfangs-FIFO- 
Buffer  abgehoit  werdenkann.  Sollte  der  SCC  in  einer  Betriebsartfur  den  Empfangsinterrupt 
verwendet  werden,  die  den  FIFO-Empfangsbuffer  bei  Auftreten  einer  Special  Condition 
“einfriert”,  so  werden  natiirlich  nicht  laufend  _W/_REQ-Impulse  erzeugt  (schlieBlich 
bleibt  ja  das  Zeichen,  bei  dem  diese  Special  Condition  auftrat,  ina  FIFO-Buffer 
eingefroren!).  Sobald  das  Zeichen  einmal  ausgelesen  wurde,  geht_W/_REQ  wieder  auf 
High  und  reagiert  erst  wieder  “normal”,  sobald  mit  dem  Error  Reset-Kommando  die 
Special  Condition  beseitigt  wurde. 

WAIT/DMA-Request  beim  Senden  oder  Empfangen 

Bei  gesetztem  Bit  arbeitet  der  _W/_REQ-AnschluB  fur 
den  Empfangsteil.  Bei  geloschtem  Bit  wird  der  _W/ 
_REQ-AnschluB  dagegen  vom  Sendeteil  des  SCC  ge- 
steuert. 

WAIT  oder  DMA-Request  fur  Pin  _W/_REQ 

Bit  =  0:  _  W/_REQ-Pin  in  WAIT-Betriebsweise. 

Bit  =  1 :  _W/_REQ-Pin  in  REQUEST-Betriebs- 

weise 

Freigabe  fiir  WAIT  oder  DMA-Request 

Bei  gesetztem  Bit  ist  WAIT/REQUEST  aktiviert.  Bei 
geloschtem  Bit  ist  weder  WAIT-  noch  REQUEST- 
Betriebsart  freigegeben. 

Der  SCC  besitzt  je  Kanal  noch  einen  weiteren  Pin,  der  als  REQUEST-AnschluB  fiir  DMA- 
Betrieb  verwendet  werden  kann.  Auch  dieser  Pin  ist  als  MultifunktionsanschluB  ausgelegt.  Er 
laBt  sich  sowohl  fiir  DMA-REQUEST  zur  Bedienung  des  Sendeteils  einstellen  als  auch  als 
normaler  SchnittstellenanschluB  fiir  das  DTR-Signal  (Data  Terminal  Ready  an  MODEM)  be- 
nutzen.  Atari  verwendet  den  DTR/REQ-Pin  aber  fiir  beide  SCC-Kanale  als  DTR-AnschluB! 
Deshalb  soil  hier  nicht  weiter  auf  die  RBQUEST-Betriebsart  mit  diesem  AnschluB  eingegan- 
gen  werden. 

Write-Register  2 

(Interrupt  Vektor-Register) 

Der  SCC  kann,  ahnlich  dem  MFP,  wahrend  eines  Interrupt-Acknowledge-Zyklus  eine 
Vektomummer  ausgeben.  Diese  Vektomummer  kann  hier  eingestellt  werden.  Dabei  existiert 
fiir  beide  SCC-Kanale  nur  ein  Interrupt  Vektor-Register,  daB  aber  von  “beiden  Seiten”  erreicht 
werden  kann.  Die  Vektomummer  kann  abhangig  von  Statusinformationen  (wie  z.  B. 
“Sendepuffer  leer”)  geiindert  werden.  Dabei  laBt  sich  durch  das  “Status  High/_Status  Low“- 
Bit  in  Write-Register  9  einstellen,  welche  Bits  der  Vektomummer  durch  die  Statusinformation 
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beeinfluBt  werden.  Eine  Anderung  durch  Statusinformationen  betrifft  entweder  die  Bits  1  ..3 
(“Status  High/__Status  Low”-Bit  in  Write-Register  9  geloscht)  oder  die  Bits  4..6  (“Status  High/ 
_Status  Low”-Bit  in  Write-Register  9  gesetzt)  im  Interrupt  Vektor-Register. 

Ob  uberhaupt  Statusinformationen  die  Vektomummer  beeinflussen  konnen,  wird  durch  das 
Bit  “Vektor  includes  Status  (VIS)”  in  Write-Register  9  eingestellt  (Bit  gesetzt:  Beeinflussung 
moglich!). 

Welche  Beeinflussung  die  Vektomummer  durch  die  Statusbits  erfahren  kann,  zeigt  die 
nachfolgende  Tabelle. 


Bit  3 

4 

2 

5 

1 

6 

Status  High/  Status  Low  =  0 

Status  High/_Status  Low  =  1 

Interrupt 

fiir 

0 

0 

o 

Sendepuffer  leer 

Kanal  B 

0 

0 

1 

Externer/Status-Interrupt 

M 

0 

1 

0 

Empfangszeichen  verfiigbar 

0 

1 

1 

Special  Condition  beim  Bmpfang 

» 

1 

0 

0 

Sendepuffer  leer 

Kanal  A 

1 

0 

1 

Externer/Status-Interrupt 

1 

1 

0 

Empfangszeichen  verfiigbar 

■»> 

1 

1 

1 

Special  Condition  beim  Empfang 

Im  TT/MEGA  STE  verwendet  ATARI  eine  Vektomummer  von  $60.  AuBerdem  ist 
standardmaBigdas  “Status  High/_Status  Low”-Bit  geloscht,  so  daB  die  Intenupt  Vektomummer 
durch  Statusinformationen  in  den  Bits  3..  1  beeinfluBt  wird.  Entsprechend  fmdet  man  im  RAM 
des  TT/MEGA  STE  ab  der  Speicherstelle  $180  die  zugehorigen  Interruptvektoren  des  SCC 
wieder.  Also  bei  $180  den  Zeiger  auf  die  Routine  fiir  “Sendepuffer  Kanal  B  leer”,  bei  $188 
die  Adresse  der  Routine  fiir  “Externer/Status-Interrupt  Kanal  B”  usw. 

Write-Register  3 

(Empfangersteuerung) 

Uber  dieses  Register  konnen  verschiedene  Empfangsparameter  eingestellt  werden,  Hier 
einige  Erlauterungen  zu  den  Einstellmoglichkeiten,  die  nicht  unmittelbar  ersichtlich  sind: 

Address  Search  Mode  Bei  gesetztem  Bit  werden  im  SDLC/HDLC-Modus  nur 

Datenblocke  mit  Adressen  ausgewertet,  die  mit  der  Adresse  im 
Write-Register  6  iibereinstimmen.  Dabei  kann  allerdings  durch 
das  Bit  1  im  Write-Register  3  (=SYNC-Zeichen  nicht  in  FIFO 
iibemehmen)  noch  bestimmt  werden,  ob  die  Empfangsadresse 
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exakt  mit  der  Adresse  iibereinstimmen  muB  (dann  muB  Bit  1 
geloscht  sein).  1st  im  Address  Search  Mode  das  Bit  1  gesetzt, 
miissen  nur  die  vier  hochstwertigen  Bits  im  AdreBfeld  des 
Empfangsblocks  mit  dem  Wert  im  Write-Register  6  iiberein- 
stimmen. 

Suchmodus  einschalten  Bei  gesetztem  Bit  geht  der  SCC-Empfangsteil  auf  “die  Suche” 

nach  SYNC-Zeichen  (im  synchronen,  zeichenorientierten 
Modus)  Oder  nach  Flags  (im  SDLC/HDLC-Modus).  Wenn  die 
“Suche”  erfolgreich  war,  wird  in  Read-Register  0  das  Bit  4 
(SYNC/HUNT-BIT)  gesetzt  und  evtl.  ein  Interrupt  ausgelost. 


0:  Bmpfdnger  gesperrt/  1 :  Empf.  eingeschaltet 
Empfangene  SYNC-Zeichen  nicht  in  FIFO  iibemehmen 
Address  Search  Mode  (nur  SDLC/HDLC) 
CRC-Priifstufe  im  Empfanger  aktivieren 
Suchmodus  einschalten 

Autom.  Freigabe  f.  Rx/Tx  durch  _DCD  und  _CTS 

5  Bits/Zeichen 

7  Bits/Zeichen 

6  Bits/Zeichen 

8  Bits/Zeichen 


Write-Register  4 

(Moduseinstellungen  fur  Sender/Empfanger) 

In  diesem  Register  lassen  sich  neben  Sendereinstellungen  auch  einige  Empfangerparameter 

beeinflussen  (Registerbelegung  siehe  folgende  Seite). 

Synchronbetrieb  einschalten  Wenn  Synchronbetrieb  gewahlt  ist,  werden  auch  die 

Einstellungen  in  den  Bits  5..4  beriicksichtigt.  AuBerdem 
ist  damit  automatisch  “Takt  =  1  x  Datenrate”  eingestellt 
(die  Einstellungen  in  Bits  7..6  bleiben  dann  unberiick- 
sichtigt)! 

MONOSYNC-/BISYNC-Betrieb  Wenn  MONOSYNC-Betrieb  ausgewahlt  ist,  wird  die 

Zeichensynchronisierung  auf  das  Zeichen  im  Write- 
Register  7  eingerastet. 
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Bei  BISYNC-Betrieb  wird  fur  die  Zeichensynchronisie- 
rung  das  Bitmuster  aus  Write-Register  7  und  6  benutzt. 

SDLC/HDLC-Modus  Fiir  den  SDLC/HDLC-Modus  ist  in  Write  Register  7  das 

Bitmuster  fur  das  Flag  (7Ehex)  einzutragen.  AuBerdem 
muB  fiir  das  Blocksicherungsverfahren  mittels  CRC  das 
zu  verwendende  Priifpolynom  iiber  das  Write  Register  5 
eingestellt  sein. 

Zeichensynchronisation  extern  Beim  SCC  kann  die  Zeichensynchronisation  im  Syn- 

chronmodus  auch  extern  iiber  den  _S  YNC-AnschluB  er- 
folgen.  Im  TT/MEGA  STE  wird  dieser  Pin  jedoch  bei 
beiden  SCC-Kanalen  fiir  die  Abfrage  des  “Data  Set 
Ready”-Signais  benutzt. 


0  1 
1  0 
1  1 


Mit  Paritatsbit  arbeiten 
0:  ungerade  Paritat  /  1 :  gerade  Paritat 
Synchronbetrieb  einschalten 
Asynchronbetrieb  mit  1  Stopbit 
Asynchronbetrieb  mit  ]  ,5  Stopbits 
Asynchronbetrieb  mit  2  Stopbits 
MONOSYNC-Betrieb 
BISYNC-Betrieb 

SDLC/HDLC-Modus  (“01 1111 10”-Flag) 

Zeichensynchronisation  erfolgt  extern 

Takt  =  1  x  Datenrate 

Takt  =  16  x  Datenrate 

Takt  =  32  x  Datenrate 

Takt  =  64  x  Datenrate 


Write-Register  5 

(Sendersteuerung) 

Bis  auf  das  Bit  2  dieses  Registers  beeinflussen  alle  Bits  das  Verhalten  des  SCC-Sendeteils. 

Freigabe  fiir  Sender-CRC-Generator 

Bei  gesetztem  Bit  durchlaufen  die  zu  sendenden  Zeichen  den 
CRC-Generator  und  erzeugen  so  eine  Priifbitfolge,  die  am 
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iTeTiT  4  3  2[l0 


0  0  — 

0  1  - 

10 - 

11 - 


Request  to  Send  (RTS) 


Auswahl  fiir  CRC-Verfahren 


Freigabe  fur  den  Sender 


Ende  des  Blocks  mitgesendet  wird.  Das  Aussenden  der  CRC- 
Bits  erfolgt  jedoch  erst  dann,  wenn  keine  Daten  mehr  zu  senden 
sind.  Der  SCC  erkennt  das  daran,  daB  das  Senderegister  nicht 
mehr  “nachgefiillt”  wird,  also  eine  Tx  Underrun-Bedingung 
entsteht! 


Freigabe  fur  Sender-CRC-Generator 
Request  to  Send  (RTS) 

Auswahl  fUr  CRC-Verf.  0:  CRC-CCITT/  1:  CRC-16 

Freigabe  fiir  den  Sender 

BREAK  senden  (Dauerlage  “0”  ausgeben) 

5  Bits/Zeichen 

7  Bits/Zeichen 

6  Bits/Zeichen 

8  Bits/Zeichen 

Data  Terminal  Ready  (DTR) 


Dieses  Bit  steuert  den  _RTS-Pin  des  SCC.  Bei  gesetztem  Bit 
geht  der  „RTS-AnschluB  auf  Low,  bei  geloschtem  Bit  dann 
entsprechend  auf  H.  .  .  (na,  raten  Sie  selber  mail  Ergebnis 
dann  bitte  selbst  eintragen.) 

Mit  diesem  Bit  laBt  sich  programmieren,  welches  Generator- 
polynom  zur  Bildung  der  Priifbitfolge  benutzt  wird.  Bei  SDLC/ 
HDLC  wird  das  CRC-CCITT -Polynom  benutzt  (B it— 0).  Wenn 
synchron,  zeichenorientiertgearbeitet  wird  (z.  B.  MONOSYNC 
oder  BISYNC),  kommt  meistens  das  CRC-16-Polynom  zur 
Anwendung  (Bifc=l).  Die  Einstellungen  gelten  sowohl  fiir  den 
Sender  als  auch  den  Empfanger. 

Solange  dieses  Bit  nicht  gesetzt  ist,  werden  keine  Daten  aus- 
gesendet.  Statt  dessen  gibt  der  Sender  eine  Dauerlage  “1”  aus. 
Wird  nach  dem  Start  einer  Ubertragung  dieses  Bit  zuriickge- 
setzt,  werden  die  Daten  im  Senderegister  aber  noch  komplett 
ausgesendet  (gilt  auch  fiir  SYNC-Zeichen).  Wenn  allerdings 
wahrend  der  Ubertragung  von  CRC-Zeichen  der  Sender  abge- 
schaltet  wird,  gelangen  statt  dessen  SYNC-Zeichen  oder  Flags 
an  den  Senderausgang. 
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BREAK  senden  (Dauerlage  “0”  ausgeben) 

Sobald  das  Bit  gesetzt  wird,  gibt  der  Sender  nur  noch 
Dauerlage  “0”  aus.  Wird  das  Bit  wieder  zuriickgesetzt, 
geht’s  normal  mit  dem  Aussenden  der  Sendeschiebe- 
registerdaten  weiter. 

Data  Terminal  Ready  (DTR)  Wenn  der  SCC  im  DTR-Modus  eingestellt  ist  (iiber  Bit  2 

im  Write-Register  14  auswahlbar),  bestimmt  dieses  Bit 
den  Zustand  des  JDTR/JREQ-Pins  des  SCC.  Bei  ge- 
loschtem  Bit  ist  der  AnschluB  dann  High,  bei  gesetztem 
Bit  entsprechend  Low. 

Der  Inhalt  dieses  Registers  kann  auch  ausgelesen  werden.  Dazu  ist  ein  Lesezugriff  auf  das 
Read-Register  5  durchzufiihren,  wenn  BitO  von  Write-Register  15  und  Bit  6  von  Write- 
Regi-ster  7’  gesetzt  sind. 

Write-Register  6 

(SYNC-Zeichen  /  Adresse  im  SDLC/HDLC-Betrieb) 

Im  SDLC/HDLC-Modus  enthalt  dieses  Register  die  Adresse,  auf  die  im  “Address  Search 
Mode”  beim  Frame-Empfang  “gewartet”  wild.  Siehe  auch  bei  Write-Register  3! 

Im  MONOSYNC-Modus  wird  in  diesem  Register  das  vom  Sender  verwendete  SYNC- 
Zeichen  eingestellt. 

Bei  BISYNC-Betrieb  (Betrieb  mit  zwei  SYNC-Zeichen  oder  einem  16  Bit-SYNC-Zei-chen, 
je  nachdem,  wie  man  die  Sache  betrachtet)  enthalt  dieses  Register  die  unteren  acht  Bits  des 
SYNC-Zeichens. 

Mit  dem  Write-Register  7  hat  es  etwas  Besonderes  auf  sich.  Es  existiert  namlich  im  85C30 
zweimal.  Gegeniiber  seinem  “  Vorganger”,  dem  8530,  hat  die  im  TT/MEGA  STE  verwendete 
CMOS-Version  des  Chips  einige  zusatzliche  Moglichkeiten  in  bezug  auf  den  SDLC/HDLC- 
Betrieb  “spendiert”  bekommen  (wie  z.  B.  der  lOfach  FRAME-Status-FIFO-Buffer).  Urn  an 
diese  zusatzlichen  Moglichkeiten  und  damit  auch  an  das  zusatzliche  Write-Register  7’  heran- 
zukommen,  muB  SDLC/HDLC-Betrieb  eingestellt  und  das  BitO  im  Write-Register  15  ge¬ 
setzt  sein.  Aber  nun  erst  einmal  zur  Funktion  des  “normalen”  Write-Register  7, 

Write-Register  7 

(SYNC-Zeichen  2/  Flag  im  SDLC/HDLC-Betrieb) 

Im  MONOSYNC-Modus  wird  mit  dem  Write-Register  7  das  Empfangs-SYNC-Zeichen 
festgelegt. 
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Bei  BISYNC-Betrieb  enthalt  dieses  Register  den  unteren  Teil  (oder  das  zweite  SYNC- 
Zeichen,  je  nach  Betrachtungsweise!)  des  SYNC-Zeichens. 

Im  SDLC/HDLC -Modus  muB  hier  das  Flag  (7Ehcx)  eingetragen  sein. 

Write-Register  7’ 

(SDLC/HDLC-Optionsregister) 

Nur  wenn  im  SDLC/HDLC-Modus  gearbeitet  wird,  kann  auf  dieses  Register  zugegriffen 
werden. 


Auto  Freigabe  fur  Senderegister 
Auto  EOM-Reset 
Auto  RTS-Steuerung 

Dauerlage  “1”  bei  NRZI-Modus  und  Tx-Disable 
JDTR/_REQ-Timing 
Empfangs-CRC-Bits  iibergeben 
Erweiterter  Lesezugriff  auf  Write-Register 
Immer  “0”! 


Auto  Freigabe  fur  Senderegister 

Wenn  dieses  Bit  gesetzt  ist,  braucht  nicht  erst  das  Aussenden 
des  Flags  abgewartet  zu  werden,  bevor  das  erste  Zeichen  in  das 
Senderegister  gebracht  werden  kann.  Sobald  das  erste  Zeichen 
in  das  Senderegister  gelangt,  sendet  der  SCC  das  “Eroffnungs”- 
Flag  und  sendet  dann  die  Daten  hinterher. 

Auto  EOM-Reset  Wenn  dieses  Bit  gesetzt  ist,  braucht  das  Riicksetzen  des  Tx 

Underrun/End  Of  Message-Flag  nicht  mehr  zu  Beginn  eines 
Frames  “von  Hand”  durchgefuhrt  zu  werden.  Der  SCC  fiihrt 
diesen  RESET  dann  automatisch  nach  Aussenden  des  ersten 
Datenbytes  durch. 

Auto  RTS-Steuerung  Bei  gesetztem  Bit  wird  das  Deaktivieren  der  RTS-Leitung  mit 

dem  Aussenden  des  letzten  Bits  eines  “SchlutV’-Flags  synchro- 
nisiert.  Auch  wenn  vom  Programm  schon  wahrend  des  Sendens 
derCRC-Bits  bereits  RTS  abgeschaltet  wird,  wird  der  SCC  den 
RTS-AnschluG  erst  deaktivieren,  wenn  das  letzte  Bit  des 
SchluBflags  eines  Frames  gesendet  ist! 
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Dauerlage  *T”  bei  NRZI-Modus  und  Tx-Disable 

Wenn  der  Sender  abgeschaitet  wird,  wahrend  der  SCC  in 
NRZI-Kodierung  betrieben  wird,  geht  bei  gesetztem  Bit  der 
AusgangsanschluB  auf  High. 

_DTR/_REQ-Timing  Der  _DTR/_REQ-AnschluB  des  SCC  kann  auch  fiir  DMA- 

Requestsprogrammiertwerden.Allerdingsnur  fiir  den  Sendeteil 
des  SCC.  Wenn  dieses  Bit  gesetzt  ist,  verhalt  sich  das  Request- 
Timing  an  diesem  AnsehluB  genauso  wie  am  „W/_REQ-An- 
schlufi.  Siehe  dazu  auch  Erlauterungen  zum  Write-Register  1 . 

Empfangs-CRC-Bits  iibergeben 

Bei  gesetztem  Bit  wird  die  komplette  CRC-Priifbitfolge  im 
Empfangsregister  zur  Verfiigung  gestellt.  Sonst  fehlen  wegen 
einer  3  Bit-Verzbgerungsstufe  zwischen  SYNC-Register  und 
Empfangsschieberegisterim  Empfangsteil  des  SCC  die  letzten 
zwei  Bits. 

Erweiterter  Lesezugriff  auf  Write-Register 

Bei  gesetztem  Bit  sind  die  eigentlich  “unleserlichen”  Write- 
Register  3..5  und  10  mit  einem  Lesezugriff  erreichbar. 

Allerdings  taucht  dann  Write-Register  3  unter  Read-Regi¬ 
ster  9  auf.  Write-Register  10  kann  aus  Read-Register  Ilausge- 
lesen  werden.  Write-Register  4  und  5  erscheinen  unter  Read- 
Register  4  und  5. 


Write-Register  8 

(Sendedatenregister) 

Dieses  Register  ist  das  Sendedatenregister.  Im  TT/MEGA  STE  sind  sowohl  das  Write-Re¬ 
gister  8  als  auch  das  Read-Register  8  (Empfangsdatenregister)  unter  der  gleichen  (eigenen) 
Adresse  zu  finden  (“sccdat_a”  an  Adresse  $(FF)FF  8C83  und  “sccdat_b”  an  Adresse 
$(FF)FF  8C87). 

Write-Register  9 
(Master  Interrupt  Control) 

Dieses  Register  existiert  nicht  fiir  jeden  SCC-Kanal  separat,  sondemkann  vonbeiden  Kanalen 
erreicht  werden! 
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VIS  (Vector  Includes  Status) 

NV  (No  Vector) 

DLC  (Disable  Lower  Chain) 

MIE  (Master  Interrupt  Enable) 

Status  High/_Status  Low 
Interrupt  Acknowledge  ignorieren 
Kein  RESET 
RESET  fur  SCC-Kanal  A 
RESET  fur  SCC-Kanal  B 
Hardware  RESET  durchfiihren 

VIS  (Vector  Includes  Status)  Wie  ja  bereits  beim  Write-Register  2  erlautert,  kann  der  Inter- 

ruptvektor,  den  der  SCC  bei  einem  Interrupt-Acknowledge- 
Zyklus  liefert,  abhangig  von  Statusinformationen,  die  im  Zu- 
sammenhang  mit  dem  Interrupt  stehen,  geandert  werden.  Bei 
gesetztem  Bit  liefert  der  SCC  also  eine  durch  Statusinforma¬ 
tionen  beeinfluBte  Vektomummer. 

NV  (No  Vector)  BeigesetztemBitliefertderSCCkeinelnterrupt-Vektornummer 

wahrend  eines  Interrupt- Acknowledge-Zyklus! 

DLC  (Disable  Lower  Chain)  Wenn  z.  B.  mehrere  SCCs  in  einerlnterrupt-Verkettung  betrie- 

ben  wiirden  (wie  das  z.  B.  mit  den  beiden  MFPs  im  TT  ge- 
schieht),  konnten  durch  Setzen  dieses  Bits  die  niedriger  gewich- 
teten  Devices  von  Interruptanforderungen  abgekoppelt  wer¬ 
den.  Im  TT/MEGA  STE  nicht  verwendet. 

MIE  (Master  Interrupt  Enable) 

Bei  geloschtem  Bit  werden  keine  Interruptanforderungen  ge- 
stellt. 

Status  High/_Status  Low  Der  Zustand  dieses  Bits  legt  fest,  welche  Bits  der  Interrupt- 

Vektomummer  durch  Statusinformationen  verandert  werden 
konnen. 

Bit  -  0:  Bits  1..3  der  Vektomummer  beeinflussen 
Bit  =  1:  Bits  6. A  der  Vektomummer  beeinflussen. 

Siehe  dazu  die  Erlauterungen  zu  Write-Register  2. 
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Interrupt  Acknowledge  ignorieren 

Bei  gesetztem  Bit  wird  ein  Interrupt-Acknowledge-Zyklus 
vom  SCC  ignoriert. 

Kein  RESET  Dieses  Kommando  wird  nur  benotigt,  wenn  auf  dieses  Register 

zugegriffen  werden,  dabei  aber  kein  Reset  ausgelost  werden 
soil. 


Wenn  ein  RESET  fiir  einen  der  SCC-Kanale  ausgelost  wird,  werden  Sender  und  Empfanger 
des  entsprechenden  Kanals  gesperrt.  Modem-Steueranschliisse  wie  RTS  gehen  auf  High.  Alle 
“pending”  Interrupts  (anstehenden  Interrupts)  und  “Interrupts  Under  Service”  werden  zuriick- 
gesetzt  und  Interrupts  gesperrt. 

Write-Register  10 

(Verschiedene  Sender/Empfanger-Kontrollbits) 


In  diesem  Register  sind  noch  ein  paar  Bits  zur  Steuerung  des  Sende-  und  Empfangsteils 
untergebracht. 


6  Bit/  . 8  Bit  SYNC 
Loop  Mode 

Send  Abort/JFlag  bei  Underrun  setzen 
Mark/_Flag  Idle 
Go  Active  On  Poll 
NRZ-Kodierung 
NRZI-Kodierung 
FMl-Kodierung  (Biphase  Mark) 

FMO-Kodierung  (Biphase  Space) 

CRC-mit  1/0  vorbesetzen 

Mit  gesetztem  Bit  kann  man  bei  synchroner,  zeichenorientierter 
Betriebsart  ein  spezielles  Format  fiir  die  SYNC-Zeichen  wah- 
len.  Diese  sind  dann  im  MONOSYNC-Modus  nur  6  Bits  so- 
wohl  fiir  Empfanger  als  auch  Sender  lang.  Im  BISYNC-Mo- 
dus  werden  dann  nur  12  Bit-SYNC-Zeichen  beim  Empfang 
ausgewertet,  beim  Senden  allerdings  weiter  1 6  Bits  verwendet. 


Loop  Mode 


Im  SDLC/HDLC-Betrieb  wird  eine  spezielle  Betriebsart  fiir 
Mehrpunktverbindungen  verwendet,  bei  dereine  Zentralstation 
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mehrere  Unterstationen  steuert.  Die  Unterstationen  sind  in 
einem  Ring  hintereinander  geschaltet  und  arbeiten  als  Repeater 
(Wiederholer).  Dabei  leitet  die  Unterstation  die  von  der  vorher 
liegenden  Station  empfangenen  Daten  zur  dahinterliegenden 
Station  weiter.  Dieses  Prinzip  wird  auch  als  ‘Token  Passing 
Ring”  bezeichnet. 

Bei  dieser  Betriebsart  werden  vom  SCC  alle  empfangenen  Bits 
mit  einem  1  Bit-Delay  iiber  den  Sender  wieder  ausgegeben. 
Wenn  bei  einem  Poll  (=  Aufforderung  zum  Senden)  die  Unter¬ 
station  umerkt”dafi  sie  angesprochen  wurde  (Uberdas  AdreBfeld 
erkennbar),  “klinkt”  sie  sich  mit  einem  Oder  mehreren  entspre- 
chenden  “Antwort-Frames”  in  den  Ring  ein. 

Durch  Setzen  des  “Loop  Mode”-Bits  werden  Sender  und  Emp- 
fanger  zunachst  zusammengeschaltet,  um  den  empfangenen 
Datenstrom  direkt  durchzulassen.  Wenn  dann  das  “Go  Aktive 
On  Poll”-Bit  gesetzt  wird  und  mindestens  7  Einsbits  (=”End  Of 
Poll”-Zeichen  =  EOP  =  FEhM  oder  Ruhezustand  mit  Dauerlage 
“1”  auf  der  Empfangsleitung)  empfangen  wurden,  geht  der 
SCC  “On  Loop”  und  schaltet  einen  1  Bit-Delay  zwischen 
Empfanger-  und  Senderleitung, 

Bevor  eine  Unterstation  aber  selbst  senden  darf,  rnuB  nach  dem 
“On  Loop”-Schalten  ein  Flag  empfangen  werden.  Dann  hat  die 
Station  ein  weiteres  EOP  abzuwarten,  von  dem  sie  allerdings 
das  letzte  Einsbit  direkt  in  eine  Null  umsetzt.  Damit  entsteht 
daraus  fur  die  nachste  Unterstation  ein  Flag!  Nun  wird  der  Rest 
des  Antwort-Frames  der  Unterstation  ausgesendet,  der  am 
SchluB  wieder  mit  einem  Flag  und  einem  EOP  abgeschlossen 
werden  muB.  Wenn  der  Antwort-Frame  gesendet  wurde,  ver- 
bleibt  die  Unterstation  mit  dem  1  Bit-Delay  im  Ring! 

In  synchroner,  zeichenorientierter  Betriebsart  (MONOSYNC 
oder  BISYNC)  wird  dieses  Bit  gesetzt,  um,  zusammen  mit 
einem  gesetzten  “Go  Aktive  On  Poll”-Bit,  den  Sender  erst  bei 
“eingerasteter”  Zeichensynchronisierung  freizugeben. 

Send  Abort/_Flag  bei  Underrun  setzen 

Nur  in  SDLC/HDLC-Betrieb  von  Bedeutung.  Durch  dieses  Bit 
wird  eingestellt,  wie  der  SCC  sich  bei  einem  Tx  Underrun- 
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Mark/_Flag  Idle 


Go  Active  On  Poll 


CRC-mit  1/0  vorbesetzen 


Status  verhalt  (das  Senderegister  wurde  nicht  mehr  rechtzeitig 
mit  Sendedaten  “nachgeladen”).  Bei  gesetztem  Bit  und  Tx 
Underrun-Status  sendet  der  SCC  ein  Abbruch-Signal  (8..  13 
Einsbits)  und  ein  Flag  statt  einer  CRC-Priifbitfolge! 

Bei  geloschtem  Bit wird  dagegen  die  CRC-Priifbitfolge  gesendet 
und  zu  Beginn  dieses  Aussendens  das  Tx  Underrun/EOM-Bit 
in  Read  Register  0  gesetzt  (Kann  einen  Ext./Status-Interrupt 
auslosen). 

Dieses  Bit  sollte  nach  der  Ausgabe  des  ersten  Bytes  an  das 
Senderegister  des  SCC  gesetzt  werden.  Ein  Riicksetzen  hat 
dann  unmittelbar  nach  Ubergabe  des  letzten  Datenby tes  an  das 
Senderegister  zu  erfolgen,  um  ein  einwandfreies  Beenden  des 
laufenden  Frames  mit  CRC  und  Flag  zu  gewahrleisten. 

Auch  dieses  Bit  ist  nur  bei  SDLC/HDLC-Betrieb  relevant.  Bei 
geloschtem  Bit  werden  im  Ruhezustand  (Idle  State)  einer 
Verbindung  Flags  gesendet.  Mit  gesetztem  Bit  gibt  der  Sender 
Einsbits  (in  Bytegruppen)  als  Ruhezustand  aus  (sinnvoll  fiir  die 
Zentralstation  in  einem  Token  Passing  Ring,  zur  Erzeugung 
des  EOP!). 

Dieses  Bit  wird  beim  SDLC-Loop  Mode  verwendet,  um  den 
Sender  des  SCC  aufzufordem,  sich  fiir  einen  oder  mehrere  Ant- 
wortffames  in  den  Datenstrom  einzuklinken. 

Bei  gesetztem  Bit  “klinkt”  sich  die  Unterstation  mit  einem  Flag 
in  den  Ring  ein.  Die  zu  sendenden  Daten  miissen  dann  in  das 
Sendedatenregister  iibergeben  werden. 

Bevor  die  CRC-Priifbitfolge  gesendet  wird,  muB  dieses  Bit 
wieder  zuriickgesetzt  sein,  sonst  werden  zusatzliche  Flags  ge¬ 
sendet.  Es  ist  sinnvoll,  dieses  Bit  nur  dann  zu  setzen,  wenn  ein 
Poll  fiir  die  eigene  Adresse  empfangen  wurde. 

Dieses  Bit  bestimmt  den  Ausgangszustand  des  CRC-Schiebe- 
registers  im  Sender  und  Empfanger.  Bei  gesetztem  Bit  werden 
alle  Schieberegisterstufen  mit  “1”  vorbesetzt.  Bei  geloschtem 
Bit  erfolgt  die  Voreinstellung  entsprechend  mit  “0”. 
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Write-Register  11 

(Takteinstellung) 


TRxC  Out  =  Quarzoszillator-Ausgang 
TRxC  Out  =  Sendertakt 
TRxC  Out  =  Ausgang  des  Baudratengenerators 
TRxC  Out  =  Ausgang  der  DPLL-Stufe 
TRxC-Signalrichtung  (0  =  Input  /  I  =  Output) 
Sendetakt  kommt  vom  RTxC-AnschluB 
Sendetakt  kommt  vom  TRxC-AnschluB 
Sendetakt  kommt  vom  Baudratengenerator-Ausgang 
Sendetakt  kommt  vom  DPLL- Ausgang 
Empfangstakt  kommt  vom  RTxC-AnschluB 
Empfangstakt  kommt  vom  TRxC-AnschluB 
Empfangstakt  kommt  vom  Baudratengen.-Ausgang 
Empfangstakt  kommt  vom  DPLL- Ausgang 
RTxC  ist  Quarzoszillator-Eingang/JTTL-Eingang 


TRxC  Out  =  ...  Diese  beiden  Bits  bestimmen,  welches  Signal  am  TRxC-Pin 

abgegriffen  werden  kann  (natiirlich  nur  dann  von  Bedeutung, 
wenn  TRxC  als  Ausgang  programmiert  ist!).  Im  TT/ 
MEGA  STE  wird  der  TRxC-AnschluB  fur  beide  SCC-Kanale 
als  Eingang  verwendet! 


RTxC  ist  Quarzoszillator-Eingang/JTTL-Eingang 

Im  TT/MEGA  STE  wird  entweder  ein  eigener  TTL-Takt- 
generator  (Kanal  A,  3,672  MHz)  oder  der  Takt  vom  Timer  C 
des  TT-MFP  verwendet  (Kanal  B).  Deshalb  ist  das  Bit  ge- 
loscht! 


Write-Register  12  + 13 

(Low-Byte  +  High-Byte  fur  Baudratentimer) 

Im  SCC  ist  fur  jeden  Kanal  ein  eigener  Baudratengenerator  eingebaut,  der  mit  einem  vorein- 
stellbaren  Abwartszahler  realisiert  ist.  Der  Abwartszahler  ist  ein  16  Bit-Zahler,  dessen  Vor- 
einstellung  durch  die  beiden  Bytes  in  den  Write-Registem  12  und  13  vorgenommen  wird. 

Der  Baudratengenerator  kann  zumeinen  vom  SCC-Mastertakt  (8  MHzimTT/MMEGA  STE) 
gespeist  werden.  Die  andere  Taktquelle  im  TT/MEGA  STE  ist  der  RTxC-AnschluB. 
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Die  Ermittlung  der  Zeitkonstante,  die  fiir  eine  bestimmte  Baudrate  bei  einem  vorgegebenen 
Takt  gewahlt  werden  mu6,  geschieht  nach  folgendem  Schema 

Taktfrequenz 

Konstante  = - -  2 

2  x  Baudrate  x  Taktmodus 


Taktfrequenz:  Eingangsfrequenz  des  Baudratengenerators 

Taktmodus:  AnzahlTaktzyklenje  Bit  (bei  einem  Taktmodus  von  z.B.  I6werden  16 

Taktzyklen  fiir  die  Ausgabe  eines  Schritts  (Bits)  benotigt). 

Das  Highbyte  der  ermittelten  Zeitkonstante  gehort  dann  in  Write-Register  13.  Das  Lowbyte 
dementsprechend  in  Write  Register  12. 


Write-Register  14 

(Allgemeine  Steuerbits) 


In  diesern  Write  Register  finden  sich  unter  anderem  Steuerbits  fiir  den  Baudratengenerator  und 
die  Digital  Phase  Locked  Loop-Stufe  (DPLL). 


E 

6 

0 

0 

2 

n 

e 

T 


0  0  0 
0  0  1 
0  10 
Oil 
10  0 
10  1 
110 
111 


Baudratengenerator  ffeigeben 
Taktquelle  fiir  Baudratengenerator 
JDTR/_REQ-Auswahl 
Auto  Echo 

Lokale  Schleife  Sender  ->  Empfanger 
Null  Command 
Flanke  suchen 
Taktfehler-Flags  riicksetzen 
DPLL  abschalten 

DPLL-Taktquelle  =  Baudratengenerator-Ausgang 
DPLL-Taktquelle  =  RTxC-Anschlufi 
Taktriickgewinnung  aus  FM-codierten  Daten 
Taktriickgewinnung  aus  NRZI-codierten  Daten 


Taktquelle  fiir  Baudratengenerator 

Bei  gesetztem  Bit  wird  der  PCLK  des  SCC  als  Mastertakt  fiir 
den  Baudratengenerator  verwendet.  Bei  dem  im  TT/ 
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_DTR/_REQ-Auswahl 


Auto  Echo 


Lokale  Schleife  Sender 


FJanke  suchen 


MEGA  STE  benutzten  Takt  von  8  MHz  sind  damit  bei  einem 
Taktmodus  von  16  Baudraten  im  Asynchronmodus  bis  zu 
125000  Bit/s  erreichbar. 

Wenn  das  Bit  gelbscht  ist,  kommt  der  Takt  vom  RTxC-An- 
schluB.  Im  TT/MEGA  STE  liegt  fur  den  Kanal  A  an  RTxCA 
ein  3,762  MHz-Takt  an.  Der  Kanal  B  wird  an  RTxCB  vom  Ti¬ 
mer  C-Ausgang  des  TT-MFP  gespeist. 

Mit  diesem  Bit  wird  eingestellt,  ob  der  JDTR/_REQ-AnschluB 
des  SCC  als  Data  Terminal  Ready-Ausgang  (Bit  =  0)  oder  als 
Request- Ausgang  fiir  DMA-Betrieb  verwendet  wird  (Bit  =1). 
Im  TT/MEGA  STE  wird  die  DTR-Funktion  benutzt! 

Bei  gesetztem  Bit  wird  intern  der  Senderausgang  auf  den  Emp- 
fangereingang  geschaltet.  Der  Empfanger  reagiert  aber  weiter- 
hin  auf  Empfangsdaten  von  “auBen”.  CTS  als  Senderfreigabe 
wird  ignoriert. 

->  Empfanger 

Bei  gesetztem  Bit  werden  die  Sendedaten  sowohl  am  Aus- 
gangsanschluB  ausgegeben  als  auch  auf  den  Empfanger  zu- 
riickgefiihrt.  CTS  und  DCD  werden  ignoriert. 

Die  DPLL-Stufe  schal  tet  bei  gesetztem  Bit  in  einen  Suchmodus, 
mit  dem  sie  eine  Flanke  zum  “Einrasten”  im  ankommenden 
Datenstrom  sucht. 

Zur  einwandffeien  Betriebsweise  der  DPLL  muB  bei  NRZl- 
kodierten  Datenstromen  ein  Quellentakt  verwendet  werden, 
der  das  32fache  der  Datenrate  betragt.  Nachdem  eine  Datenflan- 
ke  erkannt  wurde,  schaltet  die  DPLL  auf  Normalbetrieb  urn 
und  justiert  sich  an  weiteren  Flanken  jeweils  nach. 

Bei  FM-kodierten  Datenstromen  wird  die  DPLL-Stufe  mit 
Quelltakten  “gefahren”,  die  das  16fache  der  Datenrate  aufwei- 
sen.  Wenn  weitere  Flanken  nicht  im  erwarteten  Taktraster 
gefunden  werden,  setzt  die  DPLL  entsprechende  Statusbits 
(“One  Clock  Missing”-  und  “Two  Clock  Missing”-Bit  in  Read 
Register  10).  Wird  zweimal  die  Datenflanke  an  der  erwarteten 
Position  nicht  mehr  erkannt,  wechseltdie  DPLL-Stufe  automa- 
tisch  wieder  in  den  “Flanke  suchen”-Modus. 
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Taktfehler-FIags  rilcksetzen  Mit  diesem  Kommando  werden  die  zuvor  erwahnten  “One 

Clock  Missing”-  und  “Two  Clock  Missing”-Bits  zuriickge- 
setzt. 

DPLL  abschalten  Die  DPLL-Stufe  wird  abgeschaltet,  die  “Clock  Missing”-Bits 

zuriickgesetzt  und  ein  Dauer-”Flanke  suchen”-Modus  einge- 
schaltet. 

Write-Register  15 

(Ext./Status-Interrupt-Steuerung) 

Wenn  Ext./Status-Interrupts  durch  Write-Register  1  eingeschaltet  sind,  wird  in  diesem  Write- 

Register  festgelegt,  welche  Zustande  einen  Interrupt  auslosen  konnen. 


Zugriff  auf  Write-Register  7’  ermoglichen 
Freigabe  fur  “Zero  count”-Interrupt 
lOfach  Frame-Status-FIFO  benutzen 
Freigabe  “Data  Carrier  Detect’-Interrupt  (DCD) 

Freigabe  fiir  SYNC/Suchmodus-Interrupt 
Freigabe  fur  “Clear  To  SeiuT-Interrupt  (CTS) 

Freigabe  fiir  Tx  Underrun/EOM-Interrupt 
Freigabe  fiir  Break/Abort-Interrupt 

Zugriff  auf  Write  Register  7’  ermoglichen 

Bei  gesetztem  Bitkann  im  SDLC/HDLC-Modus  auf  das  Write 
Register?’  mit  seinen  zusatzlichen  Moglichkeiten  zugegrif- 
fen  werden. 

Freigabe  fiir  “Zero  count”-Interrupt 

Bei  gesetztem  Bit  wird  ein  Interrupt  ausgelost,  wenn  der  Zahler 
im  Baudratengenerator  den  Wert  0  erreicht. 

lOfach  Frame-Status-FIFO  benutzen 

Bei  gesetztem  Bit  ist  im  SDLC/HDLC-Modus  der  lOfach 
Frame-Status-FIFO  eingeschaltet. 

Freigabe  “Data  Carrier  Detect”-Interrupt  (DCD) 

Bei  gesetztem  Bit  fiihrt  eine  Zustandsanderung  am  DCD- 
AnschluB  zu  einem  Interrupt. 
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Freigabe  fttr  SYNC/Suchmodus-Interrupt 

Bei  gesetztem  Bit  wird  im  Asynchronmodus  bei  einer  Zu- 
standsanderung  am  SYNC-AnschluB  des  SCC  ein  Interrupt 
ausgelost. 

Im  TT/MEGA  STE  wird  der  SYNC-AnschluB  bei  beiden 
SCC-Kanalen  fiir  die  Abfrage  der  “Data  Set  Ready  (DSR)”- 
Leitung  benutzt. 

Im  Synchron-Modus  erfolgt  eine  Interruptauslosung,  wenn  ein 
SYNC-Zeichen  Oder  Flag  im  Empfangsdatenstrom  erkannt 
wurde. 

Freigabe  fur  “Clear  To  Send”-Interrupt  (CTS) 

Bei  gesetztem  Bit  wird  ein  Interrupt  durch  Zustandsanderungen 
am  CTS-AnschluB  ausgelost. 

Freigabe  fiir  Tx  Underrun/EOM-Interrupt 

Wenn  im  Sender  das  Tx  Undermn/EOM-Flag  gesetzt  wird,  lost 
das  einen  Interrupt  aus. 

Freigabe  fiir  Break/Abort-Interrupt 

Bei  gesetztem  Bit  werden  Interrupts  ausgelost,  wenn  vom 
Empfanger  ein  Break  (Dauerlage  “0”)  im  Asynchronmodus 
oder  ein  Abort  (mindestens  sieben  Einsbits)  im  SDLC/HDLC- 
Modus  erkannt  wurde. 

Soviel  zu  den  Write-Registem  des  SCC. 


Read-Register 

Nun  kommen  die  Read  Register  an  die  Reihe,  die  dem  Programmierer  eine  Menge  an  Statusin- 
formationen  und  natiirlich  auch  die  empfangenen  Daten  liefem. 

Read-Register  0 

(Status  der  Sende-  und  Empfangsbuffer) 

In  diesem  Register  finden  sich  Flags  fiir  die  wohl  wichtigsten  Zustande  des  Sende-  und 
Empfangsteils  des  SCC  wieder.  Unter  anderem  findet  man  hier  auch  die  Flags  wieder,  die  als 
Quellen  fur  Ext./Status-Interrupts  fungieren. 
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Q 

6 

0 

0 

0 

0 

0 

0 

Min.  1  Empfangszeichen  kann  ausgelesen  werden 
Zahler  im  Baudratengen.  hat  Null  erreicht 
Senderegister  muB  “nachgeladen”  werden 
Zustand  des  DCD-Anschlusses  (0  =  High  / 1  -  Low) 
Zustand  des  SYNC-Pins/SYNC-Zeichen  erkannt 
Zustand  des  CTS-Anschlusses  (0  =  High  /  1  =  Low) 
Tx  Underrun/EOM  ist  aufgetreten 
Break  empfangen/Abort-Sequenz  empfangen 


Hier  noch  einige  zusatzliche  Eriauterungen  zu  bestimmten  Flags: 

Zahler  im  Baudratengen.  hat  Null  erreicht 

Wenn  im  Write  Register  15  der  "Zero  Count”-Interrupt  freige- 
geben  ist,  wird  dieses  Bit  so  lange  auf  “1”  gesetzt,  wie  im 
Abwartszahler  des  Baudratengenerators  der  Zahlerstand  Null 
existiert!Solangebleibtaucheine“ZeroCount”-Interruptanfor- 
derung  “stehen”.  Wenn  allerdings  zu  diesem  Zeitpunkt  bereits 
ein  anderer  Ext./Status-Interrupt  “anhangig”  (pending)  ist, 
wird  ein  “Zero  Count”-Interrupt  nur  dann  ausgelost,  wenn  die 
Interruptbedingung  (Abwartszahler  ist  auf  Null)  auch  nach  Be- 
endigung  der  gerade  laufenden  Interrupt-Service-Routine  noch 
besteht! 


Zustand  des  DCD-Anschlusses 

Wenn  der  DCD-Interrupt  (Bit  3  im  Write  Register  15)  nicht 
freigegeben  ist,  kann  iiber  dieses  Bit  der  Zustand  der  DCD-Lei- 
tung  abgefragt  werden  (0  =  High  /  1  =  Low). 

Ist  der  DCD-Interrupt  freigegeben,  wird  bei  einem  Ext./Status- 
Interrupt  der  Zustand  des  DCD-Anschlusses  zum  Interruptzeit- 
punkt  “eingefroren”  und  kann  durch  die  Interrupt-Service- 
Routine  abgefragt  werden.  Wenn  gerade  kein  anderer  Ext./ 
Status-Interrupt  “pending”  ist,  lost  ein  Zustandswechsel  am 
DCD-AnschluB  natiirlich  einen  entsprechenden  Interrupt  aus. 

Zustand  des  SYNC-Pins/SYNC-Zeichen  erkannt 

Bei  Synchronbetrieb  wird  dieses  Bit  durch  das  Kommando 
“Suchmodus  einschalten”  in  Write  Register  0  gesetzt.  Sobald 
der  Empfanger  dann  Zeichensynchronismus  erreicht  (durch 
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SYNC-Zeichen  Oder  Flags  im  SDLC/HDLC-Modus),  wird 
dieses  Bit  wieder  zuriickgesetzt.  Wenn  im  Write  Register  15 
“Freigabe  fur  SYNC/Suchmodus-Interupts”  eingestellt  ist, 
wird  bei  jeder  Anderung  dieses  Flags  ein  Ext./Status~Interrupt 
ausgelbst. 

Im  Asynchronbetrieb  signalisiert  dieses  Bit  den  Zustand  des 
SYNC-Anschlusses  des  jeweiligen  SCC-Kanals  (1  =  Low  /  0 
=  High  am  S  YNC-Pin).  Im  TT/MEGA  STE  laBt  sich  iiber  den 
SYNC-AnschluB  so  die  “Data  Set  Ready  (DSR)”-Leitung 
eines  MODEM  auswerten. 


Zustand  des  CTS-Anschlusses 

Dieses  Bit  reagiert  fur  den  CTS-AnschluB  des  SCC-Kanals 
genauso,  wie  sich  Bit  3  fur  den  DCD-AnschluB  verhalt. 

Tx  Underrun/EOM  ist  aufgetreten 

Dieses  Bit  ist  nach  einem  RESET,  bei  abgeschaltetem  Sender 
und  nach  einem  “Send  abort”-Kommando  gesetzt.  Ein  Riick- 
setzen  ist  nur  durch  das  “RESET  Tx  Underrun/EOM-Bit”- 
Kommando  in  Write  Register  0  moglich.  Sobald  dann  eine  Tx 
Underrun-Bedingung  auftritt,  wird  dieses  Bit  wieder  gesetzt 
und  ein  Ext./Status-Interrupt  ausgelost  (wenn  dieser  iiber  das 
Bit  6  im  Write-Register  15  eingeschaltet  wurde!). 

Break  empfangen/Abort-Sequenz  empfangen 

Im  Asynchron-Retrieb  wird  dieses  Bit  gesetzt,  wenn  ein  Break 
im  einlaufenden  Datenstrom  “gesichtet”  wurde  (ein  Zeichen, 
bei  dem  alle  Bits  Null  sind  und  kern  Stopbit  erkannt  wurde  = 
Framing  Error).  Dieses  Break  erzeugt  im  Empfangs-FEFO- 
Buffer  ein  einzelnes  “Nullzeichen”,  welches  ausgelesen  und 
verworfen  werden  sollte.  Mit  Ubergabe  des  “Nullzeichens”  in 
den  Empfangs-FIFO-Buffer  wird  dieses  Bit  allerdings  schon 
wieder  zuriickgesetzt!  Wenn  das  zugehorige  Enable-Bit  im 
Write  Register  15  gesetzt  ist,  wird  natiirlich  ein  Ext./Status- 
Interrupt  ausgelost. 

Im  SDLCIHDLC-Betrieb  wird  dieses  Bit  gesetzt,  wenn  eine 
Abort-Sequenz  (sieben  oder  mehr  Einsbits)  erkannt  wurde. 
Wenn  die  Abort-Sequenz  beendet  wird,  wird  dieses  Bit  wieder 
zuriickgesetzt.  Auf  jeden  Fall  wird  bei  eingeschalteter  “Break/ 
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Abort”-Freigabe  Bit  in  Write  Register  15  ein  Ext./Status- 
Interrupt  ausgelost,  egal  ob  bereits  ein  soicher  Interrupt  “an- 
hangig”  ist  oder  nicht! ! 


Read-Register  1 

(Special  Receive  Condition-Bits) 

Aus  diesem  Register  konnen  unter  anderem  die  Statusinformationen  zu  dem  parallel  im 
Empfangs-FIFO-Buffer  liegenden  Empfangszeichen  ausgelesen  werden. 


All  sent 

Residuen  Code  2 

Residuen  Code  1 

Residuen  Code  0 

Paritatsfehler 

Rx  Overrun 

CRC/Framing  Error 

End  of  Frame  (SDLC/HDLC) 


All  sent  Im  Asynchronbetrieb  wird  dieses  Bit  gesetzt,  wenn  alle 

Sendedatenbits  das  Sendeschieberegister  verlassen  haben. 

Residuen  Code  2,  1  und  0  Diese  Bits  sind  nur  im  SDLC/HDLC-Betrieb  interessant  und 

.  das  auch  nur  dann,  wenn  das  End  of  Frame-Bit  ebenfalls  gesetzt 
ist. 

Wenn  namlich  das  Datenfeld  eines  Frames  kein  ganzzahliges 
Vielfaches  der  eingestellten  Zeichenlange  (iiblicherweise 
acht  Bits)  ist,  werden  diese  Residuen  Bits  herangezogen,  urn 
zu  ermitteln,  wo  die  Grenze  zwischen  den  letzten  Bits  des  Da- 
tenfelds  eines  Frames  und  der  CRC-Priifbitfolge  liegt!  Emp- 
fangene  Datenbits  in  einem  Zeichen  werden  immer  rechts  ju- 
stiert! 

Die  folgende  Tabelle  zeigt  die  Zusammenhange  zwischen  den 
Residuen  Bits  und  der  Lage  der  Datenbits  in  den  letzten  gelese- 
nen  Zeichens  eines  Frames  fur  unterschiedliche  Zeichenlangen. 
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Res. 

Bits 

im  letzten  Byte  1 

Bits 

im  vorletzten 

Byte 

Bits 

im  drittletzten  Byte 

Bits 

8B 

7B 

6B 

5B 

8B 

7B 

6B 

5B 

8B 

7B 

6B 

5B 

0  1  2 

/z 

/z 

/Z 

/z 

/z 

/z 

/z 

/z 

/z 

/z 

/z 

/z 

100 
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0 

0 

0 

3 

1 

0 

0 

8 

7 

5 

2 

0  1  0 

0 

0 

0 

0 

4 

2 

0 

0 

8 

7 

6 

3 

1  10 

0 

0 

0 

0 

5 

3 

1 

0 

8 

7 

6 

4 

00  1 

0 

0 

0 

0 

6 

4 

2 

0 

8 

7 

6 

5 

101 

0 

0 

0 

0 

7 

5 

3 

1 

8 

7 

6 

5 

0  1  1 

0 

0 

0 

- 

8 

6 

4 

- 

8 

7 

6 

- 

1 1 1 

1 

0 

- 

- 

8 

7 

- 

- 

8 

7 

- 

- 

000 

2 

- 

- 

- 

8 

- 

- 

- 

8 

- 

- 

- 

Paritatsfehler 


Rx  Overrun 


Wenn  die  ParitStspriifung  eingeschaltet  ist,  wird  dieses  Bit  bei 
jenen  Zeichen  gesetzt,  die  ein  nicht  iibereinstimmendes 
Paritatsbit  aufweisen.  Wenn  ein  Paritatsfehler  auftrat,  bleibt 
dieses  Bit  auch  bei  alien  folgenden  Empfangszeichen  gesetzt 
(und  es  werden  evtl.  so  lange  Special  Condition-Interrupts  aus- 
gelost),  bis  rait  dem  Error  Reset-Kommando  dieser  Zustand 
geloscht  wird! 

Ein  gesetztes  Bit  zeigt  einen  Uberlauf  des  Empfangs-FIFO- 
Buffers  an.  Aber  nur  das  Zeichen,  fiir  den  dieser  Uberlauf  sig- 
nalisiert  wurde  ist  “iiberrannt”  worden.  AUerdings  bleibt  die 
Fehlerbedingung  fiir  alle  weiteren  Empfangszeichen  gesetzt, 
bis  ein  Error  Reset  ausgefiihrt  wird. 


CRC/Framing  Error  Im  Asynchronbetrieb  wird  durch  ein  gesetztes  Bit  ein  Framing 

Error  signalisiert.  Damit  wird  angezeigt,  daB  zu  einem  Emp¬ 
fangszeichen  kein  Stopschritt  (Bit)  empfangen  wurde.  Dieser 
Rahmenfehler  wird  nur  fiir  das  Zeichen  signalisiert,  bei  dem 
dieser  Fehler  auftrat  (also  nicht  bis  zu  einem  Error  Reset-Kom¬ 
mando  ge”Iatched”). 


Im  Synchronbetrieb  wird  dieses  Bit  gesetzt,  wenn  beim  Ver- 
gleich  der  augenblicklichenPriifbitfolge  in  der  CRC-Stufe  mit 
dem  festgelegten  OK-Priifmuster  keine  Ubereinstimmung  fest- 
gestellt  wurde.  Das  diirfte  meistens  der  Fall  sein,  aufier  wenn 
der  Datenblock  komplett  fehlerfrei  empfangen  wurde.  Das  Bit 
wird  auch  hier  nicht  gelatched  und  kann  jederzeit  mit  einem 
Error  Reset-Kommando  geloscht  werden.  Mit  jedem  neuen 
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empfangenen  Zeichen  wird  dieses  Bit  emeut  dem  Vergleich 
entsprechend  gesetzt.  Um  eine  korrekte  Statusaussage  iiber  die 
CRC-Priifung  zu  erhalten,  sollte  dieses  Bit  nur  in  Verbindung 
mit  dem  “End  of  Frame”-Bit  ausgewertet  werden. 

End  of  Frame  Im  SDLC/HDLC-Modus  wird  durch  ein  gesetztes  Bit  ange- 

zeigt,  wenn  ein  gQltiges  “Closing”-Flag  empfangen  wurde. 
Damit  sind  dann  auch  das  CRC/Framing  Error-Bit  und  die 
Residuen  Code-Bits  gliltig.  Mit  dem  ersten  empfangenen 
Zeichen  des  nachsten  Frames  wird  der  Zustand  dieses  Bits 
wieder  aktualisiert  (also  zuriickgesetzt!).  Ein  Riicksetzen  ist 
ebenfalls  mit  dem  Error  Reset-Kommando  moglich. 

Read-Register  2 
(Interrupt-Vektor) 

Aus  diesem  Register  kann  der  Interrupt-Vektor  ausgelesen  werden,  der  iiber  das  Write 
Register  2  in  den  SCC  eingeschrieben  wurde.  Dabei  gibt  es  jedoch  eine  Besonderheit  zu 
beachten: 

-  Wenn  dieses  Register  im  Kanal  B  ausgelesen  wird,  crhalt  man  den  aktuellen,  evtl.  durch 
Statusinformationen  veranderten  Interrupt-Vektor. 

-  Erfolgt  das  Auslesen  aus  dem  Kanal  A,  erhalt  man  lediglich  den  aktuell  dort  gespeicher- 
ten  Interrupt-Vektor  ohne  Statusbeeinflussung. 

Read-Register  3 

(Interrupt  Pending  Register) 

Hier  werden  alle  “anhangigen”  Interrupts  durch  ein  gesetztes  Bit  signalisiert.  Allerdings  kann 
dieses  Register  nur  vom  Kanal  A  ausgelesen  werden!  Im  Kanal  B  erscheinen  alle  Bits  als 
Nullbits. 


Ext./Status-Interrupt 

Kanal  B 

Senderinterrrupt 

<« 

Empfangsinterrupt 

u 

Ext./Status-Interrupt 

Kanal  A 

Senderinterrrupt 

£< 

Empfangsinterrupt 

0 

0 

it 

Seriell,  aber  schnell!  -  Der  SCC  macht’s  moglich 
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Read-Register  6 

(LSB  des  14  Bit-Zahlerstands  aus  Frame-Status-FIFO-Buffer) 

Wenn  der  SCC  im  SDLC/HDLC-Betrieb  arbeitet  und  Bit  2  im  Write  Register  15  gesetzt  ist, 
konnen  hier  die  untersten  8  Bits  des  an  oberster  Position  des  Frame-Status-FIFO-Buffers 
stehendenFrame-Byte-Zahlerstandesausgelesenwerden.DierestlichensechsZahlerstandsbits 
kommen  aus  Read  Register  7. 

Read-Register  7 

(MSB  des  14  Bit-Zahlerstands  aus  Frame-Status-FIFO-Buffer) 

Auch  dieses  Register  ist  nur  “zuganglich”,  wenn  im  Write  Register  15  das  Bit  2  gesetzt  ist. 
Die  unteren  sechs  Bits  dieses  Registers  enthalten  die  hochstwertigen  Zahlerstandsbits  aus  dem 
lOfach  Frame-Status-FIFO-Buffer. 

Ein  gesetztes  Bit  7  dieses  Registers  signalisiert  einen  Uberlauf  des  lOfach  Frame-Status- 
FIFO-Buffers. 

Wenn  Bit  6  gesetzt  ist,  kommt  die  Statusinformation  fur  den  Frame  aus  dem  FIFO-Buffer,  Bei 
Bit  6  =  0  kommt  die  Statusinformation  nicht  aus  dem  Zwischenbuffer  (der  ist  dann  noch  leer), 
sondem  direkt  aus  dem  Empfanger  (Read  Register  1)! 


Read-Register  10 

(Loop/Clock  Status) 


LL 

6 

5 

fT 

[31 

2 

a 

|  -  0 

On  Loop 

l - o 

I - - - —  o 

-  On  Loop  and  Sending 

- 0 

- —  Two  Clocks  Missing 

— — - - - -  One  Clock  Missing 

On  Loop  Dieses  Bit  ist  gesetzt,  wenn  sich  der  SCC  im  SDLC-Loop- 

Modus  befindet. 


On  Loop  and  Sending 


Dieses  Bit  wird  im  SDLC-Loop-Modus  dann  gesetzt,  wenn  der 
Sender  selbst  Daten  auf  den  Ring  ausgibt. 
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Two  Clocks  Missing  Wenn  die  DPLL-Stufe  im  FM-Modus  betrieben  wird  und  diese 

bei  zwei  Versuchen  keine  Datenflanke  erkannt  hat,  wird  dieses 
Bit  gesetzt.  Gleichzeitig  schaltet  die  DPLL  in  den  Suchmodus! 
DasBitbleibtdann  gesetzt, bisein“Taktfehler  Flags  riicksetzen”- 
oder  ein  “Flanke  suchen”-Kommando  iiber  Write-Register  14 
gegeben  wird. 

One  Clock  Missing  WenndieDPLL-StufeimFM-Modusbetriebenwirdunddiese 

keine  Datenflanke  an  der  Stelle  erkannt  hat,  wo  eigentlich  eine 
sein  miiBte,  wird  dieses  Bit  gesetzt.  Das  Bit  bleibt  dann  gesetzt, 
bis  ein  “Taktfehler  Flags  riicksetzen”-  Oder  ein  “Flanke  su- 
chen”-Kommando  iiber  Write-Register  14  gegeben  wird. 


Read-Register  12  und  13 

(Low-  und  High-Byte  der  Baudratengen.-Zeitkonstanten) 

AusdiesenbeidenRegistemkanndieiiber  Write-Register  12undl3eingestellteZeitkonstante 
fur  den  Abwartszahler  des  Baudratengenerators  ausgelesen  werden, 

Read-Register  15 

(Ext./Status-Interrupt-Freigabe-Bits) 

Die  iiber  das  Write-Register  15  eingesteliten  Freigabe-Bits  fur  Ext./Status-lnterrupts  konnen 
hieriiber  wieder  ausgelesen  werden.  Die  Beschreibung  der  einzelnen  Bits  kann  bei  Write- 
Register  15  nachgeschlagen  werden. 


E 

6 

0 

3 

3 

0 

i 

3 

1  r 

i 

t 

T 

1 -  Zugriff  auf  Write  Register  7’ 

-  Freigabe  fur  “Zero  counf’-Interrupt 

-  lOfach  Frame-Status-FEFO  benutzbar 

- Freigabe  “Data  Carrier  Detect”-Interrupt  (DCD) 

- Freigabe  fur  SYNC/Suchmodus-Interrupt 

1— - Freigabe  fiir  “Clear  To  Send”-Interrupt  (CTS) 

- Freigabe  fiir  Tx  Underrun/EOM-Interrupt 

- —  .  Freigabe  fiir  Break/Abort-Interrupt 

Die  Programmierung  des  SCC 


Die  Programmierung  des  SCC  mit  seinen  vielfaltigen  Moglichkeiten  muB  natiirlich  entspre- 
chend  sorgfaltig  vorgenommen  werden.  Aus  diesem  Grunde  hat  der  Hersteller  des  SCC  ein 
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bestimmtes  Schema  vorgeschlagen,  um  die  Mtialisierung  des  SCC  vorzunehmen.  Die 
Einstellung  des  SCC  erfolgt  dabei  in  einer  vorgegebenen  Reihenfolge  in  drei  Abschnitten. 

1 .  Einstellung  der  Betriebsmodi  wie  Bits/Zeichen,  Paritat.  AuBerdem  gehort  dazu  das  Vor- 
besetzen  der  einzelnen  Register  mit  Konstanten  (z,  B.  Interrupt-Vektor,  Zeitkonstante 
fiir  Baudratengenerator). 

2.  Im  nachsten  Schritt  erfolgt  die  Freigabe  der  einzelnen  Hardware-Funktionen.  Dazu  ge- 
hort  unter  anderem  die  Freigabe  fiir  Sender  und  Empfanger  sowie  Baudratengenerator 
und  DPLL.  Wichtig  ist  dabei,  daB  die  Betriebsmodi  vorher  eingestellt  wurden. 

3 .  Der  dritte  Abschnitt  ist  optional  und  nur  von  Bel  ang,  wenn  mit  Interrupts  gearbeitet  wird. 
Dazu  gehort  dann  die  Freigabe  der  benutzten  Interrupts. 

Nachfolgend  deshalb  das  Schema  fiir  die  Initialisierung  des  SCC.  Diese  Prozedur  ist  natiirlich 
fiir  jeden  Kommunikationskanal  durchzufiihren. 

Dabei  sind  jene  Register  besonders  gekennzeichnet,  deren  Programmierung  nicht  zwingend 
erforderlich  ist.  Alle  mit  einem  “X”  markierten  Bitpositionen  sind  dabei  vom  Programmierer 
einzustellen.  Ein  “S”-Bit  bedeutet,  daB  dieses  Bit  in  seinem  bereits  zuvor  eingestellten  Zu- 
stand  zu  belassen  ist. 


Betriebsmodi  und  Konstanten  einstellen 


Write 

Reg.#  Bitbelegung 


9 

W 

El 
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5 

E 
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B 

B 

X 

m 

B 
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7 

E 

B 
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11 
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E 

B 

B 

x~ 

B 

B 

m 

B 

13 

m 

B 

X 

B 

B 

m 

m 

14 

E 

B 

X 

B 

□ 

B 

B 

14 

E 

B 

D 

s" 

B 

B 

m 

m 

Aktion  Anm. 


Hardware  Reset  ausfiihren 
Tx/Rx-Cont.  Async/Sync-Modus 
W/_REQ  f.  DMA-Betrieb  einst.  opt. 
Int.-Vektor  programmieren  opt. 
Empf.-Parameter  einstellen 
Sender-Parameter  einstellen 
SYNC-Zeichen  programmieren  opt. 
SYNC-Zeichen  programmieren  opt. 
Master-Int.  Steuerung 
Div.  Tx/Rx-Einstellungen  opt. 
T  akteinstellungen 

BRG-Zeitkonstante  Low-Byte  opt. 
BRG-Zeitkonstante  High-Byte  opt. 
Allg.  Steuerbits  einstellen 
Verschiedene  Kommandos  opt. 
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Freigabe  der  Hardware-Funktionen 
Write 

Reg.#  Bitbelegung 


14 

3 

5 

0 

1 


in 

0 

0 

s 

s 

s 

s 

1 

s 

s 

s 

s 

s 

s 

s 

1 

S 

s 

s 

s 

1 

s 

s 

s 

1 

0 
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0 

0 

0 

0 

0 

x 

ls 

s 

0 

0 

s 

0 

0 

Aktion 


Anm. 


Baudratengen.  freigeben 
Empfanger  freigeben 
Sender  freigeben 

Tx  CRC-Gener.  zuriicksetzen  opt. 

DMA-Betrieb  freigeben  opt. 


Freigabe  der  Interrupts 
Write 

Reg.#  Bitbelegung  Aktion  Anm. 


15 

0 

0 

1 
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X 

X 

X 

X 

X 

X 

X 

X 

0 

0 

0 

1 

0 

0 

"1) 

0 

0 

0 

0 

1 

_Qj 

0 

0 

0 
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s 

X 

Tl 

s 

X 

X 

0 

0 

0 

s 

X 

s 

s 

s 

Ext./Status-Int.  selektieren 
Reset  Ext./Status-Int. 

Reset  Ext./Status-Int.  (nochmal!) 
RxyTx  +  Ext./Status-Int.  aktivieren 
“Hauptschalter”  fiir  Int.  auf  “Ein” 


Vor  der  Initialisierung  des  SCC  sollte  auf  jeden  Fall  ein  Reset  ausgefiihrt  werden.  Wenn  bereits 
ein  Kanal  initialisiert  ist,  braucht  natiirlich  fur  die  Initialisierung  des  zweiten  Kanals  kein 
erneuter  Hardware-Reset  durchgefiihrt  zu  werden.  Dazu  “reicht”  dann  ein  Kanal-Reset  fiir  den 
zweiten  Kanal! 


Betrieb  des  SCC  im  TT 

Auch  dem  SCC  hat  ATARI  fiir  den  schnellen  Datenaustausch  eine  eigene  DMA-Einheit  zur 
Seite  gestellt.  Verwendet  wird  ein  zweiter  Satz  mit  den  gleichen  DM  A-Chips,  wie  bereits  beim 
SCSI-Port  des  TT  beschrieben.  Allerdings  gilt  die  DMA-Untersttitzung  nur  fiir  den  Kanal  A 
des  SCC! 

SCC-DMA-Betrieb  ist  auch  hier  auf  jede  RAM-Adresse  mdglich.  Weil  die  grundsatzlichen 
Angaben  zu  den  DMA-Bausteinen  ja  bereits  bei  der  Beschreibung  des  SCSI-Ports  gemacht 
wurden,  soil  hier  nur  auf  die  Lage  der  SCC-DMA-Register  im  AdreGraum  eingegangen  wer¬ 
den. 


Seriell,  aber  schnell!  -  Der  SCC  macht’s  moglich 
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Die  SCC-DMA-Register 

Die  Registeradressen  des  SCC-DMA-Chips  liegen  sowohl  amoberenEnde  des  ST-AdreBraums 
($FF  8CXX)  als  auch  ganz  oben  im  TT- AdreBraum  ($FFFF  8CXX).  Angegeben  ist  hier  je- 
weils  die  Lage  im  ST- AdreBraum! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8C01 

R/W 

DMA- Address-Pointer  (Highest  Byte) 

“scdmabas” 

$FF  8C03 

R/W 

DMA-Address-Pointer  (High  Byte) 

“scdmabas”+2 

$FF  8C05 

R/W 

DMA- Address-Pointer  (Low  Byte) 

“scdmabas”+4 

$FF  8C07 

R/W 

DMA-Address-Pointer  (Lowest  Byte) 

“scdmabas”+6 

$FF  8C09 

R/W 

DMA-Bytezahler  (Highest  Byte) 

“scdmacnt” 

$FF  8C0B 

RAV 

DMA-Bytezahler  (High  Byte) 

“scdmacnt”+2 

$FF  8C0D 

R/W 

DMA-Bytezahler  (Low  Byte) 

“scdmacnt”+4 

$FF  8C0F 

R/W 

DMA-Bytezahler  (Lowest  Byte) 

“scdmacnt”+6 

Auch  hier  kann  fiir  den  Long-Zugriff  auf  diese  Register  in  Maschinensprache  ein  “movep.l”- 
Befehl  benutzt  werden! 


Adresse 

Zugriff 

Bezeichnung 

Label 

SFF8C10 

R 

Restdatenregister  (High-Word) 

“scdmarsd” 

$FF  8C12 

R 

Restdatenregister  (Low-Word) 

“scdmarsd”+2 

Wenn  am  SchluB  einer  DMA-Operation  kein  voller  Long  mehr  in  den  Speicher  ubertragen 
wurde,  muB  hier  der  Rest  an  Datenbytes  “per  Hand”  ausgelesen  und  durch  die  CPU  an  die 
richtigen  Adressen  gebracht  werden!  Wie  viele  Restbytes  das  sind,  erfahrt  man  aus  den  letzten 
beiden  AdreBbits  des  DMA- Address-Pointers. 

Die  Startadresse  n  fiir  die  Restbytes  ergibt  sich  aus  dem  Inhalt  des  DMA-Address-Pointers 
minus  der  Anzahl  an  Restbytes.  Die  Restbytes  sind  “linksbiindig”  im  Restdatenregister  ange- 
ordnet.  Also  gehort  das  Highbyte  im  High-Word  an  die  Startadresse  n.  Das  Lowbyte  im  High- 
word  kommt  nach  Startadresse  n+1  usw.! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8C14 

R/W 

Kontrollregister  (Word) 

“scdmactl” 

Obwohl  dieses  Register  mit  Wordzugdffen  bearbeitet  wird,  sind  nur  die  untersten  8  Bit  be¬ 
nutzt.  Man  kann  deshalb  auch  mit  By  tezugriffen  auf  die  Adr.  $(FF)FF  8C 1 5  arbeiten,  um  diese 
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Kontrollbits  zu  beeinflussen  bzw.  auszuwerten.  Hier  deshalb  nur  die  interessanten  unteren 
8  Bits  des  Registers: 


Bit  7 

6 

5 

4 

3 

2 

1 

0 

Bus 

Error 

Byte 

count 

zero 

Reser- 

viert 

Reser- 

viert 

Reser- 

viert 

Reser- 

viert 

DMA 

Enable 

DMA- 

Direct¬ 

ion 

Bus  Error  Ein  gesetztes  Bit  weist  auf  einen  Busfehler  wahrend  des  DM  A- 

Betriebs  hin.  Durch  Auslesen  dieses  Registers  wird  der  Bus- 
fehler-Status  wieder  zuriickgesetzt.  Diese  Fehlersignalisierung 
geht  auch  an  den  TT-MFP,  I/O-Port  #2  und  kann  bei  entspre- 
chender  Programmierung  einen  Intennpt  auslosen. 

Byte  count  zero  Ein  gesetztes  Bit  zeigt  an,  daB  der  DMA-Bytezahler  auf  Null 

gezahlt  hat,  also  alle  Bytes  transferiert  sind. 


DMA-Enable 


Bei  gesetztem  Bit  ist  der  DMA-Baustein  “eingeschaltet”. 


DMA-Direction  Bit  gesetzt:  Schreiben  an  SCC-Controller. 

Bit  geloscht:  Lesen  von  SCC-Controller. 


Um  DMA-Betrieb  durchzufiihren,  ist  zunachst  die  Transferrichtung  im  DMA-Baustein  (Bit 
0  in  “scdmactl”)  einzustellen.  AnschlieBend  wird  die  Basisadresse  im  DMA- Address-Pointer 
(“scdmabas”)  gesetzt  und  die  Zahl  der  zu  tibertragenden  Bytes  im  DMA-Bytezahler 
(“scdmacnt”)  eingestellt. 

Wenn  dann  auch  der  SCC-Controller  entsprechend  programmiert  ist,  wird  durch  Setzen  des 
“DMA-Enable”-Bits  in  “scdmactl”  der  DMA-ProzeB  gestartet. 


Die  hardwaremaBige  Einbindung  des  SCC  beim  TT 

Der  Schaltungsauszug  in  der  nachfolgenden  Abbildung  zeigt  die  hardwaremaBige  Einbindung 
des  SCC  beim  TT.  Mittels  des  XLAN-Signals  vom  Soundchip  kann  der  Kanal  A  des  SCC 
softwaregesteuert  auf  den  LAN-AnschluB  oder  den  SERIAL  2-AnschluB  (9pol.  SubD- 
Buchse)  geschaltet  werden.  Nach  neuesten  Infos  plant  ATARI  aber  hier  eine  Anderung,  die 
diese  Umschaltmoglichkeitevtl,  nicht  mehr  enthalt.  Vielmehr  soil  der  hierfiirbenutzte  Sound- 
chip- AnschluB  zusatzlich  am  Parallelport  zur  Verfiigung  gestellt  werden,  um  eine  einfachere 
AnschluBmoglichkeit  fur  handelsubliche  Scanner  zu  ermoglichen. 


Seriell,  aber  schnell!  -  Der  SCC  macht’s  moglich 
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Initialisierung  fiir  Asynchronbetrieb  (Poll-Betrieb) 

Nachfolgendes  “Mini”-Listing  zeigt  eine  Beispielinitialisiemng,  um  beim  TT/MEGA  STE 
den  SCC-Kanal  B  (Buchse  MODEM  2)  fur  Asynchronbetrieb  mit  38400  Bit/s  einzustelien. 

Dabei  wird  als  Sende-  und  Empfangstakt  der  2,4576  MHz-Takt  der  MFPs  fiber  den  TRxCB- 
Anschlufi  dem  SCC  zugefiihrt.  Durch  Einstellung  eines  Verhaltnisses  von  64  Taktimpulsen 
pro  Datenschritt  ergibt  sich  eine  Obertragungsgeschwindigkeit  von  38400  Bit/s. 


;  Beispielinitialisierung  des  SCC-Kanals  B  fur  Asynchronbetrieb 
;  ohne  Interrupts.  Sender  auf  Empfanger  "geschleift" ! 

;  Taktung  erfolgt  uber  TRxCB-AnschluR  mit  2,4576  MHz-MFP-Takt . 

;  Durch  Takt/Datenrate  =  64  ist  eine  Baudrate  von  38400  Bd  ein- 
;  gestellt. 

;  (H.-D.  Jankowski  /  Juli  '91  fiir  ATARI  TT/ST/STE  Profibuch) 

sccctljb  equ  $ffff8c85  ;  Controlreg.  fiir  SCC-B 

sccdat_b  equ  $ffff8c87  ;  Datenregister  "  SCC-B 


iniscc: 

lea 

lea 

lea 

move . w 
iniloop: 

move.b 
move .b 
dbra 
iniend: 


sccctl_b, aO 
sccdat_b, al 
initable,a2 
(a2)  +,  dl 

(a2)  +,  (aO) 
(a2)+, (aO) 
dl, iniloop 


i  Pointer  auf  SCC-Kontrolreg.  B 
;  Pointer  auf  SCC-Datenreg.  B 
;  Zeiger  auf  Tabelle  mit  Ini.-Daten 
;  Anzahl  Tabelleneintrage 

;  Initialisierungsdaten  aus  Tabelle 
;  lesen  und  in  SCC-B  schreiben. 


;  Diese  kleine  Routine  liest  lediglich  die  zu  sendenden  Zeichen 
;  ab  Adresse  "sendtxt"  ein  und  sendet  sie  uber  den  SCC-B  aus. 

;  Da  dieser  im  Schleifenbetrieb  gefahren  wird,  konnen  diese  so 
;  "ausgesendeten"  Daten  unmittelbar  wieder  eingelesen  werden. 

;  Es  erfolgt  z.  B.  keinerlei  Fehlerabf rage ! 

senden : 

lea  sendtxt, a3  ;  Zeiger  auf  Textanfang 


Seriell,  aber  schnell!  -  Der  SCC  macht’s  moglich 
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recv: 


send: 


lea 

buffer, a4 

F 

Zielbuffer  fur  empfangenen  Text 

move ,  b 

(aO),dl 

r 

Read  Register  0  auslesen 

btst 

#0,  dl 

F 

Rx  Buffer-Bit  testen 

beq.  s 

send 

F 

Mind.  1  Zeichen  da? 

move . b 

(al) ,  (a4)  + 

r 

Ja!  Zeichen  holen. 

beq.s 

rcvend 

} 

Wenn  Null  empfangen  wurde,  raus 

move.b 

(aO) ,dl 

} 

Read  Register  0  auslesen 

btst 

#2,dl 

i 

Tx  Buffer  empty-Bit  testen 

beq.s 

recv 

r 

Sendebuffer  leer? 

move.b 

bra.s 

(a3)  +,  {al) 

recv 

F 

Ja!  Zeichen  holen  und  ausgeben 

rcvend: 

rts 


■  data 


;  Tabelle  mit  Initialisierungsdaten  fur  SCC-Kanal  B 
initable : 


dc.w 

9 

/ 

Anzahl  Eintrage  in  Ini. -Tabelle 

dc.b 

$09, $C0 

r 

Hardware-Reset  ausfiihren 

dc.b 

$04, $CC 

r 

x64  Takt,  2  Stopbits,  No  Parity 

dc.b 

$03, $C0 

T 

Rx  8  Bits/Zeichen,  Rx  disabled 

dc.b 

$05, $60 

F 

Tx  8  Bits/Zeichen,  DTR,RTS,Tx  off 

dc.b 

$09, $00 

F 

Interrupts  abgeschaltet 

dc.b 

$0A, $00 

F 

NRZ-Modus 

dc.b 

$0B, $28 

F 

Tx  &  Rx  =  TrxC  =  Input 

dc.b 

$0E, $10 

F 

BRG  off,  loopback 

sccenabl : 

dc.b 

$03, $C1 

/ 

Rx  enable 

dc.b 

$05, $68 

F 

Tx  enable 

sendtxt : 

dc.b 

'Dies  ist  der 

zu  sendende  Text ! ! ! ' , 0 

.bss 

buffer: 

ds  .b 

50 

F 

Platz  fur  50  Ernpfangszeichen 

Kapitel  8:  Der  VME-BusanschluB 
beim  TT/MEGA  STE 
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Die  Atari-Computer  wurden  immer  wieder  wegen  fehlender  Erweiterungsmoglichkeiten  (z. 
B.  durch  Erweiterungskarten)  kritisiert.  Diesen  Kritikpunkt  hat  Atari  erstmals  mit  Vorstellung 
des  MEGA  ST  aufgegriffen  und  eine  Erweiterungsmoglichkeit  durch  den  Megabus  geschaf- 
fen  (siehe  dazu  auch  im  ST-Teil  im  Kapitel  “Die  Zentraleinheit”).  Hierbei  handelte  es  sich 
letztlich  um  einen  AnschluB,  an  dem  alle  MC68000er-Prozessorsignale  zur  Verfiigung  stehen. 

Beim  TT/MEGA  STE  wollte  man  dann  wohl  eine  einheitliche  Linie  finden  und  sich  nicht  auf 
die  MC68000-Signale  festbeiBen  (Schliefilich  hat  man  ja  im  TT  auch  eine  CPU  mit  ganz 
anderen  Moglichkeiten  und  z.  T.  auch  anderem  Signalverhalten  vor  sich).  Fiindig  geworden 
ist  Atari  dann  beim  VME-Bus,  der  ein  weitverbreiteter  Standardbus  in  der  Industrie  ist.  Zudem 
ahnelt  das  Verhalten  der  Steuer-  und  Quittungssignale  sehr  dem  der  Signale  der  Motorola- 
CPUs  (was  Wunder,  schlieBlich  kam  die  Initiative  zu  diesem  Bussystem  ja  von  dort). 

Also  findet  sich  im  TT/MEGA  STE  jetzt  eine  AnschluBmoglichkeit  fur  Erweiterungskarten 
nach  dem  VME-Bus-Prinzip.  Dazu  werden  von  zwei  50pol.  Pfostensteckverbindem  auf  der 
Hauptplatine  die  notigen  Signale  iiber  Flachbandkabel  zu  der  beim  VME-Bus  verwendeten 
96pol.  Federleiste  nach  DEN  41612,  Bauform  C,  gefiihrt.  Im  Gehause  des  Rechners  istPlatz 
(so  gerade!)  filr  eine  Einfach-Europakarte  (100mm  x  160mm). 


Das  VME-Buskonzept 

Der  VME-Bus  unterstiitzt  bei  Einfach-Europakartenformat  einen  24-Bit-AdreB-  und  einen 
1 6-Bit-Datenbus.  Durch  Ubergang  auf  ein  Doppel-Europakartenformat  kann  der  Bus  auf  voile 
32  Bit  fur  den  AdreB-  und  Datenbereich  erweitert  werden.  Dabei  werden  iiber  den  dann 
zusatzlich  erforderlichen  Steckverbinder  lediglich  die  noch  fehlenden  AdreB-  und  Daten- 
bussignale  gefiihrt.  Alle  anderen  Signale  sind  bereits  auf  der  Einfach-Europakartenversion 
verfiigbar,  Der  gesamte  VME-Bus  gliedert  sich  dabei  in  vier  Teilsysteme: 

-  Der  Daten-Transfer-Bus  (DTB)  verfiigt  iiber  alle  Daten-  und  AdreBleitungen  sowie  die 
filr  den  Datentransfer  erforderlichen  Steuer-  und  Quittungsleitungen. 

-  Uber  den  Arbitrations-Bus  laufen  alle  fur  die  Steuerung  eines  Multi-Master-Systems 
notwendigen  Signale. 


Der  Interrupt-Bus  stellt  die  Signalwege  fur  die  Behandlung  von  Unterbrechungen  zur 
Verfiigung. 
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-  Versorgungs-  und  Hilfsleitungen  bilden  die  restlichen  Signale  zur  Stromversorgung  und 

Fehlererkennung. 


Die  Steckerbelegung  des  96pol.  VME-Bus-Steckers  zeigt  die  nachfolgende  Liste. 


Alle  mit  einem  beginnenden  Signale  sind  low-aktiv! 


Pin-Nr. 

Reihe  a 

Reihe  b 

Reihe  c 

1 

DO 

J3BSY 

D8 

2 

D1 

J3CLR 

D9 

3 

D2 

_ACFA1L 

DIO 

4 

D3 

. BGOIN 

Dll 

5 

D4 

J3GOOUT 

D12 

6 

D5 

JBG1IN 

D13 

7 

D6 

_bgiout 

D14 

8 

D7 

_BG2IN 

D15 

9 

GND 

J3G20UT 

GND 

10 

SYSCLK 

_BG3IN 

_SYSFAIL 

11 

GND 

_BG30UT 

_BERR 

12 

_DS1 

J3R0 

_SYSRESET 

13 

_DS0 

_BR1 

JAVORD 

14 

_  WRITE 

_BR2 

_AM5 

15 

GND 

J3R3 

A23 

16 

_DTACK 

AMO 

A22 

17 

GND 

AMI 

A21 

18 

_AS 

AM2 

A20 

19 

GND 

AM3 

A19 

20 

JACK 

GND 

A18 

21 

JACKIN 

SERCLK 

A17 

22 

JACKOUT 

SERDAT 

A16 

23 

AM4 

GND 

A15 

24 

A7 

JRQ7 

A14 

25 

A6 

JRQ6 

A13 

26 

A5 

JRQ5 

A12 

27 

A4 

JRQ4 

All 

28 

A3 

JRQ3 

A10 

29 

A2 

JRQ2 

A9 

30 

A1 

JRQ1 

A8 

31 

-12  V 

+5V  (Stand  By) 

+12V 

32 

+5V 

+5V 

+5V 

Der  VME-BusanschluB  beim  TT/MEGA  STE 
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Daten-Transfer-Bus  (DTB) 

DerDTB  wird  asynchronbetrieben,  um  auch  Devices  mitunterschiedlichen  Geschwindigkei- 
ten  am  Bus  betreiben  zu  konnen.  AdreB-  und  Datenbus  sind  nicht  gemultiplext. 

Der  Datentransfer  zwischen  Sender  (Master)  und  Empfanger  (Slave)  lauft  nach  folgendem 
Schema  ab: 

-  Die  Giiltigkeit  einer  AdreBinformation  auf  dem  Bus  signalisiert  der  Master  durch  Akti- 
vierung  von  Address  Strobe  („AS). 

-  Uber  das  _WRITE-Signal  erfahrt  der  Slave,  ob  gelesen  (_WRITE = High)  oder  geschrie- 
ben  wird. 


Abb.  8.1:  Byte-Lesezyklux  auf  dem  Daten-Transfer-Bus 
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-  Bei  einem  Lesezugriffwhd  dem  Slave  liber  die  beiden  Data-Strobe-Leitungen  _DS0  und 
_DS1  mitgeteilt,  wenn  der  Master  zum  Einlesen  der  Daten  bereit  ist! 

Fur  einen  Schreibzugriff  werden  vom  Master  zunachst  die  Daten  auf  den  Datenbus 
plaziert  und  anschlieBend  diese  tiber  _DS0  und  „DS1  als  “giiltig”  erklart. 

-  Der  Bus  wird  vom  Master  erst  wieder  freigegeben,  wenn  vom  Slave  ein  _DTACK  (Data 
Transfer  Acknowledge)  empfangen  wurde.  Der  Slave  ‘  ‘fiihlt”  sich  so  lange  an  den  Master 
gebunden  (und  gibt  den  Bus  so  lange  auch  nicht  frei!),  wie  der  nicht  _DS0  und  _DS1 
wieder  deaktiviert  hat. 

Wenn  der  Slave  sich  “nicht  in  der  Lage  sieht”,  die  Schreib-ZLeseanforderung  korrekt  aus- 
zufiihren,  aktiviert  er  statt  _DTACK  das  Bus-Error-Signal  (_BERR).  Als  Reaktion 
darauf  wechselt  der  Master  in  eine  entsprechende  Fehlerbehandlungsroutine. 

Da  iiber  den  Datentransferbus  sowohl  Byte-,  Word-  (16  Bit)  und  auch  Langwort-Zugriffe 
(32  Bit)  abgewickelt  werden  konnen,  ist  eine  entsprechende  Signalisierung  der  Zugriffsart 
erforderlich.  Diese  erfolgt  iiber  die  Signale  _DS0  (Low-Byte)  und  _DS1  (High-Byte)  und  bei 
Langwort-Zugriffen  noch  zusatzlich  durch  das  _LWORD-Signal.  Zusatzlich  zu  den  AdreBlei- 
tungen  existieren  zur  Adreflverwaltung  noch  sechs  ”Address-Modifier’’-Leitungen  AMO..  AM5. 
Diese  zeigen  das  gleiche  Zeitverhalten  wie  die  AdreBleitungen  und  liefern  zusatzliche  Infor- 
mationen  iiber  die  anliegende  Adresse.  Folgende  Anwendungsfalle  lassen  sich  damit  signa- 
lisieren: 

-  Durch  entsprechende  AM-Codes  werden  drei  AdreBbereiche  unterschieden: 

Extended  Access  =  Zugriff  auf  den  vollen  32  Bit-Bereich 
Standard  Access  =  Zugriff  auf  einen  24  Bit-Bereich 
Short- Access  =  Zugriff  auf  einen  16  Bit-Bereich 

Speicherzugriffe  werden  durch  entsprechende  AM-Codes  in  Supervisor-  und  User- 
Speicherbereiche  unterschieden,  wie  man  das  ja  schon  von  den  Motorola-CPUs  her 
kennt. 

-  Unterscheidung  des  Speichers  in  Daten-  und  Programmbereich. 

Signalisierung,  ob  Speicher-  Oder  E/A-Zugriff  (Memory-Mapped  I/O!)  stattfindet. 

-  Spezielle  Formen  des  Speicherzugriffs,  indem  vom  Master  nur  die  Beginnadresse  des 
anzusprechenden  Speicherbereichs  geliefert  wird  und  die  darauf  folgenden  Adressen 
durch  Inkrementieren  der  Adresse  auf  dem  Slave  selbst  angesteuert  werden. 


Der  VME-BusanschluG  beim  TT/MEGA  STE 
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Die  nachfolgende  Tabelle  zeigt  die  Werte  fur  die  Address-Modifier  und  die  damit  ausgewahlte 
Funktion. 


AM-Code  in 

Hex. 

Binar 

Funktion 

3F 

111111 

Standard-Supervisory-Zugriff,  Inkrementell 

3E 

111110 

Standard-Supervisory-Zugriff,  Programmbereich 

3D 

11110  1 

Standard-Supervisory-Zugriff,  Datenbereich 

3B 

1110  11 

Standard-User-Zugriff,  Inkrementell 

3A 

1110  10 

Standard-User-Zugriff,  Programmbereich 

39 

1110  0  1 

Standard-User-Zugriff,  Datenbereich 

2D 

l  0  1  1  0  1 

Short-Supervisory-Zugriff,  E/A-Bereich 

29 

10  10  0  1 

Short-User-Zugriff,  E/A-Bereich 

OF 

0  0  1111 

Extended-Supervisory-Zugriff,  Inkrementell 

OE 

0  0  1110 

Extended-Supervisory-Zugriff,  Programmbereich 

OD 

0  0  110  1 

Extended-Supervisory-Zugriff,  Datenbereich 

OB 

0  0  10  11 

Extended-User-Zugriff,  Inkrementell 

OA 

0  0  10  10 

Extended-User-Zugriff,  Programmbereich 

09 

0  0  1  0  0  1 

Extended-User-Zugriff,  Datenbereich 

Die  nicht  aufgefiihrten  AM-Codes  sind  reserviert! 


Der  Arbitrations-Bus 

Damit  in  einem  Multiprozessorsystem  mehrere  Master  auf  den  DTB  zugreifen  konnen,  muG 
eine  gewisse  Absprache  zwischen  den  Mastem  fur  die  Busbenutzung  erfolgen.  Es  wird  also 
entschieden  (=  to  arbitrate),  welcher  Master  jeweils  den  Bus  benutzen  darf. 

Dafiir  gibt  es  in  Multiprozessorsystemen  einen  eigenen  “Schiedsrichter”,  den  Arbiter. 

Die  Anforderung  des  Busses  nimmt  ein  Master  iibcr  eine  der  vier  Bus-Request-Leitungen 
(_BR0.._BR3)  vor.  Jeder  dieser  vier  Request-Leitungen  ist  eine  eigene  Prioritat  zugeordnet 
( JBR3  ist  hochste  Prioritat).  Der  Arbiter  vergleicht  die  Prioritat  des  anfordemden  Masters  mit 
der  Prioritat  des  Masters,  der  gerade  den  Bus  kontrolliert. 

Hat  der  anfordemde  Master  eine  hohere  Prioritat,  sendet  der  Arbiter  ein  Bus-Clear-Signal 
(J3CLR),  urn  den  gegenwartigen  Busmaster  zur  schnellstmoglichen  Freigabe  des  Busses 
aufzufordem.  Dieser  reagiert  darauf  zum  nachstmoglichen  Zeitpunkt  (iiblicherweise  nach 
Beendigung  des  gegenwartigen  Buszyklusses)  durch  Deaktivierung  von  Bus-Busy  (JBBSY). 
Der  Arbiter  sendet  daraufhin  der  Einheit  mit  der  hochsten  anstehenden  Prioritat  ein  Bus- 
Freigabe-Signal  (Bus-Grant  =  JBG0.._BG3)  und  deaktiviert  _BCLR. 
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Wenn  der  anfordemde  Master  niedriger  priorisiert  ist  als  der  gegenwartige  Busmaster,  wird 
die  Busanforderung  erst  bedient,  wenn  der  Bus  frei  ist! 

Weil  nach  diesem  Schema  nur  vier  Busmaster  vom  Arbiter  verwaltet  werden  konnen,  hat  man 
noch  eine  zusatzliche  Prioritatsebene  vorgesehen.  Man  verwendet  hier  das  Prinzip  des  “Daisy- 
chaining”,  der  Prioritatsverkettung.  Das  bedeutet  in  der  Praxis,  dafi  der  physikalisch  am 
nachsten  zum  Arbiter  gelegene  Master,  mit  ansonsten  gleicher  Prioritat,  “bevorzugter” 
behandelt  wird!  Mit  wachsender  Entfemung  nimmt  die  “Bevorzugung”  ab.  Jede  der  vier 
Anforderungsebenen  BRO.  ,_BR3  hat  eine  eigene  “Daisy-Chain” .  In  der  Praxis  sieht  das  dann 
so  aus,  da6  das  Busfreigabe-Signal  _BG,  welches  dem  Bus  anfordemden  Master  die 
“Herrschaft”  iiber  den  Bus  zuweist,  vom  Arbiter  zum_BG#IN-Anschlu8  des  nachstgelegenen 
Masters  gefiihrt  wird.  Wenn  dieser  den  Bus  belegen  will,  gibt  er  das  Busfreigabe-Signal  JBG 
nicht  weiter;  andemfalls  aktiviert  er  JBG#OUT,  was  dann  zu  _BG#IN  des  nachsten  Masters 
fiihrt  usw.  Mittels  dieser  Technik  konnen  beliebig  viele  Master  auf  dem  VME-Bus  zusammen- 
arbeiten. 
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Abb.  8.2:  Block-Diagramm  zur  Bus-Arbitration 


Der  Interrupt-Bus 

Auch  hier  wird,  wie  beim  Arbitrations-Bus,  mit  unterschiedlichen  Prioritaten  gearbeitet.  Auf 
dem  VME-Bus  wird  zur  Auswahl  der  Interrupt-Service-Routine  im  Interrupt-Handler  mit 
Interruptvektoren  gearbeitet.  Die  Interrupt- Anforderung  erfolgt  liber  sieben  Interrupt-Request- 
Leitungen  _IRQ7 .  -_IRQ  1 ,  wobei  _IRQ7  die  hochste  Prioritat  zugeordnet  ist.  Mit  entsprechen- 
der  Maskierung  (z.  B.  durch  eine  Interruptmaske  bei  MC680XX-Prozessoren)  entscheidet  der 


Der  VME-BusanschluB  beim  TT/MEGA  STE 


1191 


Interrupthandler,  ob  der  Interrupt  zugelassen  wird  oder  nicht.  Um  auch  bei  nur  sieben  IRQ- 
Ebenen  eine  beliebige  Anzahl  von  Interruptquellen  gewichten  zu  konnen,  kann  wieder  mit  der 
schon  beim  Arbitrations-Bus  geschilderten  “Daisy-Chain”-Technik  gearbeitet  werden.  Dazu 
wird  das  Interrupt-Erkennungssignal  desInterrupthandlersvonModulzuModul  weitergereicht 
(an  JACKIN  rein  und  bei  JACKOUT  wieder  raus  zum  nachsten  Moduli),  bis  es  bei  jenem 
Modul  angekommen  ist,  dessen  Interrupt-Anforderung  bearbeitet  werden  soil. 

Die  Interrupt-Erkennung  erfolgt  durch  den  Interrupt-Handler  unter  Benutzung  des  DTB,  den 
der  Int.-Handler  sich  dazu  evtl.  vorher  vom  Arbiter  “zuteilen”  lassen  muB!  Wenn  der  Int.- 
Handler  den  DTB  “hat”,  aktiviert  er  Interrupt- Acknowledge  (JACK)  und  legt  den  Interrupt- 
Anforderungskode  (Priori  tat  von  1  ..7)  auf  A 1 . .  A3  des  AdreBbusses.  Der  nun  folgende,  norma- 
leLesezyklusliefertdannvon  demModul,dasdenInterruptangeforderthat,dieVektomummer. 


(7)  I  (ifi)  vom  Inlenuptrequesler/lnterrupthandler 
v  garantiertes  Zeitvnrhalten 

*  Low  (niedriger  Pegel)  ist  aktiver  Zustand 


Abb.  8.3:  Zeitverhalten  der  Inten  upterkennung 
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Diese  Vektomummer  darf  aber  erst  auf  den  Datenbus  (Low-Byte,  _DS0  aktiviert,  _DS1 
nicht!)  ausgegeben  werden,  wenn  das  den  Interrupt  anfordemde  Modul  auch  das  Signal 
JACK  des  Interrupt-Handlers  an  seinen  JACKIN-Anschlufi  Uber  die  “Daisy-Chain”  emp- 
fangen  hat.  Die  Interrupt-Service-Routine  wird  im  Interrupt-Handler  uber  die  Vektomummer 
berechnet  und  enthalt  die  zur  Interrupt-Bearbeitung  notigen  Befehle. 


Die  Hills-  und  Versorgungsleitungen 

Neben  den  Versorgungsspannungen  werden  uber  diesen  Teil  des  VME-Busses  noch  einige 
weitere  Hilfssignale  fiir  die  Initialisierung,  Synchronisation  und  zur  Fehlerdiagnose  gefiihrt. 

SYSCLK  ist  ein  16  MHz-Takt,  der  nicht  mit  dem  Prozessortakt  synchron  sein  muB.  Dieses 
Signal  kann  z.  B.  fiir  Zahleranwendungen  herangezogen  werden. 

SYSRESEJ'  dient  dem  Riickstellen  aller  Sy  stemmodule  in  einen  definierten  Anfangszustand. 
Es  kann  manuell  oder  vom  Netzteil  gesteuert  aktiviert  werden. 

SYSFAIL  kann  einen  Fehler  im  System  melden.  So  kann  ein  Modul  nach  einem  Systemreset 
und  einem  durchgefiihrten  (fehlerhaften)  Selbsttest  _S  Y SFAIL  nicht  wieder  deakti vieren  und 
so  einen  Fehlerzustand  melden. 

ACFA1L  signalisiert  einen  Fehler  in  der  Spannungsversorgung  (Spannungseinbruch).  Damit 
bleibt  dem  System  laut  VME-Bus-Spezifikation  noch  mindestens  4ms  fiir  eine  ordnungsge- 
mafie  Abbmch-Bearbeitung. 


Einschrankungen  beim  VME-BusanschluB  des  TT/MEGA  STE 

ATARI  verspricht  Kompatibilitat  zum  VME-Bus-Standard,  jedoch  mit  einigen  Ausnahmen. 

Bus-Arbitration  wird  nicht  unterstiitzt!  Alle  Bus-Request-Signale  _BR0.._BR3  sind  auf 
dem  Motherboard  miteinander  verbunden  und  mit  einem  lKfl  Pull-up-Widerstand  an 
+5V  “gebunden”.  Gleiches  gilt  auch  fiir  die  J3G0IN.._BG3IN-Signale!  _BBSY  und 
_BCLR  liegen  ebenfalls  jeweils  iiber  1KQ  an  +5  V  und  werden  anderweitig  nicht  benutzt. 

-  Der  serielle  Bus  mit  SERCLK  und  _SERDAT  ist  nicht  vorhanden. 

-  _SYSCLK  wird  mit  dem  16,107953  MHz-Systemtakt  gespeist. 

-  _ACFAIL  ist  low,  solange  die  Spannungsversorgung  nach  dem  Einschalten  noch  nicht 
stabil  lauft.  ATARI  verspricht  1ms  vor  dem  Verlassen  der  giiltigen  Spannungsbereiche 
eine  Aktivierung  von  _ACFAIL.  Das  Signal  ist  mit  1KQ  gegen  +5V  geschaltet. 
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J5YSRESET  ist  direkt  mit  dem  RESET-Signal  des  Motherboards  verbunden  ( 1 ,2KQ- 
Pull-up-Widerstand  gegen  +5  V).  Es  kann  sowohl  vom  Motherboard  (z.  B .  CPU)  als  auch 
von  einer  VME-Bus-Karte  aktiviert  werden. 

-  _BERR  ist  ebenfalls  direkt  mit  dem  Bus-Error-Signal  des  Motherboards  verbunden 
(l,2KQ-Pull-up~Widerstand  gegen  +5V).  “Sieht”  die  Uberwachungsschaltung  (in  der 
SCU)  auf  dem  Motherboard  255  Taktzyklen  (16  MHz-Takt!)  nach  Aktivierung  von 
_AS  kein  _DTACK,  wird  ein  Bus-Error  ausgelost! 

-  ATARI  verwendet  aktiv  nur  die  Address-Modifier  AMO,  AMI ,  AM2  und  AM4.  AM3 
und  AM5  liegen  iiber  1  KO-Widerstiinde  an  +5V.  Damit  ist  alles  bis  auf  Extended- 
Zugriffe  moglich ,  Inkrementelle  Zugriffe  (Blockzugriffe)  werden  aber  nicht  unterstiitzt! 
Da  nur  ein  16  Bit-Datenbus  am  ATARI-VME-Bus  zur  Verfilgung  steht,  wird  das 
JJWORD-Signal  nicht  benotigt.  Es  ist  mit  1KQ  gegen  +5V  abgeschlossen. 

Im  TT030  findet  sich  fur  Standard-Zugriffe  (24  Bit!)  der  VME-Bus-AdreBraum  bei 
$FE00  0000..$FEFEFFFF.FUrShort-ZugriffeliegtderAdreBbereichbei$FEFF  0000.. 
$FEFF  FFFF.  Im  MEGA  STE  liegt  der  24  Bit-AdreBraum  bei  $  AO  0000  bis  $DE  FFFF. 
Short-Zugriffe  “landen”  im  MEGA  STE  bei  $DF  0000..$DF  FFFF. 

-  Die  Interrupt-Request  Signale  JRQ1  .._IRQ7  sind  auf  dem  Motherboard  mit  je  einem 
lKD-Widerstand  gegen  +5V  abgeschlossen  und  konnen  verwendet  werden.  JRQ3, 
_IRQ5  und  _IRQ6  konnen  auch  vom  Motherboard  aktiviert  werden.  Ein  Level-7- 
Interrupt  kann  durch  das  JSYSFADL-Signal  (mit  lKQ-Pull-up  auf  Motherboard  abge¬ 
schlossen!)  einer  VME-Bus-Karte  ausgelost  werden.  JACK  und  JACKIN  werden  vom 
Motherboard  gesteuert  und  sollten  deshalb  nicht  von  einer  Karte  angesteuert  werden 
(TT/MEGA  STE  ist  Interrupthandler!).  Das  JACKOUT-Signal  wird  nicht  verwendet. 

Der  Interrupt-Vektor,  welcher  wahrend  des  Inteirupt-Acknowledge-Zyklus  von  einer 
VME-Bus-Karte  geliefert  wird,  ist  gleichzeitig  Interrupt-Vektor  fur  die  System-CPU! 
Atari  hat  den  Vektor  $FF  fur  sich  reserviert!  Fiir  Drittanbieter  empfiehlt  Atari  die  Inter- 
rupt-Vektoren  von  $80..$BF  und  damit  die  Vektor- Adressen  $200..$2FF.  Alle  VME- 
Bus-  und  System-Interrupts  sind  unabhangig  voneinander  in  der  System  Control  Unit 
(SCU)  maskierbar. 

Dann  gilt  noch  fiir  alle  Ausgange,  dafi  sie  mindestens  1  LS-TTL-Eingange  treiben  konnen 
(was  nicht  das  meiste  ist!).  Eingange  am  TT/MEGA  STE  belasten  den  VME-Bus  mit  nicht 
mehr  als  2  LS-TTL-Eingangslasten.  Die  Stromversorgungsanschliisse  des  VME-Bus-An- 
schlusses  haben  folgende  “Reserven”: 

+5V  bei  max.  2A 
+12V  bei  max.  50mA 
-12V  bei  max.  50mA 
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Kapitel  9:  Die  System  Control  Unit 
im  TT/MEGA  STE 


Zur  Uberwachung  des  Systems  auf  Bus-Errors/Interrupts  und  zur  Erzeugung  einiger  Chip- 
Select-Signale  (MFPs  und  FPU)  hat  ATARI  im  TT/MEGA  STE  einen  eigenen  Custom-Chip 
eingesetzt,  die  System  Control  Unit  (SCU).  Die  wichtigste  Funktion  der  SCU  im  System  diirfte 
wohl  die  Verwaltung  der  Interrupts  sein.  Im  Gegensatz  zum  ST  existieren  ja  bei  den  neuen 
Maschinen  mit  VME-Bus- AnschluB  einige  Interruptquellen  mehr,  die  verwaltet  werden  miis- 
sen.  AuGerdem  verfiigt  die  SCU  noch  iiber  einige  Register,  durch  deren  Beschreiben  Interrupts 
softwaregesteuert  ausgelost  werden  konnen. 


Interrupts  unter  Kontrolle 

Die  SCU  besitzt  zwei  voneinander  unabhangige  Mask-Register,  iiber  die  einstellbar  ist, 
weicher  Interrupt-Level  iiberhaupt  bis  zur  CPU  durchdringt. 


Systemboard-Interrupts 

Dabei  maskiert  das  “sys_mask”-Register  die  Interrupt-Anforderungen  vom  Systemboard. 
Dazu  gehort  ein  “sys_stat”-Register,  in  dem  die  Interrupt-Anforderungen  vom  Systemboard 
“bereitgehalten”  werden.  Die  Bits  dieses  Registers  zeigen  den  jeweiligen  Zustand  der  sieben 
moglichen  Interrupt-Anforderungen  an.  An  dieser  Stelle  ist  die  Maskierung  noch  nicht  wirk- 
sam,  d.  h.  alle  Interruptanfordemngen  setzen  ihr  zugehoriges  Bit! 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8E01 

RAV 

|  System  Int.  Mask-Register 

“sys_mask” 

Das  BitO  des  Registers  wird  nicht  verwendet.  Die  Bits  7..  I  bilden  die  Maske  fur  die 
Systeminterrupts.  Ein  gesetztes  Bit  zeigt  an,  daG  der  zugehorige  Interrupt  entsprechender 
Prioritat  an  die  CPU  weitergereicht  wird.  Bei  geloschtem  Bit  unterbleibt  eine  Interrupt- 
anfordemng  an  die  CPU.  Folgende  Systeminterruptquellen  sind  vorgesehen: 


Int.-Level 

Interrupt-Quelle 

Interrupt-Vektor 

7 

JSYSFAIL  von  VME-Bus 

Autovektor 

6 

IRQ  von  MFPs 

Programmierbar 

5 

IRQ  von  SCC 

Programmierbar 
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Int.-Level 

Interrupt-Quelle 

Interrupt-Vektor 

4 

VSYNC 

Autovektor 

3 

Nicht  vorhanden 

- 

2 

HSYNC 

Autovektor 

1 

System  Software-Interrupt 

Autovektor 

Im  TOS  3.01  wird  das  “sys_mask”-Register  mit  dem  Wert  $14  initialisiert.  Also  sind  alle 
Interrupt-Requests  bis  auf  VSYNC  und  HSYNC  maskiert! 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8E03 

R 

System  Int.  Status-Register 

“sys_stat” 

Auch  hier  wird  das  Bit  0  nicht  verwendet.  Die  anderen  Bits  stellen  direkt  den  je weiligen  Status 
der  IRQ-Anforderungen  dar  (gesetztes  Bit  =  IRQ  liegt  vor),  ohne  die  Maskierung  durch  das 
“sys_mask”-Register  zu  beriicksichtigen.  Dabei  gilt  die  gleiche  Zuordnung,  wie  bereits  beim 
“sys_mask”-Register  gezeigt.  Dieses  Register  sollte  vor  einem  Zugriff  auf  das  “sys_mask”- 
Register  ausgelesen  werden,  da  ein  Zugriff  auf  das  Mask-Register  die  Interrupt-Requests  im 
“sys_stat”-Register  zuriicksetzt! 


VME-Bus-Interrupts 

Fur  Interrupts  vom  VME-Bus  existiert  so  ein  Registersatz  ebenfalls  (“vme_mask”  und 
“vme_stat”).  Dabei  ist  allerdings  zu  beachten,  daB  die  System-Interruptanforderungen  5  und 
6  auch  auf  die  entsprechenden  IRQ-Leitungen  des  VME-Busses  aufgescha!  tet  sind  und  somit 
noch  zusatzlich  als  Interrupt-Requests  im  “vme_stat”-Register  anstehen! 

Damit  wird  erreicht,  dafi  ein  entsprechender  VME-Bus-Master  diese  Systeminterrupts 
ebenfalls  “bemerkt”  und  abarbeiten  kann!  Es  bedeutet  aberauch,  daB  diese  System-Interrupts 
fiir  die  CPU  wie  VME-Bus-Interrupts  “aussehen”  und  nicht  durch  ausschlieBliches  Maskieren 
im  “sys_mask”-Register  “unwirksam”  gemacht  werden  konnen. 

Ferner  laBt  sich  vom  System  softwaremaBig  ein  Interrupt  erzeugen,  der  als  _IRQ3  auf  dem 
VME-Bus  erscheint.  Dieser  Interrupt-Request  wird  natlirlich  ebenfalls  im  “vme_stat”-Regi- 
ster  “bemerkt”  und  kann  im  “vme_mask”-Register  maskiert  werden! 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8E0D 

R/W 

VME-Bus  Int.  Mask-Register 

“vme_mask” 
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Das  Bit  0  des  Registers  wird  wieder  nicht  verwendet.  Die  Bits  7..  1  bilden  die  Maske  fur  die 
VME-Bus-Interrupts.  Ein  gesetztes  Bit  zeigt  an,  daB  der  zugehorige  Interrupt  entsprechender 
Prioritat  an  die  CPU  weitergereicht  wird. 

Bei  geldschtem  Bit  unterbleibt  eine  Interruptanforderung  an  die  CPU. 

Folgende  VME-Bus-Interruptquellen  sind  vorgesehen: 


In  t. -Level 

Interrupt-Quelle 

Interrupt-Vektor 

7 

_IRQ7  von  VME-Bus 

Programmierbar 

6 

_.IRQ6  von  VME-Bus  bzw.  IRQ  von  MFPs 

Programmierbar 

5 

_IRQ5  von  VME-Bus  bzw.  IRQ  von  SCC 

Programmierbar 

4 

_IRQ4  von  VME-Bus 

Programmierbar 

3 

_IRQ3  von  VME-Bus  bzw.  durch  Software 

Progr./Autovek. 

2 

_IRQ2  von  VME-Bus 

Programmierbar 

1 

_IRQ1  von  VME-Bus 

Programmierbar 

Im  TOS  3.01  wird  dieses  Register  mit  $60  initialisiert.  Damit  sind  also  nur  der  _IRQ6  (MFP- 
IRQ)  und  der  _IRQ5  (SCC-IRQ)  freigegeben! 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8E0F 

R 

VME-Bus  Int.  Status-Register 

“vme_stat” 

Bit  0  ist  wieder  nicht  verwendet.  Die  anderen  Bits  stellen  wieder  den  jeweiligen  Status  der 
IRQ-Anforderungen  dar,  ohne  eine  evtl.  Maskierung  durch  das  “vme_mask”-Register  zu 
beriicksichtigen.  Es  gilt  die  gleiche  Zuordnung,  wie  beim  “vme_mask”-Register  gezeigt. 
Dieses  Register  sollte  vor  einem  Zugriff  auf  das  “vme_mask”-Register  ausgelesen  werden, 
da  ein  Zugriff  auf  das  Mask-Register  die  Interrupt-Requests  im  “vme_stat”-Register  zurtick- 
setzt! 


Software-Interrupts  durch  die  SCU 

Die  SCU  besitzt  zwei  Register,  durch  deren  Beschreiben  ein  Interrupt  ausgelost  werden  kann. 
Beide  Interrupts  werden  als  Autovektor-Interrupts  entsprechender  Prioritat  behandelt. 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8E05 

R/W 

System-Software-Int.  erzeugen 

“sysjnt" 
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Setzt  man  durch  Einschreiben  in  dieses  Register  das  Bit  0,  wird  ein  System-Interrupt-Request 
der  Prioritat  1  ausgelost.  Dieser  gelangt  natiirlich  nur  zur  CPU,  wenn  er  nicht  in  “sys_mask” 
ausmaskiert  ist.  Der  Pointer  auf  die  Autovektor-Serviceroutine  fur  diesen  Interrupt  steht  im 
RAM  in  Adresse  $64. 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8E07 

R/W 

VME-Bus-IRQ  Level  3  erzeugen 

“vine . jnt” 

Abb.  9.1:  Die  Einbindung  der  SCU  im  TTIMEGA  STE 
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Durch  Einschreiben  einer  $01  in  dieses  Register  wird  ein  System-Interrupt-Request  der  Prio- 
ritat  3  auf  dem  VME-Bus  ausgelost.  Dazu  muB  aber  im  “sys_mask”-Register  der  IRQ  3  freige- 
geben  sein!  Der  Pointer  auf  die  zugehorige  Autovektor-Serviceroutine  muB  dann  im  RAM  in 
Adresse  $6C  stehen. 

Generell  gilt  fiir  die  Interrupt-Behandlung  durch  die  SCU,  daB  bei  Interrupt-Requests  gleicher 
Prioritat  vom  Systemboard  und  vom  VME-Bus  der  Systeminterrupt  hoher  priorisiert  ist! 


Sonstige  Register  in  der  SCU 

Die  SCU  verfiigt  noch  liber  zwei  Universal-Register,  die  z.  B.  zur  Speicherung  von  Konfigu- 
rationswerten  fiir  das  System  benutzt  werden  konnen.  Diese  Register  sind  8  Bit  breit  und  an 
folgenden  Adressen  zu  finden: 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8E09 

R/W 

SCU  General  Purpose  Reg.  1 

“SCU  _gpl” 

$FF  8E0B 

R/W 

SCU  General  Purpose  Reg.  2 

“scu_gp2” 

Bei  einem  System-RESET  werden  alle  SCU-Register  geloscht! 
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Kapitel  10:  Der  Uhrenchip  im  TT 


Im  TT  verwendet  ATARI  einen  anderen  Uhrenchip  als  im  MEGA  ST/MEGA  STE.  Bei 
diesem  Uhrenchip  sind  zusatzlich  zu  den  Zeit-  und  Datumsfunktionen  noch  50  Bytes  an 
batteriegepuffertem  RAM  nutzbar.  Darin  lassen  sich  zum  Beispiel  Initialisierungswerte 
ablegen,  die  auch  nach  dem  Ausschalten  des  Systems  nicht  vergessen  werden.  Zur  “Verwal- 
tung”  dieses  “altemativen  Speicherbereichs”  hat  ATARI  sogar  eigene  Betriebssystemauftufe 
bereitgestellt. 

Verwendet  wird  der  Motorola-Uhrenchip  MC 1468 1 8 A,  der  sich  so  wohl  in  Mo-torola-  als  auch 
in  Intel-Prozessor-Umgebungen  betreiben  la  lit.  Die  Betriebsart  wird  iiber  den  Pin  1  (MOT) 
eingestellt. 

Eine  6V-Batterie  sorgt  fur  das  “Uberleben”  der  Daten  bei  ausgeschaltetem  Rechner.  Damit 
der  Takt  fur  den  “Wecker”  bei  ausgeschaltetem  Rechner  nicht  stehenbleibt,  wird  ein  eigener 
Oszillator  (auch  durch  Batterie  gepuffert)  mit  einer  Frequenz  von  32,768  kHz  benutzt. 


PHRGOOD  •*- 

Net  Z- 

tei  x 


XRTC 

von  HCU  -■ 
P.  100 


RTCftS  -* 

von  MCU-1 
P.112 


h+UCC 


STBV 

UCC 

CS 

CKFS 

AS 

PS 

DS 

RST 

R/M 

IRQ 

SQM 

AD6 

CKO 

XI 

AD3 

X2 

AD2 

ADI 

MOT 

ADO 

GHD 

IMC146818A1 


Bauelenente 
U402  a  14869 
Q401  =  2H3906 
0402  =  2H3984 


Abb.  10.1:  Die  hardwaremdfiige  Einbindung  des  TT-Uhrenchips 
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Ahnlich  dem  “alten”  Uhrenchip  z.  B.  im  MEGA  ST  besitzt  auch  dieser  Chip  einen  Recht- 
ecksignal-Ausgang,  bei  dem  die  Ausgangsfrequenz  softwaremaBig  eingestellt  werden  kann. 
Aber  auch  im  IT  verwendet  Atari  diesen  Ausgang  nicht.  Der  AnschluB  aber,  der  diesmal  be- 
nutzt  wird,  ist  der  _IRQ-AnschluB  des  Chips,  der  unter  bestimmten  Bedingungen  Interrupts 
auslosen  kann  (z.  B.  “Weckzeit  erreicht”!).  Im  TT  lauft  der  Low-Aktive  Intemiptausgang  des 
Uhrenchips  an  Port  16  des  TT-MFP  auf  und  kann  abgefragt  werden  oder  einen  Interrupt  aus¬ 
losen. 

Zugriffe  auf  das  RAM  und  die  Uhrenregister  erfolgen  als  Bytezugriffe  ahnlich  wie  beim 
Soundchip  in  zwei  Stufen.  Zuerst  wird  das  gewiinschte  Register  durch  Einschreiben  der  Regi- 
stemummer  in  “rtc_mr”  ausgewahlt.  AnschlieBend  kann  iiber  “rtc_data”  das  zuvor  adressierte 
Register  angesprochen  werden.  Nachfolgend  die  Adressen  der  beiden  Uhrenregister  (angege- 
ben  ist  nur  die  Lage  im  ST-Adre6raum;  weiter  “oben”,  also  bei  $FFPF  896X,  sind  sie  noch 
einmal  zu  finden!): 


Adresse 

Zugriff 

Funktion 

Label 

$FF  8961 

R/W 

Registerauswahl  im  Uhrenchip 

“rtcjnr” 

$FF  8963 

R/W 

Daten  des  selekt.  Uhrenregisters 

“rtc_data” 

Die  Register  des  Uhrenchips 

Neben  50  Bytes  an  batteriegepuffertem  RAM  existieren  noch  14  weitere  Uhrenregister  zur 
Darstellung  der  Uhrzeit/Datums  und  fur  z.  B.  Alarmzeit/Statusbits.  Die  Registerbelegung  des 
Chips  zeigt  die  Abbildung  10.2. 


Die  Zeit-  und  Datumsregister 

Dabei  gilt  sowohl  fur  die  Uhrzeit/Datumsregister  als  auch  fur  die  Alarmzeitregister,  daB  die 
Werte  im  Binarformat  oder  im  BCD-Format  verwendet  werden  konnen.  Die  Einstellung, 
welches  Format  benutzt  wird,  ist  iiber  das  “DM”-Bit  (Bit  2)  in  Register  $0B  vorzunehmen 
(Geloscht  =  BCD-Format).  Das  Datenformat  kann  nicht  wahrend  des  Betriebs  geandert  wer¬ 
den,  ohne  eine  Neuinitialisierung  der  Uhrenregister  vorzunehmen !  Das  TOS  arbeitet  mit  dem 
Binarformat. 

AuBerdem  laBt  sich  fiber  das  “24/12”-Bit  (Bit  1)  im  Register  $0B  festlegen,  ob  die  Zeit  im  24- 
Stunden  oder  1 2-Stunden-Format mit  AM/PM-Signalisierung  dargestellt  wird.  Wenn  das  “24/ 
12”-Bit  gesetzt  ist,  wird  der  24-Stunden-Modus  benutzt,  den  auch  das  TOS  verwendet.  Falls 
mit  12-Stunden-Darstellung  gearbeitet  wird,  erfolgt  die  AM/PM-Unterscheidung  iiber  das 


Der  Uhrenchip  im  TT 


1203 


-Nr 

Dez 

-Nr 

H«x 

: 

oez 

-Nr 

H<*x 

: 

^1 

QO 

0 

Sekunden 

ES 

B 

14  Bytes 
Uhrenre- 
gister 

1 

Sekunden  tAlarnJ 

m 

I 

m 

Minuten 

m 

13 

©D 

3 

Minuten  (fllarn) 

m 

I 

14 

BE 

\ 

4 

Sturtden 

m 

Werte  im 
Binar- 
oder  BCD- 
Fornat 

\ 

5 

Stunden  tAlarnJ 

m 

\ 

& 

Hochentag  senn+ag 

m 

50  Bytes 
batter ie- 

\ 

7 

Tagesdatun 

m 

\ 

a 

Monatsdatun 

B3 

tes  RAM 

\ 

s 

Jahresdatun 

/ 

\ 

Register  A 

a 

\ 

ID 

Register  B 

□ 

\ 

|Q 

Register  C 

m 

S3 

\ 

|Q 

Register  D 

m 

Abb.  10.2:  Die  Register  des  TT-Uhrenchips 


hochstwertigeBitderStundenregister(ZeitundAlarmzeit!),PM-Zeiten(~Nachmittagszeiten) 
werden  dutch  ein  gesetztes  Bit  7  in  den  Stundenregistem  (Zeit  als  auch  Alarmzeit!)  kenntlich 
gemacht! 


Alarmzeitregister 

Mit  Hilfe  der  drei  Alarmzeitregister  kann  eingestellt  werden,  wann  eine  Alarmsignalisierung 
(evtl.  auch  per  Interrupt)  erfolgen  soil.  Sobald  Alarmzeit  und  aktuelle  Zeit  iibereinstimmen, 
wird  ein  Alarmflag  (“AF”-Bit  =  Bit  5  in  Register  $0C)  gesetzt  und  abhangig  von  einem 
Enable-Bit  (“AIE”-Bit  =  Bit  5  in  Register  $0B)  ein  Interrupt  ausgelost.  Damit  lafit  sich  eine 
tagliche  Alarmsignalisierung  erreichen. 

liber  bestimmte  “Don’t  care”- Werte  (alle  Hex-Werte  von  $C0,.$FF  sind  solche  “Don’t  care”- 
Codes!)  in  den  Alarmzeit-Registem  lassen  sich  aber  z.  B.  auch  stUndliche,  miniitliche  oder  so- 
gar  sekundliche  Alarmsignalisierungen  erreichen.  Eine  “Don’t  care”-Kombination  bei  den 
Alarmzeit-Stunden  erzeugt  jede  Stunde  eine  Alarmierung.  Bei  “Don’t  care”  in  Alarmzeit- 
Stunden  und  -Minuten  “kommt”  der  Alarm  jede  Minute.  Wenn  alle  drei  Alarmzeit-Register 
mit  “Don’t  care”-Codes  versehen  sind,  erfolgt  jede  Sekunde  eine  Alarmierung. 


Die  Kontrollregister  des  Uhrenchips 

Mit  Hilfe  von  vier  Kontrollregistem  ($0A..$0D)  laBt  sich  das  Verhalten  des  Uhrenchips  be- 
einflussen  und  auswerten.  Im  Gegensatz  zu  den  Registem  $00..$09  sind  diese  vier  Register 
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auch  wahrend  des  sogenannten  “Update-Zyklus”  erreichbar.  Wahrend  des  jede  Sekunde 
einmal  stattfindenden  Update-Zyklus  erfolgt  im  Uhrenchip  die  “Weiterschaltung”  der  Zeit- 
und  Datumsregister  und  deren  Vergleich  mit  den  Alarmzeitregistem. 

Wahrend  dieser  Zeit  (maximal  2ms)  sind  die  Register  $00..$09  des  Uhrenchips  intern  abge- 
koppelt,  und  ein  Lesezugriff  darauf  liefert  keine  korrekten  Werte! 

Um  den  richtigen  Zeitpunkt  fur  einen  Zugriff  auf  die  unteren  zehn  Uhrenregister  zu  “erwi- 
schen”,  gibt  es  mehrere  Moglichkeiten. 

Am  Ende  eines  jeden  Updates  kann  ein  Interrupt  ausgelost  werden.  Wenn  dieser  “Update 
ended’  ’-Interrupt  aufgetreten  ist,  hat  man  anschlieBend  genug  Zeit  (min.  998ms ! ),  um  die 
gewunschten  Register  anzusprechen. 

Eine  weitere  Moglichkeit  liegt  in  der  Abfrage  des  “Update  in  Progress”-Bits  (UIP-Bit 
=  Bit  7  in  Register  $0A).  Bei  gesetztem  Bit  sollten  die  Zeit-/Datums-Register  “in  Ruhe 
gelassen  werden”. 

Wenn  das  Bit  einen  Wert  von  Null  aufweist,  hat  man  mindestens  noch  244us  “Zeit”  bis 
zum  riachsten  Update-Zyklus. 

Register  $0A 

Die  Bitbelegung  dieses  Registers  und  deren  Bedeutung  zeigt  nachfolgende  Tabelle: 


Bit  7 

Bit  6 

Bit  5 

Bit  4 

Bit  "3 

Bit  2 

Bit  1 

BitO 

UIP 

DV2 

DV1 

DVO 

RS3 

RS2 

RSI 

RSO 

UIP  Update  in  Progress  Ein  gesetztes  Bit  zeigt  einen  laufenden  oder  kurz  bevorstehen- 

den  Update-Zyklus  der  Zeit-/Datumsregister  an,  wahrend  dem 
ein  Zugriff  auf  diese  Register  keine  korrekten  Werte  liefert. 

Bei  geloschtem  Bit  sind  noch  mindestens  244ps  Zeit  bis  zum 
nachsten  Update.  Dieses  Bit  kann  nur  gelesen  werden! 

DV2,  DV1,  DVO  Divider-Steuerbits 

Diese  drei  Bits  werden  dem  Takt  des  Uhrenchips  entsprechend 
festgelegt.  Davon  ist  namlich  die  Programmierung  der  Teiler- 
stufen  fiir  die  Erzeugung  des  Sekundentakts  abhangig. 
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Taktfrequenz 

!  ; 

DV2 

i 

DV1 

' 

DV0 

Teiler  in 
Betrieb 

Teller 

Reset 

4,194304  MHz 

0 

0 

0 

Ja 

_ 

1,048576  MHz 

0 

0 

1 

Ja 

- 

32,768  kHz 

0 

1  1 

0 

Ja 

- 

Egal 

1 

1 

0 

Nein 

Ja 

Egal 

1 

1 

1 

Nein 

Ja 

Andere  Bitkombinationen  sind  nicht  zulassig! 

Da  Atari  mit  einem  32,768  kHz-T akt  arbeitet,  werden  die  D V- 
Bits  auf  “010”  gesetzt, 

RS3,  RS2,  RSI,  RSO  Rate-Select-Bits 

Uber  diese  vier  Bits  laBt  sich  prograramieren,  in  welchen  zeit- 
lichen  Abstanden  ein  periodischer  Interrupt  ausgelost  werden 
kann. 

AuGerdem  wird  dadurch  gleichzeitig  die  Ausgangsfrequenz 
des  Rechtecksignals  am  SQW-Ausgang  (im  TT  nicht  verwen- 
det!)  eingestellt. 

Betrachtet  man  die  vier  Rate-Select-Bits  als  eine  vierstellige 
Binarzahl  mit  RS3  als  hochstwertigem  Bit,  so  berechnen  sich 
die  Ausgangsfrequenz  fur  den  SQW-Ausgang  und  die  Zeit- 
abstande  zwischen  zwei  periodischen  Interrupts  wie  folgt. 

Mit  RS  =  8  x  RS3  +  4  x  RS2  +  2  x  RSI  +  RSO  ergibt  sich: 


32768  Hz 

SQW-Freq.  =  - 

2<Rs-n 


1 


INT-Zeit  = 


SQW-Frequenz 
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Register  $0B 

Alle  Bits  dieses  Registers  konnen  beschrieben  und  ihr  aktueller  Zustand  ausgelesen  werden. 


Bit  7 

Bit  6 

Bits 

Bit  4 

Bit  3 

Bit  2 

Bit  1 

Bit  0 

SET 

PIE 

AIE 

UIE 

SQWE 

DM 

24/12 

DSE 

Bei  geloschtem  Bit  arbeitet  der  Uhrenchip  in  gewohnter  Weise 
mit  einem  Update-Zyklus  pro  Sekunde.  Durch  Setzen  des  Bits 
wird  ein  evtl.  Update-Zyklus  unterbrochen  oder  gar  nicht  erst 
zugelassen,  urn  in  Ruhe  eine  Initialisierung  der  Zeit-/Datum- 
Register  vomehmen  zu  konnen. 

Bei  gesetztem  Bit  werden  periodische  Intemipts  in  einem 
zeitlichen  Abstand,  der  durch  die  RS3..RS0-Bits  bestimmt 
wird,  ausgelost.  Zur  Signalisierung,  daB  ein  periodischer  Inter¬ 
rupt  aufgetreten  ist,  wird  im  Register  $0C  durch  ein  gesetztes 
PF-Bit  angezeigt. 

Die  Funktion  dieses  Bits  ist  ahnlich  dem  vorgenannten  PIE- 
Bit.  Bei  gesetztem  Bit  wird  ein  Interrupt  ausgelost,  wenn  die 
aktuelle  Zeit  die  Alarmzeit  erreicht  (unter  Beriicksichtigung 
von  “Don’t  care”-Werten  in  den  Alarmzeitregistem).  Die  Si¬ 
gnalisierung,  daft  der  Interrupt  ein  Alarmzeit-Interrupt  ist,  er- 
folgt  iiber  ein  gesetztes  AF-Bit  im  Register  $0C. 

UIE  (Update  ended  Interrupt  Enable) 

Freigabebit  fiir  den  Update-ended  Interrupt  (Bit  gesetzt  = 
Interrupt  ist  freigegeben).  Die  Interrupt-Service-Routine  er- 
kenntdann  durch  ein  gesetztes  UF-Bit  in  Register  $0C,  dab  die 
Bedingung  “Update  beendet”  die  Quelle  dieses  Interrupts  ist. 

SQWE  (Square-Wave-Output  Enable) 

Mit  gesetztem  Bit  wird  der  SQW-Ausgang  des  Uhrenchips 
freigegeben  und  liefert  ein  Rechtecksignal  der  Frequenz,  die 
mit  den  RS0..RS3-Bits  in  Register  $0A  eingestellt  ist.  Bei 
geloschtem  Bit  ist  der  SQW-Ausgang  auf  Low. 

DM  (Data  Mode)  Bei  gesetztem  Bit  wird  in  den  Zeit-  und  Datumsregistem  mit 

Binarwerten  gearbeitet.  Bei  geloschtem  Bit  erwartet  und  liefert 


SET 


PIE  (Periodic  Int.  Enable) 


AIE  (Alarm  Int.  Enable) 
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der  Uhrenchip  die  Werte  im  BCD-Format.  Ein  zwischenzeit- 
licherModuswechselverlangtauchimmereineNeu-Initialisie- 
rungdes  Uhrenchips,  dadieserkeineeigeneUmrechnungsfunk- 
tion  besitzt. 

24/12  Wenn  das  Bit  gesetzt  ist,  wird  im  24-Stunden-Modus  gearbei- 

tet,  sonst  im  12-Stunden-Modus.  Die  Anzeige  fiir  “Nachmit- 
tagszeit”  (PM- Anzeige)  erfolgt  durch  ein  gesetztes  hochstwerti- 
ges  Bit  in  den  Stundenregistem. 

DSE  (Daylights  Savings  Enable) 

Hiermit  kann  der  Uhrenchip  “angewiesen”  werden  (durch  ein 
gesetztes  Bit!),  Sommer-  und  Winterzeit  automatisch  umzu- 
schalten.  Wenn  diese  Funktion  eingeschaltet  ist,  springt  die 
Uhrzeit  am  letzten  Aprilsonntag  von  01:59:59  auf  03:00:00. 
Entsprechend  wird  am  letzten  Sonntag  im  Oktober  von  01 :59:59 
auf  01 :00:00  gewechselt! 

Register  $0C 


Alle  Bits  dieses  Registers  sind  Statusbits  und  konnen  nur  ausgelesen  werden.  Nach  einem 
Lesezugriff  werden  die  Flags  wieder  zuriickgesetzt! 


Bit  7 

Bit  6 

Bit  5 

Bit  4 

Bit  3 

Bit  2 

Bit  1 

BitO 

IRQF 

1  PF 

AF 

UF 

0 

0 

0 

0 

IRQF  Int.  (Request  Flag)  Dieses  Bit  wird  gesetzt,  sobald  einer  derfreigegebenen  Inteirupts 

auftritt. 


PF  (Periodic  Int.  Flag)  Abhangig  von  der  Einstellung  der  RS0..RS3-Bits  im  Regi¬ 
ster  $0A  wird  in  bestimmten  zeitlichen  Abstanden  dieses  Bit 
gesetzt.  Wenn  der  zugehorige  Interrupt  freigegeben  ist  (d.h. 
Bit  PIE  im  Register  $0B  gesetzt),  wird  dazu  ein  Interrupt 
ausgelost,  der  durch  ein  gesetztes  IRQF-Bit  in  diesem  Register 
angezeigt  wird. 

Ein  gesetztes  AF-Bit  zeigt  an,  dab  die  aktuelle  Zeit  die 
eingestellte  Alarmzeit  (unter  Beriicksichtigung  von  evtl.  “Don’t 
care”-Einstellungen  in  den  Alarmzeitregistem!)  erreicht  hat. 
Wenn  das  zugehorige  AIB-Bit  im  Register  $0B  ebenfalls  ge- 


AF  (Alarm  Int.  Flag) 
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setzt  ist,  wird  auch  ein  Interrupt  ausgelost,  der  dann  auch  durch 
ein  gesetztes  IRQF-Bit  signalisiert  wird. 

UF  (Update  ended  Int.  Flag)  Nach  jedem  Update-Zyklus  wird  dieses  Bit  gesetzt.  Wenn  der 

zugehorige  Interrupt  freigegeben  ist  (=  Bit  UIEin  Register  $0B 
gesetzt),  erfolgt  ebenfalls  ein  Interrupt,  der  zusatzlich  tiber  ein 
gesetztes  IRQF-Bit  angezeigt  wird. 

Register  $0D 

Nur  das  Bit  7  dieses  Registers  ist  belegt  und  dient  als  Statusbit.  Das  Register  kann  nur  ausge- 

lesen  werden. 


Bit  7 

Bit  6 

Bit  5 

Bit  4 

Bit  3 

Bit  2 

Bit  1 

BitO 

VRT 

0 

0 

0 

0 

0 

0 

0 

VRT  (Valid  RAM  and  Time)  Dieses  Bit  zeigt  die  Gultigkeit  der  Daten  im  Uhrenchip  an.  Es 

ist  auf  Null,  wenn  derPS-AnschluBaufLowliegt(beiausgeschaI- 
tetem  TT  und  kurz  nach  dem  Einschalten  der  Fall).  Der  Prozes- 
sor  kann  dieses  Bit  durch  einen  Lesezugriff  auf  dieses  Register 
setzen,  wenn  Datum/Zeit  und  R  AM-Inhalte  korrekt  initialisiert 
wurden.  Durch  Testen  dieses  Bits  nach  dem  Einschalten  des 
Systems  kann  der  Prozessor  feststellen,  ob  die  Daten  noch  giil- 
tig  sind. 


Die  Programmierung  des  TT-Uhrenchips 

Als  Beispiel  fur  die  Programmierung  des  Uhrenchips  des  TT  soil  das  nachfolgende  Listing 
dienen.  Es  handelt  sich  dabei  um  disassemblierte  Routinen  aus  dem  Original  TOS  3.01.  Die 
ausgefiihrten  Aktionen  sind  jeweils  kommentiertund  zeigen  letztlichdas  Setzen  derZeit-/Da- 
tumswerte  im  Uhrenchip  mit  Ausgangswerten  im  GEMDOS-Zeit-/Datumsformat. 


Folgende  Routinen  stammen  aus  dem  TOS  3.01  und  demonstrieren,  wie 
Atari  die  Initialisierung  (das  Stellen)  des  Uhrenchips  durchfiihrt 


Par amete ruber gabe  fur  RTC-Chip  als  Long  auf  dem  Stack 
[bei  4(a7)]  im  GEMDOS-Format! 
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setrtc: 


bsr 

chkrtc 

bcs 

seterr 

move . 1 

4 (a7) ,d0 

move.b 

#$B, rtc_rnr 

move . b 

#$80,rtc  data 

move.b 

#$A, rtc_rnr 

move.b 

#$2A, rtc_data 

move . b 

#$B,  rtc_rnr 

move . b 

#$8E, rtc_data 

move.b 

#0,rtc  rnr 

BFEXTU 

dO  {27 : 5 ) ,  dl 

add.b 

dl,dl 

move.b 

dl , rtc  data 

move . b 

#2,rtc  rnr 

BFEXTU 

d0{21:6),dl 

move . b 

dl,rtc  data 

move.b 

#4, rtc  rnr 

BFEXTU 

d0{l6:5},dl 

move . b 

dl, rtc_data 

move.b 

#7,  rtc__rnr 

BFEXTU 

d0{ll:5},dl 

move.b 

dl, rtc_data 

move.b 

#8,  rtc  rnr 

BFEXTU 

dO  { 7  : 4 ) ,  dl 

move.b 

dl, rtc_data 

move .b 

#9, rtc_rnr 

BFEXTU 

dO  { 0 : 7 } , dl 

add.b 

#$A,  dl 

move . b 

dl,rtc  data 

move .  b 

#$B,rtc  rnr 

move.b 

rts 

#$E, rtc_data 

;  Fehler  (-1)  in  dO  zuruckliefern ! 


;  Zugriff  auf  RTC  versuchen 
;  RTC  vorhanden? 

;  Ja!  Parameter  nach  dO  holen 
;  In  Register  B  SET-Bit  auf  1,  um 

;  Update-cycle  zu  unterbrechen ! 

;  In  Reg.  A  auf  32  kHz-Timebase 
;  und  Period-Int.  auf  15,625  ms 
;  In  B-Reg.  SQWE-,  DM-,  und 
;  24-hour-Bit  setzen. 

;  Reg.  0  ansteuern 
;  Sekunden-Wert  (Bits  0..4)  aus 
;  Parameterdaten  verdopp.  und 
;  in  SEKUNDEN-Reg .  eintragen 
;  Minuten-Wert  (Bits  5.. 10)  aus 
;  Parameterdaten  holen  und 
;  in  MINUTEN-Reg .  eintragen. 

;  Stunden-Wert  (Bits  11..  15)  aus 
;  Parameterdaten  holen  und 
;  in  STUNDEN-Reg.  eintragen. 

;  Tagesdatum  (Bits  16. .20)  aus 
;  Parameterdaten  holen  und 
;  in  TAGESDATUM-Reg.  eintragen 

;  Monatsdatum  eintragen 


;  Jahresdatum  +10  eintragen 


;  RTC  ist  initialisiert ! 


seterr : 


moveq  #$FF,dO 
rts 
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;  Testroutine  fur  Zugriff  auf  RTC-I/O-Bereich.  Wenn  RTC  nicht  vor- 
;  handen  ist,  wird  eine  eigene  Bus-Error-Routine  angesprungen  und 
;  dort  dann  das  Carry-Flag  gesetzt  (=  keine  RTC  vorhanden!) . 

/ 

chkrtc: 


movea . 1 

a7,  aO 

;  Stackptr.  in  aO  merken 

movea . 1 

8,  al 

;  Buserror-Ptr.  nach  al 

move . 1 

#rtcberr, $00000008 

;  Buserror-Ptr.  auf  Adr. 

;  $E02372  setzen 

move.b 

#0, rtc_rnr 

;  Zugriff  auf  Sekundenregister 

move.b 

rtc  data,d0 

;  Wenn  die  Routine  bis  hierhin 

move . 1 

al,  8 

;  kommt,  gibt  es  auch  die  RTC! 

andi 

rts 

#$FE, ccr 

;  Also  Buserror-Ptr.  restoren 
;  und  mit  Carry-Clear  zuriick! 

;  Die  folgende  Routine  fangt  eine  Bus-error-Exception  ab,  wenn  auf 
;  den  RTC-  I/O-Bereich  zugegriffen  wird,  ohne  dafi  eine  RTC  vorhan- 
;  den  ist! 

r 

rtcberr : 

movea.l  a0,a7 
move .1  al ,  8 

ori  #l,ccr 

rts 


;  Stackptr.  restoren 
;  Alten  Buserror-Ptr .  restoren 
;  Carry-Bit  setzen  (=  No  RTC!) 
;  Und  raus  hier! 
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Auf  die  neuen  Komponenten  und  Hardware-Eigenschaften  des  TT  wurde  ja  in  den  vorigen 
Kapiteln  bereits  eingegangen.  Dabei  wurden  jedoch  nur  jene  Funktionsgruppen  behandelt,  die 
“anders”  als  beim  “normalen”  ST/STE  sind.  Natiirlich  finden  sich  bereits  von  der  ST-Serie 
her  bekannte  (und  beschriebene)  Bausteine  und  Funktionsgruppen  ebenfalls  im  TT  wieder. 
Auf  diese  Funktionsgruppen  soil  deshalb  nicht  nochmal  in  besonderen  Kapiteln  eingegangen 
werden,  sondem  diese  werden  in  diesem  Kapitel  noch  kurz  angesprocben.  Informationen  zu 
der  prinzipiellen  Funktionsweise  finden  sich  in  den  entsprechenden  ST-Hardware-Kapiteln. 


DieACIAs  im  TT 

sind  von  der  Funktion  und  Beschaltung  her  gleich  mit  denen  des  ST!  So  ist  die  Anbindung  der 
MIDI-Schnittstellen  und  der  Tastatur  identisch  mit  der  beim  MEGA  ST. 

Die  Tastatur  mit  ihrem  Tastaturprozessor  verhalt  sich  genau  wie  die  MEGA  ST-Tastatur.  So 
kann  man  ohne  Probleme  die  MEGA  ST-Tastatur  am  TT/MEGA  STE  betreiben  und 
umgekehrt.  Auch  beim  TT  existiert  keine  Reset-Leitung  mehr  zur  Tastatur  hin.  Die  Folge  ist 
dann  auch  hier,  daB  bei  einem  Tastatur-”Absturz”  ein  “echter  Hardware-Reset”  ausgefiihrt 
werden  muB  (Rechner  aus-  und  nach  einer  kurzen  Zeit  wieder  einschalten!),  um  die  Tastatur 
wieder  zur  Arbeit  zu  bewegen.  Auch  der  “Trick”,  bei  gedriickter  Maustaste  den  Rechner  einzu- 
schalten,  fiihrt  (wie  gewohnt)  zu  einem  unmoglich  konfigurierten  Tastaturprozessor,  mit  dem 
ein  Arbeiten  nicht  moglich  ist  (siehe  auch  im  ST-Hardware-Teil  “Die  ACIAs  im  ST”). 


Der  PSG  im  TT 

AuchimTT/MEGA  STEwirdderYM  2149(AY-5-8910imMEGA  STE)alsSoundchipund 
Parallelport  benutzt.  Das  davon  erzeugte  Soundsignal  wird,  wie  beim  STE  erlautert,  zu  dem 
Soundsignal  vom  PCM-Soundmodul  dazugemischt  und  laBt  sich  durch  entsprechende 
Programmierung  des  Volume/Tone-Controllers  LMC1992  auch  bei  Bedarf  unterdriicken. 

Was  die  Portanschliisse  des  PSG  im  TT  angeht,  werden  diese,  wie  vom  ST  her  bereits  bekannt, 
als  Daten-  und  Steuerleitungen  fur  den  Parallel-Port  (Druckerport)  und  zum  Drive-  und  Side- 
select  fur  die  Floppy-Disk-Laufwerke  benutzt.  Beim  TT  sind  die  Steuersignale  zur  Floppy- 
Disk-Schnittstelle  (Drive-  und  Side-Select)  jedoch  nochmal  iiber  eine  Treiberschaltung  ge- 
puffert  und  werden  erst  freigeschaltet,  wenn  die  Betriebsspannung  stabil  ist  (iiber  ein  “Power 
Good”-Signal  vom  Netzteil !).  Die  beiden  Portleitungen  IOA7  und  106  weisen  eine  neue  Funk¬ 
tion  auf. 
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Mit  10A7  laBt  sich  beim  TT/MEGA  STE  umschalten,  ob  der  SCC-Kanal  A  auf  dem  LAN- 
AnschluB  (Mini-DIN-Buchse  an  der  Seite  des  Gerates)  oder  auf  dem  SERIAL  2-AnschluB 
(9pol.  SubD-Buchse  an  der  Riickseite  des  Gerates,  wenn  keine  VME-Buskarte  eingesteckt 
ist!)  arbeitet.  Setzt  man  mit  der  XBios-Funktion  Ongibit($80)  den  Port-AnschluB  10 A7  auf 
“Ein”,  ist  SERIAL  2  eingeschaltet.  Mit  Offgibit($7F)  arbeitet  der  SCC-Kanal  A  auf  dem 
LAN-AnschluB. 

Nach  neuesten  Informationen  wird  ATARI  aber  diesen  Port-AnschluB  des  PSG  nicht  mehr  fur 
diese  Umschaltung  verwenden,  sondem  statt  dessen  am  Parallelport  zusatzlich  zur  Verfiigung 
stellen,  urn  das  AnschlieBen  von  Scannem  zu  erleichtem.  Die  Umschaltung  der  beiden  seriel- 
len  Anschliisse  LAN  und  SERIAL  2  erfolgt  dann  ilber  einen  Jumper  auf  der  Hauptplatine  unter 
der  Festplatte. 

I0A6  des  PSG  wird  zum  Ein-  und  Ausschalten  des  Lautsprechers  im  TT  verwendet.  Dabei  wird 
das  Soundsignal  vom  Volume/Tone-Controller  LMC1992,  das  iiber  eine  Treiberstufe  auf  den 
Lautsprecher  gelangt,  durch  ein  Low  am  IOA6-Anschlu6  eingeschaltet. 

Ongibit($40):  Lautsprecher  im  TT  stummschalten. 

Offgibit($BF):  Lautsprecher  im  TT  einschalten. 

Wichtig!  Das  Ein-  und  Ausschalten  iiber  10  A6  des  PSG  betrifft  nur  den  intemen  Lautsprecher 
und  nicht  das  iiber  die  Cinch-Buchsen  (Audio  out  Links  und  Rechts)  abgreifbare  Tonsignal! 


DMA-Sound  im  TT 

Die  Erzeugung  und  Kontrolle  des  PCM-Stereo-Sounds  funktioniert  im  TT/MEGA  STE 
genauso,  wiebeim  STEbeschrieben!  Also  konnen  alle  AdressenundFunktionsbeschreibungen 
(auch  was  das  MMICROWIRE(TM)-Interface  angeht!)  dazu  direkt  im  Hardware-Teil  “Die 
Hardware  des  ATARI  STE”  nachgelesen  werden. 

Auch  was  die  Verkniipfung  vom  “Monochrom-Detect”-Signal  mit  dem  Frame-Ende-Signal 
anPort  17  des  MFP  (im  TT  ist  das  der  ST-MFP!)  angeht,  ist  alles  so,  wie  beim  STE  beschrieben. 
Man  mufi  nur  beachten,  daB  mit  Monochrombetriebsart  beim  TT  eben  die  TT-High-Auflo- 
sung  gemeint  ist  und  nicht  etwa  ST-High! 

Die  etwas  geanderte  Schaltung  (andere  Unit-Nummem  und  zusatzliche  Lautsprechertreiber- 
Stufe)  fiir  den  TT  ist  nachfolgend  aufgefiihrt! 

Weil  im  TT  kein  SHIFTER  der  STE-Serie  zum  Einsatzkommt,  muBte  der  DMA-Soundbetrieb 
iiber  einen  eigenen  SOUNDSHIFTER  realisiert  werden.  Dieser  Custom-Chip  dient  zur 


Sonstiges  zum  TT 
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Abb.  11.1:  Der  TT-DMA-Soundteil 


Erzeugung  der  Sound-DMA-  und  fiir  die  MICROWIRE(TM)-Steuersignale.  Fiir  den  Program- 
mierer  verhalt  sich  dieser  Chip  aber  genauso  wie  der  Sound-DMA-Teil  des  STE-SH1FTERS ! 
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Das  Floppy-Disk  Interface 

Was  die  Ansteuerung  der  Floppy-Disk-Laufwerke  im  TT/MEGA  STE  angeht,  funktioniert 
(erstmal)  alles  genauso,  wie  bereits  beim  ST  beschrieben. 

Weil  aber  720  KByte  auf  einer  3,5"-Disk  wohl  nicht  mehr  so  ganz  zeitgemaB  sind,  hat  ATARI 
auf  Abhilfe  gesonnen  und  eine  Moglichkeit  vorgesehen,  die  Speicherkapazitat  zu  verdoppeln. 
Diese  erhohte  Kapazitat  erfordert  spezielle  Disketten  (HD-Disks)  und  natiirlich  auch  entspre- 
chende  HD-Disklaufwerke. 

Um  die  doppelte  Speicherkapazitat  zu  erhalten,  werden  pro  Spur  bei  HD-Betrieb  nun  die  dop- 
pelte  Anzahl  an  Sektoren  pro  Spur  untergebracht.  Das  geht  nur  mit  einer  hoheren  Datentrans- 
ferrate  auf  den  Schreib-  und  Lesedatenleitungen  zum  Laufwerk.  Um  diese  Verdopplung  der 
Datenrate  zu  erzielen,  wird  bei  HD-Betrieb  der  Systemtakt  des  FDC-Chips  verdoppelt  (statt 
8  MHz  dann  16  MHz!).  Den  Arbeitstakt  fiir  den  FDC  liefert  im  TT  die  MCU  (U206)  an 
Pin  44,  die  auch  die  Taktumschaltung  vomimmt. 


TT  und  MEGA  STE  sind  (im  Prinzip)  HD-fahig 

Die  Verdopplung  des  Taktes  “verkraften”  aber  nicht  alle  Exemplare  des  WD 1 772-FDC-Chips 
(schlieBlich  ist  dieser  ja  auch  nur  fur  8  MHz  ausgelegt!),  ATARI  will  aber  einen  “eigenen”, 
zum  WD1772  aufwartskompatiblen  FDC-Chip  liefem,  der  diese  Taktumschaltung  be- 
herrscht.  In  meinem  TT  arbeitet  allerdings  auch  bereits  der  “gute,  alte  WD1772”  mit  16  MHz 
einwandfrei  und  bedient  ein  nachtraglich  eingebautes  HD-Laufwerk!  Allerdings  gibt  es  bei 
Dauerbetrieb  mit  dieser  hohen  Taktfrequenz  Probleme  mit  der  Warmeentwicklung  des  FDC ! 
Zwar  “stirbt”  dieser  nicht  gerade,  aber  er  arbeitet  nicht  mehr  sicher. 

Die  Umschaltung  des  intemen  Laufwerks  auf  HD  erfolgt  iiber  ein  High-Signal  an  Pin  2  des 
Floppy-Steckverbinders.  Dieser  AnschluB  existiert  aber  an  der  AnschluBbuchse  zum  extemen 
Laufwerk  nicht!  Wenn  man  also  mit  einem  extemen,  HD-fahigen  Laufwerk  arbeiten  will, 
sollte  dieses  so  konliguriert  werden,  daB  es  die  HD-Betriebsart  aus  der  zusatzlichen  Offnung 
einer  HD-Diskette  erkennt  und  entsprechend  umschaltet.  Das  TOS  erkennt  HD-formatierte 
Disks  durch  entsprechende  Leseversuche  mit  den  beiden  moglichen  Taktfrequenzen  fiir  den 
FDC. 

Welche  Density  ein  korrektes  Lesen  ermoglicht,  wird  im  Drive-Status-Block  gemerkt,  der  fiir 
diese  Information  erweitert  wurde.  Im  TOS  3.01  findet  sich  der  Drive-Status-Block  (DSB)  fiir 
das  Laufwerk  A  (“dsbO”)  an  Adresse  $AFA.  Der  zweite  DSB  (“dsbl”)  liegt  bei  $B00!  Vor- 
sicht!  Das  sind  Adressen  von  intemen  Datenstrukturen,  die  sich  von  TOS-Version  zu  TOS- 
Version  andem  konnen!  Also  erst  gar  nicht  benutzen!  Fiir  das  Formatieren  sollten  die  ent- 


Sonstiges  zum  IT 
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sprechenden  Betriebssystem-Funktionen  benutzt  werden.  Die  behandeln  die  angeschlossene 
Hardware  dann  schon  richtig! 

Jeweils  das  zweite  Word  eines  DSB  wird  fiir  die  aktuelle  Density-Einstellung  benutzt.  Dabei 
ist  das  niedrigwertigste  Bit  fur  die  Takteinstellung  (Bit  0  =  1:  16  MHz-Takt)  und  das  Bit  1 
fiir  die  Density-Signalisierung  (Pin  2  des  Floppy-Steckverbinders)  zum  Laufwerk  zustandig 
(Bit  1  =  1:  Density-Leitung  auf  High!). 


Abb.  11.2:  DerTT/MEGA  STE  ACSl-Busanschlufi 


1216 


ATARI  Profibuch 


Das  Hardware-Register  (Word-Zugriffe,  nur  die  beiden  untersten  Bits  werden  verwendet)  fur 
die  Taktumschaltung  und  die  Ansteuerung  der  HD-Signal-Leitung  liegt  bei  Adresse 
$(FF)FF  860E!  Auch  diese  Adresse  ist  nicht  von  ATARI  dokumentiert  und  kann  sich  evtl. 
andem.  Also  nicht  direkt  verwenden! 


Der  TT/MEGA  STE  und  der  ACSI-Bus 

Auch  hier  gibt’s  gegeniiber  der  Ausfiihrung  im  ST  keine  gravierenden  Anderungen.  Die 
wesentlichste  Abweichung  besteht  in  der  Verwendung  von  Treiberstufen  fiir  die  ACSI-Bus- 
Signale  zur  S  tabilisierung  der  Signale.  AuBerdem  wird  der  DMA-Chip  dadurch  etwas  weniger 
anfallig  gegen  Zerstorungen  von  “AuBen”. 

Beim  MEGA  STE  hat  ATARI  ja  ebenfalls  eine  Festplatte  (SCSI !)  mit  ins  Gehause  eingebaut. 
Fiir  deren  Betrieb  ist  dann  natiirlich  ein  entsprechender  Hostadapter  erforderlich,  um  die  AC- 
SI-Bussignale  auf  SCSI-Signale  umzusetzen.  Der  AnschluB  dieses  Hostadapters  erfolgt  iiber 
eine  30pol.  Pfostenfeldleiste  auf  dem  Motherboard  des  MEGA  STE.  Die  Datenbusleitungen 
werden  dabei  “durch”  den  Hostadapter  gefiihrt  (eine  Seite  Input;  andere  Seite  Output)!  Wenn 
kein  Hostadapter  eingebaut  ist,  mtissen  deshalb  die  Datenbusleitungen  an  der  Pfostenfeldleiste 
gebriickt  sein,  um  die  Signale  auch  am  auBenliegenden  ACSI-AnschluB  zur  Verfiigung  zu  ha- 
ben  !  Die  interne  Platte  hat  standardmaBig  die  ACSI-Device-Nummer  0.  AuBen  angeschlosse- 
ne  ACSI-Device  sollten  sich  also  daran  entsprechend  anschlieBen. 


Anhange 
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Anhang  A:  BIOS-,  XBIOS-  und 
GEMDOS-Fehlernummern 

TOS-Fehlermeldungen 

Beim  Aufruf  von  BIOS-,  XBIOS-  und  GEMDOS-Funktionen  wird  ira  allgemeinen  im 
Register  DO  ein  32-Bit-Statuswert  zuriickgeliefert,  der  dariiber  Auskunft  gibt,  ob,  und  wenn 
ja,  was  fur  ein  Fehler  bei  der  Ausfiibrung  der  Funktion  aufgetreten  ist.  Hier  eine  Ubersicht: 

0:  E_OK  (“OK  (no  error)”) 

Funktion  erfolgreich  ausgefiihrt  (kein  Fehler  aufgetreten). 

-1:  ERROR  (“Error”) 

Es  ist  ein  Fehler  aufgetreten,  der  nicht  genauer  spezifiziert  werden  kann. 

-2:  EDRVNR  (“Drive  not  ready”) 

Angesprochenes  Gerat  ist  nicht  angeschlossen,  nicht  funktionsbereit  oder  reagiert  nicht 
innerhalb  der  gesetzten  Frist  (Timeout). 

-3:  EUNCMD  (“Unknown  command”) 

Dem  angesprochenen  Peripheriegerat  ist  das  gegebene  Kommando  unbekannt. 

-4:  E  CRC  (“CRC  error”) 

Beim  Lesen  eines  Sektors  ist  ein  Fehler  aufgetreten  (aufgetreten  bei  der  CRC-Uberpriifung). 
-5:  EBADRQ  (“Bad  request”) 

Das  Peripheriegerat  kann  das  Kommando  nicht  ausfiihren.  Befehlsparameter  und  Kontext 
priifen. 

-6:  E_SEEK  (“Seek  error”) 

Der  angesprochene  Track  konnte  vom  Laufwerk  nicht  erreicht  werden. 
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-7:  EMEDIA  (“Unknown  media”) 

Leseversuch  gescheitert,  da  das  Medium  keinen  korrekten  Bootsektor  besitzt. 

-8:  ESECNF  (“Sector  not  found”) 

Der  betreffende  Sektor  wurde  nicht  gefunden. 

-9:  EPAPER  (“Out  of  paper”) 

Drucker  nicht  betriebsbereit. 

-10:  EWRITF  (“Write  fault”) 

Fehler  bei  Schreiboperation  aufgetreten. 

-11:  EREADF  (“Read  fault”) 

Fehler  bei  Leseoperation  aufgetreten. 

-12:  EGENRL  (“General  error”) 

Allgemeiner  Fehler  (Kommentar  im  “Hitchhiker’s  guide  to  the  Bios”:  ‘Reserved  for  future 
catastrophes’). 

-13:  EWRPRO  (“Write  on  write-protected  media”) 

Es  wurde  versucht,  auf  ein  schreibgeschixtztes  Medium  zu  schreiben. 

-14:  ECHNG  (“Media  change  detected”) 

Seit  der  letzten  Schreiboperation  wurde  das  Medium  gewechselt. 

-15:  EUNDEV  (“Unknown  device”) 

Das  angesprochene  Gerat  ist  dem  Betriebssystem  unbekannt. 

-16:  EBADSF  (“Bad  sectors  on  format”) 

Beim  Formatiervorgang  wurden  defekte  Sektoren  entdeckt. 


Anhang  A:  BIOS-,  XBIOS-  und  GEMDOS-Fehlemummern 
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-17:  EOTHER  (“Insert  other  disk  (request)”) 

Eine  andere  Diskette  muB  eingelegt  werden.  Tritt  nur  auf,  wenn  Laufwerk  B:  angesprochen 
wird,  ohne  angeschlossen  zu  sein. 

In  diesem  Fall  wird  der  Benutzer  aufgefordert,  “Diskette  B in  das  erste  Laufwerk  einzulegen. 

-18:  EINSERT  (“Insert  disk”) 

Meta-DOS-Fehler:  Medium  einlegen! 

-19:  EDVNRSP  (“Device  not  responding”) 

Meta-DOS-Fehler:  Gerat  antwortet  nicht. 

-32:  EINVFN  (“Invalid  function  number”) 

Unbekannte  Funktionsnummer.  Man  erhalt  diese  Meldung,  wenn  man  eine  undefinierte 
GEMDOS-Funktion  aufruft  (unter  MS-DOS:  Fehlercode  1). 

-33:  EFILNF  (“File  not  found”) 

Datei  nicht  gefunden  (unter  MS-DOS:  Fehlercode  2). 

-34:  EPTHNF  (“Path  not  found”) 

Angesprochener  Ordner  nicht  gefunden  (unter  MS-DOS:  Fehlercode  3). 

-35:  ENHNDL  (“Handle  pool  exhausted”) 

Keine  Dateihandles  mehr  (zu  viele  Dateien  geoffnet,  unter  MS-DOS:  Fehlercode  4). 

-36:  EACCDN  (“Access  denied”) 

Zugriff  nicht  erlaubt  (unter  MS-DOS:  Fehlercode  5). 

-37:  EIHNDL  (“Invalid  handle”) 

Das  Dateihandle  war  nicht  korrekt  (unter  MS-DOS:  Fehlercode  6). 

-39:  ENSMEM  (“Insufficient  memory”) 

Nicht  geniigend  Speicher  vorhanden  (unter  MS-DOS:  Fehlercode  8). 
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-40:  EIMBA  (“Invalid  memory  block  address”) 

Die  Adresse  des  Speicherblocks  war  nicht  giiltig  (unter  MS-DOS:  Fehlercode  9). 

-46:  EDRIVE  (“Invalid  drive  specification”) 

Die  Laufwerksbezeichnung  war  ungiiltig  (unter  MS-DOS:  Fehlercode  15). 

-48:  ENSAME  (“Not  the  same  drive”) 

Dateien  sind  auf  verschiedenen  logischen  Laufwerken. 

-49:  ENMFIL  (“No  more  files”) 

Es  konnen  keine  Dateien  mehr  geoffnet  werden  (unter  MS-DOS:  Fehlercode  18). 

-58:  ELOCKED  (“Record  is  locked”) 

Es  wurde  versucht,  auf  einen  gelockten  Bereich  einer  Datei  zuzugreifen  (nur  im  Zusammen- 
hang  mit  einer  Netzwerk-GEMDOS-Version). 

-59:  ENSLOCK  (“Matching  lock  not  found”) 

Es  wurde  versucht,  einen  nicht  existierenden  Lock  (falscher  Offset  oder/und  falsche  Lange) 
zu  entfemen  (nur  im  Zusammenhang  mit  einer  Netzwerk-GEMDOS-Version). 

-64:  ERANGE  (“Range  error”) 

Dateizeiger  in  ungiiltigem  Bereich. 

-65:  EINTRN  (“GEMDOS  internal  error”) 

Intemer  Fehler  im  GEMDOS  (hoffentlich  passiert’s  nie!). 

-66:  EPLFMT  (“Invalid  executable  file  format”) 

Das  angesprochene  Programm  hat  nicht  das  korrekte  Format,  um  geladen  zu  werden. 

-67:  EGSBF  (“Memory  block  growth  failure”) 

Es  wurde  versucht,  einen  allozierten  Speicherblock  zu  vergroBem. 


Anhang  B: 

Wichtige  Betriebssystemstrukturen 
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AESPB  (AES  Parameter  Block) 


Offset 

Struktur 

typedef  struct 
{ 

WORD  *cb  pcontrol; 

$00 

$04 

WORD  *cb  pglobal; 

$08 

WORD  *c.b_pintin; 

$0C 

WORD  *cb_pintout; 

$10 

LONG  *cb_padrin; 

$14 

LONG  *cb_padrout; 

}  AESPB; 

/*  Zeiger  auf 
/*  Zeiger  auf 
/*  Zeiger  auf 
/*  Zeiger  auf 
/*  Zeiger  auf 
/*  Zeiger  auf 


contrl[]  */ 
global []  */ 
int__in[]  */ 

int_out []  */ 

addr_in[]  */ 
addr  out[]  */ 


ARHEADER  (Archivheader) 


Offset 

Struktur 

typedef  struct 
{ 

char  a_f name [ 14 ] ; 

$00 

/* 

$0E 

LONG  a_modti; 

/* 

$12 

BYTE  a  userid; 

/* 

$13 

BYTE  a__gid; 

/* 

$14 

WORD  a_fimode; 

/* 

$16 

LONG  a__fsize; 

/* 

$1A 

WORD  reserved; 

}  ARHEADER; 

/* 

Dateiname  */ 

Zeitpunkt  des  letzten  Zugriffs  */ 
nicht  benutzt  */ 
nicht  benutzt  */ 

Filerrtodus  */ 

Dateilange  */ 

Null  */ 
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BASEPAGE 


Offset 

Struktur 

$00 

typedef  struct  basepage 
{ 

void  *p  lowtpa;  /*  Anfangsadresse  der  TPA  (Offset  0)  */ 

$04 

void  *p_hitpa; 

/*  Erstes  Byte  nach  dem  Ende  der  TPA 

$08 

void  *p  tbase; 

(Offset  4)  */ 

/*  Anfangsadresse  des  Programmcodes 

$0C 

LONG  p_tlen; 

(TEXT-Abschnitt)  (Offset  8)  */ 

/*  Lange  des  Programmcodes 

$10 

void  *p  dbase; 

(Offset  12)  */ 

/*  Adresse  des  Bereichs  fur  vorinitia- 

$14 

LONG  p  dlen; 

lisierte  Daten  (DATA-Abschnitt) 
(Offset  16)  */ 

/*  Lange  des  Datenabschnitts 

$18 

void  *p  bbase; 

(Offset  20)  */ 

/*  Adresse  des  Variablenbereichs  (BSS- 

$1C 

LONG  p_blen; 

Abschnitt)  (Offset  24)  */ 

/*  Lange  des  Variablenbereichs 

$20 

DTA  *p  dta; 

(Offset  28)  */ 

/*  Zeiger  auf  Default-DTA  (Vorsicht! 

$24 

struct  basepage 

Zeigt  zunachst  in  die  Kommandozeile) 
(Offset  32)  */ 

*p_parent ; 

$28 

LONG  p  resrvdO; 

/*  Zeigt  auf  die  Basepage  (BASEPAGE)' 
des  aufrufenden  Prozesses 
(Offset  36)  */ 

/*  reserviert  */ 

$2C 

char  *p  env; 

/*  Adresse  der  Environment-Strings 

$30 

(Offset  44)  */ 

CHAR  p_resrvdl [80] ;  /*  reserviert  */ 

$80 

char  p_cmdlin[128] ;  /*  Kommandozeile  (dabei  wird  im  er- 

sten  Byte  die  Anzahl  der  Zeichen 
eingesetzt.  Die  maximale  Lange  der 
Kommandozeile  belauft  sich 
erstaunlicherweise  nicht  auf  127, 
sondern  auf  124  Zeichen.) 

(Offset  128)  */ 

}  BASEPAGE; 


Angang  B:  Wichtige  Betriebssystemstrukturen 
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BCB  (Buffer  Control  Block) 


Offset 

Struktur 

typedef  struct 

1  { 

struct  __bcb 

_bcb 

$00 

*b_link; 

/* 

$04 

WORD 

b  negl; 

/*  ■ 

$06 

WORD 

bjprivate  [5] ; 

$10 

void 

*b_buf ; 

/*  : 

}  BCB; 

Zeiger 
auf  -1 

Zeiger 

Puffer 


auf  nachsten  BCB  */ 
initialisieren  */ 

auf  den  eigentlichen 

V 


BCONMAP  (siehe  ‘BconmapO’) 


Offset 

Struktur 

typedef  struct 
{ 

MAP TAB  *maptab; 

WORD  maptabsize; 

}  BCONMAP; 

$00 

$04 

/*  Zeiger  auf  Funktionstabelle  */ 
/*  Anzahl  der  Eintrage  */ 

BITBLK 


Offset 

Struktur 

typedef  struct 
/ 

$00 

UWORD 

*bi_pdata; 

/*  Zeiger  auf  Image  */ 

$04 

DWORD 

bi__wb; 

/*  Breite  in  Bytes  */ 

$06  1 

UWORD 

bi_hl; 

/*  Hohe  in  Pixelzeilen  */ 

$08 

WORD 

bi_x; 

/*  X~Position  */ 

$0A 

WORD 

bi_y; 

/*  Y-Position  */ 

$0C 

WORD 

bi__color; 

/*  Farbe  */ 

}  BITBLK; 
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BPB  (BIOS  Parameter  Block) 


Offset 


Struktur 


typedef  struct 


{ 


$00 

$02 

$04 

$06 


WORD  recsi.2; 
WORD  clsiz; 
WORD  clsizb; 
WORD  rdlen; 


/*  Bytes  pro  Sektor  */ 

/*  Sektoren  pro  Cluster  (Einheit)  */ 
/*  Bytes  pro  Cluster  */ 

/*  Lange  des  Wurzelverzeichnisses  in 
Sektoren  */ 


$08 

$0A 

$0C 


WORD  fsiz;  /*  Lange  des  File  Allocation  Table  (FAT) 
WORD  fatrec;  /*  Startsektor  der  zweiten  FAT  */ 

WORD  datrec;  /*  Sektornummer  des  ersten  freien 

Clusters  */ 


*/ 


$0E 

$10 


WORD  numcl;  /*  Cluster-Gesamtzahl  auf  dem  Medium  */ 
WORD  bflags;  /*  Bitvektor,  zur  Zeit  nur  Bit  0  belegt: 

0  (12-Bit -FAT) ,  1  (16-Bit -FAT)  */ 


}  BPB; 


CPXHEAD  (CPX-Dateikopf) 


Offset 

Struktur 

$00 

typedef  struct 
{ 

UWORD  magic; 

$02 

struct 

{ 

unsigned  reserved 
unsigned  resident 
unsigned  bootinit 
unsigned  setonly 
}  flags; 

LONG  cpx  id; 

$04 

$08 

UWORD  cpx  version; 

$0A 

char  i  text [14]; 

$18 

UWORD  sm_icon  [48]; 

$78 

□WORD  i  color; 

/*  =  100  */ 


13;  /*  reserviert  */ 

1;  /*  RAM-resident  */ 

1;  /*  Boot-Initialisierung  */ 

1;  /*  Set -Only  */ 

/*  eindeutige  CPX-ID  */ 

/*  CPX-Versionsnummer  */ 

/*  Icontext  */ 

/*  Bitmap  {32x24  Pixel)  */ 
/*  Iconfarbe  */ 


Angang  B:  Wichtige  Betriebssystemstrukturen 
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Offset 

Struktur 

$7A 

char 

title  text [18]; 

$7C 

DWORD 

t__color; 

$8E 

char 

buffer [64] ; 

$CE 

char 

reserved[306] ; 

}  CPXHEAD 

/*  Name  */ 

/*  Textfarbe  */ 

/*  nicht  fliichtiger  Puffer  */ 
/*  reserviert  */ 


CPXINFO 


Offset 

Struktur 

typedef  struct 

i 

$00 

WORD  cdecl 

$04 

void  cdecl 

$08 

void  cdecl 

$0C 

void  cdecl 

$10 

void  cdecl 

$14 

void  cdecl 

$18 

void  cdecl 

$1C 

void  cdecl 

$20 

WORD  cdecl 

$24 

void  cdecl 

}  CPXINFO; 

(*cpx_call) (GRECT  *work) ; 

(*cpx__draw)  (GRECT  *clip)  ; 

(*cpx_wmove) (GRECT  *work) ; 

(*cpx_timer) (WORD  *event) ; 

(*cpx_key) (WORD  k state,  WORD  key, 

WORD  * event) ; 

(*cpx_button) (MRETS  *mrets,  WOf®  *event) ; 
(*cpx_ml) (MRETS  *mrets,  WORD  *event) ; 
(*cpx_m2) (MRETS  *mrets,  WORD  *event) ; 
(*cpx_hook) (WORD  event,  WORD  *msg, 

MRETS  *mrets,  WORD  *key,  WORD  *nclicks) ; 
(*cpx_close) (WORD  flag) ; 


DIR  (Verzeichnis-Eintrag) 


Offset 


Struktur 


typedef  struct 


$00 

$0B 


{ 

char  dirjname  [11]; 

BYTE  dir  attr; 


/*  Name  inkl.  Erweiterung  ohne 
Punkt  */ 

/*  Attribut  */ 
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Offset 

Struktur 

$0C 

BYTE 

dir  dummy [10] ; 

/* 

unbenutzt  */ 

$16 

UWORD 

dir_time; 

/* 

Erstellungszeit  */ 

$18 

UWORD 

dir  date; 

/* 

Erstellungsdatum  */ 

$1A 

UWORD 

dir  stcl; 

/* 

erster  Cluster  */ 

$1C 

ULONG 

dir_flen; 

/* 

Lange  der  Datei  */ 

}  DIR; 

DISKINFO 


Offset 

Struktur 

typedef  struct 
{ 

LONG  b  free; 

$00 

/* 

Anzahl  der  freien  Cluster  */ 

$04 

LONG  b_total ; 

/* 

Gesamtzahl  der  Cluster  */ 

$08 

LONG  b_secsiz; 

/* 

Bytes  pro  Sektor  */ 

$0C 

LONG  b  clsiz; 

/* 

Sektoren  pro  Cluster  /* 

}  DISKINFO; 

DOSTIME 

Offset 

Struktur 

typedef  struct 
{ 

UWORD  time; 

$00 

/* 

Zeit  wie  in  "Tgettime"  */ 

$02 

UWORD  date; 

}  DOSTIME; 

/* 

Datum  wie  in  "Tgetdate"  */ 

DTA  (Disk  Transfer  Area) 


Offset 

Struktur 

typedef  struct 
{ 

BYTE  d_reserved[21] ; 

$00 

/*  furs  GEMDOS  reserviert  */ 
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Offset 


$15 

$16 

$18 

$1A 

$1E 


FONT 

Offset 


$00 

$02 

$04 

$24 


$26 

$28 

$2A 

$2C 

$2E 

$30 

$32 

UWORD 

$36 

$38 

$3A 


Struktur 


BYTE  d_attrib; 

/* 

Datei-Attribut  */ 

UWORD  d__time; 

/* 

Uhrzeit  */ 

UWORD  d_date; 

/* 

Datum  */ 

LONG  d_length; 

/* 

Dateilange  */ 

char  d_f name [ 14 ] ; 

/* 

Dateiname  */ 

}  DTA; 

HDR 

Struktur 


typedef  struct 

{ 

WORD 


WORD 

char 

UWORD 


font_id; 
point ; 
name [ 32 ] ; 
first  ade; 


UWORD 

last_ade; 

UWORD 

top; 

/* 

UWORD 

ascent; 

/* 

UWORD 

half; 

/* 

UWORD 

descent ; 

/* 

UWORD 

bottom; 

/* 

UWORD 

max_char_width ; 

/* 

max  cell_ 

width; 

/* 

UWORD 

left_offset 

r 

UWORD 

right  offset; 

UWORD 

thicken; 

/*  Fontnummer  */ 

/*  Grofte  im  Punktmaft  */ 

/*  Name  des  Zeichensatzes  */ 

/*  Erstes  Zeichen  im  Zeichensatz 
(nur  die  wenigsten  Drucker- 
Schriften  enthalten  Control- 
Zeichen,  also  ASCII-Werte 
kleiner  32)  */ 

/*  Letztes  Zeichen  im 
Zeichensatz  */ 

Abstand  Topline<->Baseline  */ 
Abstand  Ascentline<~>Baseline  */ 
Abstand  Halfline<->Baseline  */ 
Abstand  Descentline<->Baseline*/ 
Abstand  Bottomline<~>Baseline  */ 

groftte  Zeichenbreite  */$34 

groJlte  Zeichenzellenbreite  */ 

/*  linker  Offset  fur 
Kursivschrift  * / 

/*  rechter  Offset  fur 
Kursivschrift  */ 

/*  Verbreiterungsfaktor  fiir 
Fettschrift  (bei  Fettschrift 
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Offset  Struktur 

wird  die  Breite  um  genau  so 
viele  Pixel  erhoht)  */ 

$3C  UWORD  ul_size;  /*  Dicke  der  Unterstreichung  */ 

$3E  UWORD  lighten;  /*  Maske  fur  helle  Schrift  (wird 

mit  Raster  undiert,  normaler- 
weise  0x5555)  */ 

$40  UWORD  skew;  /*  Maske  fur  Kursivschrift  (be- 

schreibt,  an  welchen  Stellen 
die  Rasterzeilen  verschoben 
werden  sollen,  normalerweise 
0x5555  */ 

$42  UWORD  flags;  /*  Bit  0:  gesetzt,  wenn  es  der 

"Default  system  font"  ist 
Bit  1;  gesetzt,  wenn  die 
"Horizontal  offset  table" 
benutzt  wird 

Bit  2;  gesetzt,  wenn  Bytes 
nicht  vertauscht  werden  miis- 
sen  (Motorola-Format) 

Bit  3:  gesetzt,  wenn  der  Font 
nicht  proportional  ist  */ 

$44  BYTE  *hor_table;  /*  Zeiger  auf  "horizontal  offset 

table";  in  der  Datei  der 
Offset  zum  Dateibeginn  */ 

$48  UWORD  *off_table;  /*  Zeiger  auf  "character  offset 

table"  */ 

$4C  UWORD  *dat_table;  /*  Zeiger  auf  Fontimage  */ 

$50  UWORD  form_width;  /*  Breite  des  Zeichensatzimage*/ 

$54  UWORD  form_height;  /*  Hohe  des  Zeichensatzimage  */ 

$58  FONT_HDR  *next_font;  /*  Zeiger  auf  nachsten  Font- 

header  (in  der  Fontdatei 
zunachst  unbenutzt)  */ 

}  FONT  HDR; 
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GEM_MUPB  (GEM  Memory  Usage  Parameter  Block) 

Offset  Struktur 

typedef  struct 

{ 

$00  LONG  gmjmagic; 

$04  void  *gm_end; 

$08  void  *gm_init; 

}  GEM  MUPB; 


GRECT 

Offset  Struktur 

typedef  struct 

{ 

$00  WORD  g_x;  /*  X-Position  */ 

$02  WORD  g_y;  /*  Y-Position  */ 

$04  WORD  g_w;  /*  Breite  */ 

$06  WORD  g_h;  /*  Hohe  */ 

}  GRECT; 


ICONBLK 

Offset  Struktur 

typedef  struct 

{ 

$00  DWORD  *ibjomask; 

$04  DWORD  *ibjpdata; 

$08  char  *ib__ptext; 

$0C  DWORD  ib  char; 


/*  Zeiger  auf  Icon-Maske  */ 

/*  Zeiger  auf  Icon-Daten  */ 

/*  Zeiger  auf  Icon-Text  */ 

/*  Zeichen,  das  im  Icon  erschei- 
nen  soil,  und  Vorder-  und 
Hintergrundfarbe  des  Icons  */ 


/*  muft  0x87654321  sein  */ 

/*  Ende  des  von  GEM  benotigten 
Speicherbereichs  */ 

/*  Startadresse  von  GEM  */ 
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Offset 

Struktur 

$0E 

UWOKD 

ib  xchar; 

/* 

dessen  X-Position  */ 

$10 

DWORD 

ib_ychar; 

/* 

dessen  Y-Position  */ 

$12 

DWORD 

ib  xicon; 

/* 

X-Position  des  Icons  */ 

$14 

UWORD 

ib_yicon; 

/* 

Y-Position  des  Icons  */ 

$16 

UWORD 

ib  wicon; 

/* 

Breite  des  Icons  */ 

$18 

UWORD 

ib  hi con; 

/* 

Hohe  des  Icons  */ 

$1A 

WORD 

ib_xtext ; 

/* 

X-Position  der  Beschriftung 

*/ 

$1C 

WORD 

ib_ytext; 

/* 

Y-Position  der  Beschriftung 

*/ 

$1E 

UWORD 

ib  wtext; 

/* 

Textbreite  in  Pixel  */ 

$20 

UWORD 

ib_htext; 

/* 

Texthohe  in  Pixel  */ 

$22 

UWORD 

ib  resvd; 

/* 

reserviert  */ 

}  ICONBLK, 

IMGHEADER 


Offset 

Struktur 

$00 

typedef  struct 
{ 

I  WORD  im  version;  / 

$02 

DWORD 

im_headlength  ; 

$04 

UWORD 

im  nplanes; 

$06 

UWORD 

im  patlen; 

$08 

UWORD 

im_pixwidth; 

$QA 

UWORD 

im^pix  height; 

$0C 

UWORD 

im__scanwidth; 

$0E 

UWORD 

im  nlines; 

}  IMGHEADER; 

Versionsnummer  der  Imagedatei*/ 
/*  Lange  des  Headers  in  Words  */ 
/*  Anzahl  der  Farbebenen  */ 

/*  Musterlange  in  Byte  */ 

/*  Pixelbreite  in  mm/1000  */ 

/*  Pixelhohe  in  mm/1000  */ 

/*  Zeilenbreite  in  Pixel  */ 

/*  Anzahl  der  Zeilen  */ 


IOREC 


Offset 

Struktur 

typedef  struct 
{ 

LONG  ibuf ;  /* 

WORD  ibufsiz;  /* 

$00 

$04 

Zeiger  auf  den  Puffer  */ 

Lange  des  Puffers  */ 

Angang  B:  Wichtige  Betriebssystemstrukturen 
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Offset 

Struktur 

$06 

WORD  ibufhd; 

/* 

nachste  Schreibposition  */ 

$08 

WORD  ibuftl; 

/* 

nachste  Leseposition  */ 

$0A 

WORD  ibuflow; 

/* 

"untere  Wassermarke"  */ 

$0C 

WORD  ibufhi; 

/* 

"obere  Wassermarke"  */ 

}  IOREC; 

LINEA 

Offset 

Struktur 

typedef  struct 

{ 

$00  WORD  PLANES;  /*  Anzahl  der  Bildschirmebenen  (+$00)  */ 

$02  WORD  WIDTH;  /*  Bytes  pro  Bildschirmzeile  (+$02)  */ 

$04  LONG  CONTRL;  /*  Zeiger  auf  contrl[]  (VDI)  (+$04)  */ 

$08  LONG  INTIN;  /*  Zeiger  auf  int_in[]  (VDI)  (+$08)  */ 

$0C  LONG  PTSIN;  /*  Zeiger  auf  pts_in[]  (VDI)  (+$0C)  */ 

$10  LONG  INTOUT;  /*  Zeiger  auf  int_out[]  (VDI)  (+$10)  */ 

$14  LONG  PTSOUT ;  /*  Zeiger  auf  pts_out[]  (VDI)  (+$14)  */ 

$18  WORD  COLBITO;  /*  Farbwert  fur  Plane  0  (+$18)  */ 

$1A  WORD  COLBIT1 ;  /*  Farbwert  fur  Plane  1  (+$1A)  */ 

$1C  WORD  COLBIT2;  /*  Farbwert  fur  Plane  2  (+$1C)  */ 

$1E  WORD  COLBIT3 ;  /*  Farbwert  fur  Plane  3  (+$1E)  */ 

$20  WORD  LSTLIN;  /*  letzten  Pixel  einer  Linie  zeichnen  (1) 

Oder  nicht  zeichnen  (0)  +$20)  */ 

$22  WORD  LNMASK;  /*  Muster  fur  Linien  (+$22)  */ 

$24  WORD  WMODE ;  /*  VDI-Schreibmodus  (+$24)  */ 

$26  WORD  XI, Y1,X2,Y2; 

/*  Koordinatenangaben  (+$26)  */ 

$2B  LONG  PATPTR;  /*  Zeiger  auf  Fullruuster  (+$2E)  */ 

$32  WORD  PATMSK;  /*  dazugehorige  Maske  (+$32)  */ 

$34  WORD  MFILL;  /*  Ftillmuster  monochr . / f arbig  (+$34)*/ 

$36  WORD  CLIP;  /*  Clipping  aus/an  (+$36)  */ 

$38  WORD  XMINCL,  YMINCL; 

/*  linke  obere  Ecke  d.  Clip-rect.  (+$38)*/ 
$3C  WORD  XMAXCL, YMAXCL; 

/*  rechte  untere  Ecke  des  Clip-rect. 

(+$3C)  */ 
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Offset  Struktur 

$40  WORD  XDDA;  /*  vor  Textausgaben  auf  0x8000  setzen 

(+$40)  */ 

$42  WORD  DDAINC;  /*  VergroBerungsfaktor  -  bei  VergroBerung : 

256* (Wunschgrofie-Aktuelle) /Aktuelle; 
bei  Verkleinerung : 

256* (WunschgroBe) /Aktuelle  (+$42)  */ 

$44  WORD  SCALDIR;  /*  VergroBerungsrichtung  (0:  verkleinern, 

1:  vergroiJern)  (+$44)  */ 

$46  WORD  MONO;  /*  Proportionalschrift  ja/nein  (+$46)  */ 

$48  WORD  SOURCEX, SOURCEY; 

/*  X, Y-Koordinate  im  Zeichensatz  (+$48)  */ 
$4C  WORD  DESTX,DESTY; 

/*  Koordinate  des  Zeichens  auf  dem  Bild- 
schirm  (+$4C)  */ 

$50  WORD  DELX, DELY;  /*  Breite  und  Hohe  des  Zeichens  (+$50)  */ 

$54  FONT_HDR  *FBASE; 

/*  Zeiger  auf  Zeichensatzimage  (+$54)  */ 
$58  WORD  FWIDTH;  /*  Breite  des  Zeichensatzimage  (+$58)  */ 

$5A  WORD  STYLE;  /*  Schreibstil  (+$5A) 

Bit  0:  Fettschrift 

Bit  1:  Helle  Schrift 

Bit  2:  Kursivschrift 

Bit  3:  Unterstrichene  Schrift 

Bit  4:  UmriB-Schrift  */ 

$5C  WORD  LITEMASK;  /*  Maske  fur  das  Schattieren  (light) 

(+$5C)  */ 

$5E  WORD  SKEWMASK;  /*  Maske  fur  Italics  (+$5E)  */ 

$60  WORD  WEIGHT;  /*  zusatzliche  Breite  bei  Bold  (+$60)  */ 

$62  WORD  ROFF;  /*  Kursiv-Offset  rechts  (+$62)  */ 

$64  WORD  LOFF;  /*  Kursiv-Offset  links  (+$64)  */ 

$66  WORD  SCALE;  /*  VergroBerung  ja/nein  (+$66)  */ 

$68  WORD  CHUP;  /*  Rotationswinkel  *  10  (+$68)  */ 

$6A  WORD  TEXTFG;  /*  Textfarbe  (+$6A)  */ 

$6C  LONG  SCRTCHP;  /*  Zeiger  auf  temp.  Buffer  fur  Texteffekte 

(+$6C)  */ 

$70  WORD  SCRPT2 ;  /*  Offset  fur  denselben  (+$70)  */ 

$72  WORD  TEXTBG;  /*  Texthintergrundfarbe  (+$72)  */ 

$74  WORD  COPYTRAN;  /*  Flag  fiir  'COPY  RASTER  FORM' 

(0:  "opaque",  1:  "transparent")  (+$74)  */ 
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Offset 

Struktur 

$76 

LONG  SEEDABORT; 

}  LINEA; 

/*  Pointer  auf  Routine,  die  nach  jeder 
Bildzeile  eines  "SEEDFILL"  auf- 
gerufen  wird  (+$76)  */ 

KBDVECS 


Offset 

Struktur 

typedef  struct 

$00 

t 

void  (*midivec) () ; 

$04 

void  (*vkbderr) () ; 

$08 

void  (*vroiderr) {) ; 

$0C 

void  (*statvec) () ; 

$10 

void  (*mousevec) () ; 

$14 

void  (*clockvec) () ; 

$18 

void  (*joyvec){); 

$1C 

void  (*midisys)  ()  ; 

$20 

void  (*ikbdsys)0; 

$24 

WORD  drvstat; 

}  KBDVECS; 

/*  Midi-Eingabe  */ 

/*  Tastatur-Fehler  */ 

/*  MIDI-Fehler  */ 

/*  Status  von  IKBD  lesen  */ 
/*  Mausabfrage  */ 

/*  Uhrzeitabfrage  */ 

/*  Joystickabfrage  */ 

/*  MIDI-Systemvektor  */ 

/*  IKBD~Systemvektor  */ 

/*  IKBD-Treiberstatus  */ 


KEYTAB 


Offset 


Struktur 


typedef  struct 


$00 

$04 


{ 

char  *unshift; 
char  *shift; 


$08 


char  *capslock; 
}  KEYTAB; 


/*  Tabelle  fur  "norraale"  Tastendrucke  */ 
/*  Tabelle  fiir  Tastendrucke  mit 
"Shift"  */ 

/*  Tabelle  fur  Tastendrucke  bei 
"Capslock"  */ 
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MAPTAB  (siehe  ‘BconmapO’) 


Offset 

Struktur 

typedef 

{ 

WORD 

struct 

$00 

(*Bconstat)  ()  ; 

/* 

Funktionszeiger  */ 

$04 

LONG 

(*Bconin)  ()  ; 

$08 

LONG 

(*Bcostat)  () ; 

$0C 

void 

(*Bconout)  ()  ; 

$10 

ULONG 

(*Rsconf)  ()  ; 

$14 

IOREC 

*iorec; 

/* 

Zeiger  auf  lOREC-Struktur  */ 

}  MAPTAB; 

MD  (Memory  Descriptor) 


Offset 

Struktur 

$00 

typedef  struct  md 
{ 

struct  md  *m_link; 

/* 

Zeiger  auf  nachsten  MD  */ 

$04 

LONG 

m  start; 

/* 

Anfangsadresse  des  Blocks  */ 

$08 

LONG 

m  length; 

/* 

Lange  des  Blocks  */ 

$0C 

BASEPAGE 

*m  own; 

/* 

Zeiger  auf  Prozeii-Beschreibungs- 

}  MD; 

Struktur  */ 

METAHDR 


Offset 

Struktur 

typedef  struct 

i 

$00 

WORD  mf  header; 

/*  -1  (Metafile-Kennung)  */ 

$02 

WORD  mf  hlength; 

/*  Lange  des  Headers  in  Integers 

(24)  */ 
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Offset 


Struktur 


$04 


WORD  mf  version; 


/* 


$06 

$08 


WORD  mf_ndcrcfl;  /* 
WORD  mf  extents [4];  /* 


$10 


WORD  mf jpages z [2] ;  / * 


bei  der  aktuellen  Version  101 
(Version  1.01),  Formel: 
100*Hauptnummer+Unternummer  */ 
NDC/RC-Flag  (0  Oder  2)  */ 
optional  -  maximale  AusmaBe  der 
Grafik  -  konnen  mit 
"v_meta_extents () "  gesetzt  war¬ 
den  (sonst  mit  Null  gefullt)  */ 
optional  -  SeitengroBe  in  l/10mm 
-  kann  mit  "vmjpagesize () "  ge¬ 
setzt  werden  (sonst  mit  Nullen 


$14 


$1C 

$1E 


WORD  mf_coords [4] ; 

WORD  mf_imgflag; 

WORD  mf _resvd [  9  ] ; 

}  METAHDR; 


gefullt)  */ 

/*  optional  -  Koordinatensystem  - 
kann  mit  "vm_coords ( ) "  gesetzt 
werden  (sonst  mit  Nullen  ge¬ 
fullt)  */ 

/*  falls  Bit  0=1,  so  enthalt  die 
Datei  Bitimages,  sonst  nicht. 

Die  anderen  Bits  sind  immer  0.*/ 
/*  zur  Zeit  unbenutzt  */ 


METAINFO 


Offset 

Struktur 

typedef  struct 
/ 

$00 

ULONG 

drivemap;  /*  Tabelle  mit  Bits  fur  die  Meta-DOS- 
Geratetreiber  "A".."Z" 

(Bit  0:  "A")  */ 

$04 

char 

*version;  /*  Zeichenkette  mit  Namen  und 

Versionsnummer  von  Meta-DOS  */ 

$08 

LONG 

reserved [2] ; 

}  METAINFO; 
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MEVENT  (Multi  event) 


Offset 

Struktur 

typedef 

/ 

struct 

$00 

UWORD 

e_flags; 

$02 

UWORD 

e_bclk; 

$04 

UWORD 

e  bmsk; 

$06 

UWORD 

e_bst; 

$08 

UWORD 

e  ml flags; 

$0A 

GRECT 

e  ml; 

$12 

UWORD 

e__m2  flags; 

$14 

GRECT 

e  m2; 

$1C 

WORD 

*e_mepbuf ; 

$20 

ULONG 

e  time; 

$24 

WORD 

ejnx; 

$26 

WORD 

ejny; 

$28 

UWORD 

e  mb; 

$2A 

UWORD 

e_ks; 

$2C 

UWORD 

e  kr; 

$2E 

UWORD 

e_br; 

$30 

UWORD 

e_m3 flags; 

$32 

GRECT 

e_m3; 

$3A 

WORD 

e  xtraO; 

$3C 

WORD 

*e  smepbuf, 

$40 

ULONG 

e_xtral  ; 

$44 

ULONG 

e_xtra2; 

}  MEVENT 

r 

MFDB  (Memory  Form  Definition  Block) 


Offset 

Struktur 

typedef  struct 
{ 

void  *fd  addr; 

$00 

/*  Zeiger  auf  Speicherblock  (mub  auf  ge- 
rader  Adresse  liegen) .  Fur  den  Bild- 
speicher  muB  man  NULL  tibergeben,  alle 
anderen  Werte  werden  dann  ignoriert/* 
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Offset  Struktur 

$04  WORD  fd_w;  '  /*  Breite  des  Speicherblocks  in 

Punkten  */ 

$06  WORD  fd_h;  /*  Hohe  des  Speicherblocks  in 

Punkten  */ 

$08  WORD  fd__wdwidth;  /*  Breite  des  Speicherblocks  in 

16-Bit' -Worten  */ 

$0A  WORD  fd_stand;  /*  0:  gerateabhangiges  Format, 

1:  Standardformat  */ 

$0C  WORD  fd_nplanes;  /*  Anzahl  der  Bildebenen  */ 

$0E  WORD  fd_rl,  fd__r2,  fd__r3;  /*  reserviert  */ 

}  MFDB; 


MFORM  (Mouse  form) 


/*  X-Pos.  Aktionspunkt  */ 

/*  Y-Pos.  Aktionspunkt  */ 

/*  Anzahl  planes  (=1)  */ 

/*  Maskenfarbe  (normal:  0)  */ 
/*  Zeigerfarbe  (normal:  1)  */ 
/*  Maskenform  */ 

/*  Zeigerform  */ 


MPB  (Memory  Parameter  Block) 

Offset  Struktur 

typedef  struct 
{ 

$00  MD  *mp_mfl;  /*  Zeiger  auf  "Memory  Free  List"  */ 

$04  MD  *mp_mal;  /*  Zeiger  auf  "Memory  Allocated  List"  */ 

$08  MD  *mp_rover;  /*  roving  pointer;  nur  intern  benotigt  */ 

}  MPB; 


Offset  Struktur 

typedef  struct 
{ 

$00  WORD  mf_xhot; 

$02  WORD  mf_yhot; 

$04  WORD  mf_nplanes; 

$06  WORD  mf_fg; 

$08  WORD  mf_bg; 

$0A  WORD  mf_mask [16] ; 

$2A  WORD  mfjdata  [16]  ; 

}  MFORM; 
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OBJECT 


Offset 

Struktur 

typedef 

{ 

WORD 

struct 

$00 

ob  next; 

/* 

Nummer  des  nachsten  Objekts*. 

$02 

WORD 

ob  head; 

/* 

Nummer  des  ersten  Kinds  */ 

$04 

WORD 

ob  tail; 

/* 

Nummer  des  letzten  Kinds  */ 

$06 

UWORD 

ob  type; 

/* 

Art  des  Objekts  */ 

$08 

UWORD 

ob  flags; 

/* 

Verschiedene  Flags  */ 

$0A 

UWORD 

ob  state; 

/* 

Status  des  Objekts  */ 

$0C 

void 

*ob  spec; 

/* 

Typabhangig  */ 

$10 

WORD 

ob  x; 

/* 

X-Position  (rel.  zum  Parent- 
Objekt)  */ 

$12 

WORD 

ob_y; 

/* 

Y-Position  (rel.  zum  Parent- 
Objekt)  */ 

$14 

WORD 

ob  width; 

/* 

Breite  */ 

$16 

WORD 
}  OBJECT 

ob  height; 

r 

/* 

Hohe  */ 

OHEADER  (Header  einer  DR-Objekdatei) 


Otfset 

Struktur 

typedef  struct 
{ 

WORD  magic; 

$00 

/* 

$601A  */ 

$02 

LONG  tsize; 

/* 

Grdfie  des  Textsegments  */ 

$06 

LONG  dsize; 

/* 

Grdfte  des  DATA-Segments  */ 

$0A 

LONG  bsize; 

/* 

Groiie  der  BSS  */ 

$0E 

LONG  ssize; 

/* 

Groile  der  Symboltabelle  */ 

$12 

char  reserved [ 10 ] ; 

}  OHEADER; 

/* 

alle  auf  0  setzen  */ 
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OSHEADER 

Offset  Struktur 

typedef  struct  _osheader 

{ 

$00  UWORD  os_entry;  /?  BRAnch-Instruktion  zum  RESET- 

Handler,  Offset  $00  */ 

$02  UWORD  os_version;  /*  TOS-Versionsnummer, 

Offset  $02  */ 

$04  void  *reseth;  /*  Zeiger  auf  RESET-Handler, 

Offset  $04  */ 

$08  struct  _osheader  *os_beg; 

/*  Basisadresse  des  Betriebs- 
systems,  Offset  $08  */ 

$0C  void  *os_end;  /*  Erstes  nicht  vom  OS  benutztes 

Byte,  Offset  $0C  */ 

$10  LONG  os_rsvl;  /*  reserviert.  Offset  $10  */ 

$14  GEM_MUPB  *os_magic;  /*  Zeiger  auf  "GEM  memory  usage 

parameter  block", Offset  $14*/ 

$18  LONG  osjdate;  /*  TOS-Herstellungsdatum  im  BCD- 

Format,  etwa  $02061986  fur 
6.  Febr.  1986,  Offset  $18  */ 

$1C  UWORD  os_conf;  /*  verschiedene  Konfigurations- 

bits.  Offset  $1C  */ 

$1E  UWORD  os_dosdate;  /*  TOS-Herstellungsdatum  im 

GEMDOS -Format ,  Offset  $1E  */ 
/*  die  folgenden  Felder  erst  ab  TOS-Version  1.02  */ 

$20  char  **p_root;  /*  Basisadresse  des  GEMDOS- 

Pools,  Offset  $20  */ 

$24  BYTE  **pkbshift;  /*  Zeiger  auf  BlOS-interne 

Variable  fur  den  aktuellen 
Wert  von  "Kbshift () ", 

Offset  $24  */ 

$28  BASEPAGE  **p_run;  /*  Adresse  der  Variablen,  die 

einen  Zeiger  auf  den  aktuel¬ 
len  GEMDOS-Prozeb  entha.lt. 
Offset  $28  */ 

$2C  char  *p_rsv2;  /*  reserviert.  Offset  $2C  */ 

}  OSHEADER; 
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PARMBLK 


Offset 

Struktur 

typedef  struct 
r 

$00 

i 

OBJECT 

*pb  tree; 

/*  Zeiger  auf  Objektbaum  */ 

$04 

WORD 

pb_obj; 

/*  Objektniommer  */ 

$06 

WORD 

pb  prevstate; 

/*  Vorheriger  Status  */ 

$08 

WORD 

pb  curr state ; 

/*  Neuer  Status  */ 

$0A 

WORD 

pb_x; 

/*  X-Position  des  Objekts  */ 

$0C 

WORD 

pbj/; 

/*  Y-Position  des  Objekts  */ 

$0E 

WORD 

pb_w; 

/*  Breite  */ 

$10 

WORD 

pbji; 

/*  Hohe  */ 

$12 

WORD 

pb_xc; 

/*  X-Position  des  Begrenzungs- 

rechtecks  */ 

$14 

WORD 

pb_yc; 

/*  Y-Position  des  Begrenzungs- 

rechtecks  */ 

$16 

WORD 

pb_wc; 

/*  Breite  des  Begrenzungs- 

rechtecks  */ 

$18 

WORD 

pb_hc; 

/*  Hohe  des  Begrenzungs- 

rechtecks  */ 

$1A 

LONG 

pb  parra; 

/*  Parameter  aus  USERBLK  */ 

}  PARMBLK; 

/*  Zeiger  auf  Bildschirmanfang  */ 
/*  dazu  zu  addierender  Offset  */ 
/*  Bildschirmbreite  in  Punkten  */ 
/*  Bildschirmhohe  in  Punkten  */ 

/*  Linker  Rand  in  Punkten  */ 

/*  Rechter  Rand  in  Punkten  */ 

/*  Auflosung  */ 

/*  Druckertyp  Atari/Epson  */ 


PBDEF  (Printblk  Definition) 

Offset  Struktur 

typedef  struct 

{ 

$00  LONG  pb_scrptr; 

$04  WORD  pb_offset; 

$06  WORD  pb_width; 

$08  WORD  pb_height; 

$0A  WORD  pb_lef t ; 

$0C  WORD  pb_right; 

$0E  WORD  pb_screz; 

$10  WORD  pbjprrez; 
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Offset 

Struktur 

$12 

LONG  pb  colptr; 

/* 

Zeiger  auf  Farbpalette  <zum  Bei- 
spiel  $FF8240)  */ 

$16 

WORD  pb_prtype; 

/* 

0:  Atari  Matrix  monochrom, 

1:  Atari  Matrix  farbig, 

2:  Atari  Typenrad  monochrom, 

3:  Epson  Matrix  monochrom  */ 

$18 

WORD  pb_prport; 

/* 

Schnittstelle  Centronics/RS  232  */ 

$1A 

LONG  pb  mask; 

/* 

Zeiger  auf  Halbtonmaske  */ 

}  PBDEF; 

PH  (Program  Header) 

Offset 

Struktur 

typedef  struct 
{ 

WORD  ph  branch; 

$00 

/* 

Branch  an  den  Anfang  des  Programms 
(OxfiOlA)  */ 

$02 

LONG  ph_tlen; 

/* 

Lange  des  TEXT-Abschnitts  */ 

$06 

LONG  ph__dlen; 

/* 

Lange  des  DATA-Abschnitts  */ 

$0A 

LONG  ph_blen; 

/* 

Lange  des  BSS-Abschnitts  */ 

$0E 

LONG  ph_slen; 

/* 

Lange  der  Symboltabelle  */ 

$12 

LONG  phjresl; 

/* 

reserviert;  mufi  0  sein  */ 

$16 

LONG  ph_prgflags; 

/* 

spe2ielle  Flags  */ 

$1A 

WORD  ph_absflag; 

/* 

0:  Relozierungsinformationen 
vorhanden  */ 

}  PH; 

PUNINFO  (Physical  Unit  Information) 


Offset 

Struktur 

typedef 

{ 

WORD 

struct 

$00 

puns; 

/* 

Anzahl  der  Gerate  */ 

$02 

BYTE 

pun [16] ; 

/* 

diverse  Flags  */ 

$12 

LONG 

part_start [16] ; 

/* 

Partitionsanfange  */ 
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Offset 

Struktur 

$52 

LONG 

P_cookie; 

/* 

muil  "AHDI"  sein  */ 

$56 

LONG 

*P  cookptr; 

/* 

zeigt  auf  das  vorherige 

Element  */ 

$5A 

UWORD 

P  version; 

/* 

0x0300  Oder  grofier  */ 

$5C 

UWORD 

P _max_sector  ; 

/* 

maximale  SektorgroBe  */ 

$5E 

LONG 

reserved [16] ; 

}  PUNJTNFO; 

RSHDR  (Resource  Header) 


Offset 

Struktur 

typedef  struct 
/ 

$00 

i 

UWORD 

rshjvrsn; 

/* 

$02 

UWORD 

rsh__object; 

/* 

$04 

UWORD 

rsh_tedinfo; 

/* 

$06 

UWORD 

rsh_iconblk; 

/* 

$08 

UWORD 

rsh  bitblk; 

/* 

$0A 

UWORD 

rsh_frstr; 

/* 

$0C 

UWORD 

rsh  string; 

/* 

$0E 

UWORD 

rshjjmdata; 

/* 

$10 

UWORD 

rsh  frimg; 

/* 

$12 

UWORD 

rsh  trindex; 

/* 

$14 

UWORD 

rsh  nobs; 

/* 

$16 

UWORD 

rsh_ntree; 

/* 

$18 

UWORD 

rsh  nted; 

/* 

$1A 

UWORD 

rsh_nib; 

/* 

$1C 

UWORD 

rsh  nbb; 

/* 

$1E 

UWORD 

rsh_nstring; 

/* 

$20 

UWORD 

rsh__nimages ; 

/* 

$22 

UWORD  rsh  rssize; 

}  RSHDR; 

/* 

null  */ 

Position  des  Objekt-Feldes  */ 
Position  der  TEDINFO-Strukturen  * 
Position  der  ICONBLK-Strukturen  * 
Position  der  BITBLK-Strukturen  */ 
Position  der  freien  Strings  */ 
unbenutzt  */ 

Position  der  Image-Daten  */ 
Position  der  freien  Images  */ 
Position  der  Ob jektbaumtabelle  */ 
Gesamtzahl  der  Objekte  */ 
Gesamtzahl  der  Objektbaume  */ 
Gesamtzahl  der 
TEDINFO-Strukturen  */ 

Gesamtzahl  der 
ICONBLK-Strukturen  */ 

Gesamtzahl  der 
BITBLK-Strukturen  */ 

Gesamtzahl  der  Strings  */ 
Gesamtzahl  der  Images  */ 
Gesamtlange  der  RSC-Datei  */ 


/ 

/ 
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TEDINFO 


Offset 

l  Struktur 

typedef  struct  • 

1  / 

$00 

i 

char  *te_ptext; 

/* 

Zeiger  auf  Text  */ 

$04 

char  *te  ptmplt; 

/* 

Zeiger  auf  Textmaske  */ 

$08 

char  *te_pvalid; 

/* 

Zeiger  auf  Texttypmaske  */ 

$0C 

WORD  te  font; 

/* 

Zeichensatz  */ 

$0E 

WORD  te__resvdl; 

/* 

reserviert  */ 

$10 

WORD  te  just; 

/* 

Justifikation  */ 

$12 

WORD  te_Color; 

/* 

Farbe  des  betreff.  Rechtecks  */ 

$14 

WORD  te  resvd2; 

/* 

reserviert  */ 

$16 

WORD  te__thickness; 

/* 

Rahmen  */ 

$18 

WORD  te_txtlen; 

/* 

Lange  des  Textes  */ 

$1A 

WORD  te_tmplen; 

/* 

Lange  der  Textmaske  */ 

}  TEDINFO; 

USERBLK 

Offset  Struktur 

typedef  struct 

{ 

$00  WORD  (*ub_code)  (PARMBLK  *);/*  Zeiger  auf  die  eigene 

Funktion  */ 

$04  LONG  ub_parm;  /*  Ein  optionaler  Parameter  */ 

}  USERBLK; 

VDIESC 

Offset  Struktur 

typedef  struct 

{ 

-$38E  LONG  RESERVED 6;  /*  (-$38E)  */ 

-$38A  FONT_HDR  *CUR_FONT; 

/*  Zeiger  auf  den  Header  des  aktuel- 
len  Zeichensatzes  (~$38A)  */ 
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Offset 

Struktur 

-$386 

WORD  RESERVED5 [23] ; 

/* 

-$358 

WORD  M_POS_HX; 

/* 

-$356 

WORD  M_POS_HY; 

/* 

-$354 

WORD  M_PIANES; 

/* 

-$352 

WORD  M_CDBJ3G; 

/* 

-$350 

WORD  M_CDB_FG; 

/* 

-$34E 

WORD  MASK_FORM [32] ; 

/* 

-$30E 

WORD  INQ_TABt45]; 

/* 

-$2B4 

WORD  DEV_TAB [45]; 

/* 

-$25A 

WORD  GCURX; 

/* 

-$258 

WORD  GCURY; 

/* 

-$256 

WORD  M_HIDJ3T; 

/* 

-$254 

WORD  MOUSE_BT; 

/* 

-$252 

WORD  REQjOOL [48] ; 

/* 

-$1F2 

WORD  SIZ_TAB [15] ; 

/* 

-$1D4 

WORD  RESERVED4 [2] ; 

-$1D0 

LONG  CUR_WORK; 

/* 

-$1CC 

FONT_HDR  *DEF_FONT 

} 

/* 

-$1C8 

LONG  FONT_RING[4] ; 

/* 

(-$386)  */ 

X-Koordinate  'des  Maus-"Hot  spot" 
(-$358)  */ 

Y-Koordinate  des  Maus-"Hot  spot" 
(-$356)  */ 

Maus  wird  im  Replace-Modus  (1) 
oder  im  XOR-Modus  (-1)  gezeichnet 
(-$354)  */ 

Maus-Hintergrundfarbe  (-$352)  */ 
Maus-Vordergrundfarbe  (-$350)  */ 
jewel Is  abwechselnd  fur  Vorder- 
grund  und  Maske  16  Words 
(-$34E)  */ 

Informationen,  die  bei 
"vq_extnd ( ) "  zuruckgeliefert  wer- 
den  (-$30E)  */ 

Informationen,  die  man  bei 
"v_opnwkO"  erhalt  ( — $2B4 )  */ 
Aktuelle  X-Position  der  Maus 
(~$25A)  */ 

Aktuelle  Y-Position  der  Maus 
(-$258)  */ 

Anzahl  der  erfolgten  "Hide  Mouse"- 
Aufrufe  (-$256)  */ 

Aktueller  Status  der  Mausknopfe 
(-$254)  */ 

Interne  Daten  fur  "vq_color ( ) " 
(-$252)  */ 

Informationen,  die  bei  "v_opnwk ( ) " 
zuruckgeliefert  werden  (-$1F2)  */ 

Zeiger  auf  Attributdaten  der  aktu- 
ellen  virtuellen  Workstation 
(-$1D0)  */ 

Zeiger  auf  den  Standard- 
Systemzeichensatz  (-$1CC)  */ 

Drei  Pointer  auf  Zeichensatzlisten 
(verkettete  FONT_HDR-Strukturen) . 
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Offset 

Struktur 

-$1B8 

WORD  FONT_COUNT; 

-$1B6 

WORD  RESERVED3 [45] 

-$15C 

CHAR  CUR_MS_STAT ; 

-$15B 

CHAR  RESERVED 2 ; 

-$15A 

WORD  V_HID_CNT; 

-$158 

WORD  CUR_X; 

-$156 

WORD  CDR__Y; 

-$154 

CHAR  CUR_FLAG; 

-$153 

CHAR  M0USE_FLAG; 

-$152 

1  LONG  RESERVEDl ; 

-$14E 

WORD  V_SAV_XY [ 2 ]  ; 

-$14A 

WORD  SAVE_LEN; 

-$148 

LONG  SAVE_ADDR; 

-$144 

WORD  SAVE_STAT; 

-$142 

LONG  SAVE_AREA[64] 

Das  letzte  Element  enthalt  eine  0 
als  Endezeichen  (-$1C8)  */ 

/*  Anzahl  der  Zeichensatze  in  der 
"FONT  RING"-Liste  (-$1B8)  */ 


Mausstatus : 

Bit 

0: 

linker  Knopf 

Bit 

1: 

rechter  Knopf 

Bit 

2.  .4: 

reserviert 

Bit 

5: 

Bewegungsflag 

(1:  Maus  wurde  bewegt) 

Bit 

6: 

gesetzt:  Status  des 
rechten  Knopfes  hat  sich 
geandert 

Bit 

7: 

gesetzt:  Status  des 

linken  Knopfes  hat  sich 
geandert 

(-$15C)  */ 


/*  Anzahl  der  Hide-Cursor~Aufrufe  */ 
/*  X-Position  der  Maus  (-$158)  */ 

/*  Y-Position  der  Maus  (-$156)  */ 

/*  <>0,  wenn  Mauszeiger  beim  nachsten 
VBlank  neu  gezeichnet  werden  mu6 
(-$154)  */ 

/*  <>0,  wenn  Maus-Interruptbehandlung 
eingeschaltet  ist  (-$153)  */ 

/*  gerettete  X-  und  Y-Koordinate  des 
Cursors  (-$14E)  */ 

/*  Anzahl  der  gebufferten  Bildzeilen 
(-$14A)  */ 

/*  Adresse  des  ersten  gebufferten 
Bytes  im  Bildspeicher  (-$148)  */ 

/*  Bit  0:  Buffer  ist  giiltig(l)  Oder 
ungiiltig  (0),  Bit  1:  Longs  (1) 

Oder  Words  (0)  gebuffert  (-$144)*/ 
/*  Buffer  fur  Bild  unter  Mauszeiger 
($-142)  */ 
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Offset 

Struktur 

-$42 

LONG  USER_TIM; 

-$3E 

LONG  NEXT_TIM; 

-$3A 

LONG  USERJBUT; 

-$36 

LONG  DSER_CUR; 

-$32 

LONG  USER  JOT; 

-$2E 

WORD  V_CELJiT; 

-$2C 

WORD  V_CEL_MX; 

-$2A 

WORD  V_CEL_MY; 

-$28 

WORD  V_CEL_WR; 

-$26 

WORD  V_COL_BG; 

-$24 

WORD  V_COL_FG; 

-$22 

LONG  V_CUR_AD; 

-$1E 

WORD  V_CUR_0F; 

-$1C 

WORD  V_CUR_XY [2] ; 

-$18 

CHAR  VJPERIOD; 

-$17 

CHAR  V_CUR_CT; 

~$16 

LONG  VJFNT_AD; 

-$12 

WORD  V  FNT  ND; 

-$10 

WORD  VJFNTjST; 

/*  aktueller  Timer-Inter rupt-Vektor; 
sollte  zur  Beendigung  zu 
"NEXT_TIM"  springen  (-$42)  */ 

/*  alter  Timer- Interrupt -Vektor 
(-$3E)  */ 

/*  Maustastenvektor  (-$3A)  */ 

/*  Mausvektor  (-$36)  */ 

/*  Mausbewegungsvektor  (-$32)  */ 

/*  Zexchenhohe  (-$2E)  */ 

/*  maximale  Cursor-Spaltenposition 
(-$2C)  */ 

/*  maximale  Cursor-Zeilenposition 
<-$2A)  */ 

/*  Characterzeilenbreite  in  Bytes 
(Hohe  *  Breite  einer  Pixelzeile) 
£-$28)  */ 

/*  Hintergrundfarbe  (-$26)  */ 

/*  Vordergrundfarbe  (-$24)  */ 

/*  Adresse  der  aktuellen 

Cursorposition  auf  dem  Bildschirm 
(-$22)  */ 

/*  Vertikaler  Offset  vom  physikali- 
schen  Bildschirmanfang  (kann  mit 
VDI  ESC  101  verandert  werden) 

(-$1E)  V 

/*  X-  und  Y-Position  des  Cursors 
<-$lC)  */ 

/*  Blinkgeschwindigkeit  des  Cursors 
(-$18)  */ 

/*  Zahler  fur  Cursorblinken  (-$17)  */ 
/*  Zeiger  auf  Zeichensatzdaten  des 
Systemzeichensatzes  (siehe  auch 
VDI  ESC  102) .  Die  Zeichenbreiten 
miissen  jeweils  8  Bytes  betragen! 
(-$16)  */ 

/*  ASCII-Wert  des  letzten  Zeichens  im 
Zeichensatz  (-$12)  */ 

/*  ASCII-Wert  des  ersten  Zeichens  im 
Zeichensatz  (-$10)  */ 
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Offset  | 

Struktur 

-$0E 

WORD  V_FNT_WD; 

/* 

Breite  der  Fontdaten  (des 

Fontimage)  in  Bytes  (~$E)  */ 

-$0C 

WORD  V_REZ_HZ; 

/* 

Bildschirmbreite  in  Pixel  (-$0C) */ 

-$0A  ! 

LONG  V_OFF_AD; 

/* 

Zeiger  auf  Zeichensatz-Offset- 
Tabelle  (s.  VDI  ESC  102)  (~$0A)  */ 

-$06  | 

WORD  RESERVED; 

/* 

TOS  1.00;  Cursorflag  (-$06)  */ 

-$04 

WORD  V_REZ_VT; 

/* 

Bildschirmhohe  in  Pixel  (-$04)*/ 

-$02 

WORD  BYTES_LIN; 

/* 

Bytes  pro  Pixelzeile  (-$02)  */ 

}  VDIESC; 

XBRA 

Offset 

Struktur 

typedef  struct 
{ 

char  xb_magic [ 4 ] ; 

$00 

/* 

"XBRA"  =  0x58425241  */ 

$04 

char  xb  id ( 4 ] ; 

/* 

vier  Buchstaben  lange  Kennung  wie 
beim  Cookie  Jar  */ 

$08 

LONG  xb__oldvec; 

/* 

ursprunglicher  Wert  des  Vektors  */ 

}  XBRA; 

XCPB 


Offset 

Struktur 

typedef 

{ 

WORD 

struct 

$00 

handle; 

/* 

aus  graf__handle  ()  -Aufruf  von 
XControl,  Wichtig  fur 
v_opnvwk()!|  */ 

$02 

WORD 

booting; 

/* 

ungleich  0:  Initialisierung/ 
Bootvorgang  */ 

$04 

WORD 

reserved; 

/* 

reserviert  */ 

$06 

WORD 

SkipRshFix; 

/* 

ungleich:  Resourcekoordinaten 
bereits  transformiert  */ 
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Offset 


$08 

$0C 

$10 


$14 

$18 


$1C 


$20 


$24 


$28 


$2C 


Struktur 


void  *reservel;  /*  reserviert  */ 

void  *reserve2;  /*  reserviert  */ 

void  cdecl  (*rsh_fix) (WORD  num_objs,  WORD  nurrjfrstr, 

WORD  nuitjfrimg,  WORD  nurrjtree, 
OBJECT  *rs_object, 

TEDINFO  *rs_tedinfo, 
char  *rs_strings [] , 

ICONBLK  *rs__iconblk, 

BITBLK  *rs_bitblk, 

long  *rs__frstr, 

long  *rs_frimg, 

long  *rs_trindex, 

struct  foobar  *rs_imdope)  ; 

void  cdecl  (*rsh_obfix) (OBJECT  *tree,  WORD  curob) ; 

WORD  cdecl  (*Popup)  (char  *items[],  WORD  numjLtems, 

WORD  default_item, 

WORD  font_size,  GRECT  ^button, 
GRECT  *world) ; 

void  cdecl  (*Sl_size) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  numjLtems, 
WORD  visible,  WORD  direction, 
WORD  minjsize) ; 

void  cdecl  (*Sl_x) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  value, 

WORD  num_min,  WORD  numjnax, 
void  (*foo) (void) ) ; 

void  cdecl  (*Sl_y) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  value, 

WORD  nurrjmin,  WORD  nurrjmax, 
void  (*foo) (void) ) ; 

void  cdecl  (*Sl_arrow)  (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  obj, 

WORD  inc,  WORD  min,  WORD  max, 
WORD  *numvar,  WORD  direction, 
void  (*foo) (void) ) ; 

void  cdecl  (*Slj±ragx) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  min, 

WORD  max,  WORD  *numvar, 
void  (*foo) (void) ) ; 
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Struktur 

void  cdecl  (*Sl_dragy) (OBJECT  *tree,  WORD  base, 

WORD  slider,  WORD  min, 

WORD  max,  WORD  *numvar, 
void  (*foo) (void) ) ; 

WORD  cdecl  (*Xform_do) (OBJECT  *tree, 

WORD  start_field, 

WORD  *puntmsg) ; 

GRECT  *  cdecl  (*GetPirstRect) (GRECT  *prect) ; 

GRECT  *  cdecl  (*GetNextRect) (void) ; 

void  cdecl  (*Set_Evnt_Mask)  (WORD  mask,  MOBLK  *ml, 

MOBLK  *m2,  long  time) ; 

WORD  cdecl  (*XGen_Alert) (WORD  id) ; 

WORD  cdecl  (*CPX_Save)  (void  *ptr,  long  num) ; 

void  *  cdecl  (*Get_Buffer) (void) ; 

WORD  cdecl  (*getcookie) (long  cookie,  long  *p_value) ; 

WORD  Country_Code;  /*  Landerkennung,  analog  zu  der 

im  OSHEADER  -  allerdings  in 
fester  Abhangigkeit  von  der 
XControl-Version  */ 

void  cdecl  (*MFsave) (WORD  saveit,  MFORM  *mf) ; 

}  XCPB; 
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Anhang  C: 

Tabelle  der  Tastatur-Scancodes 


V orbemerkung:  Normalerweise  ist  es  nicht  notig,  mit  Scancodes  zu  arbeiten  -  fur  Control-Ta- 
stenkombinationen  kann  man  statt  dessen  den  ASCII-Code  verwenden,  fiir  Altemate-Kombi- 
nationen  bietet  sich  die  Abfrage  der  XBIOS-Tastaturtabellen  via  “KeytblO”  an.  Die  direkte 
Abfrage  von  Scancodes  soil  te  also  nur  bei  Sondertasten  (wie  den  Cursortasten,  Funktionstasten, 
UNDO  etc.)  notig  sein. 


Scancode 

Deutschland 

USA 

England 

Frankreich 

Standard- 

VDI-Code 

1 

ESC 

2 

1 

1 

1 

1 

1 

3 

2 

2 

2 

2 

2 

4 

3 

3 

3 

3 

3 

5 

4 

4 

4 

4 

4 

6 

5 

5 

5 

5 

5 

7 

6 

6 

6 

6 

6 

8 

7 

7 

7 

7 

7 

9 

8 

8 

8 

8 

8 

10 

9 

9 

9 

9 

9 

11 

0 

0 

0 

0 

0 

12 

6 

— 

- 

) 

- 

13 

14 

15 

» 

Backspace 

TAB 

16 

Q 

Q 

Q 

A 

Q 

17 

w 

w 

w 

Z 

w 

18 

E 

E 

E 

E 

E 

19 

R 

R 

R 

R 

R 

20 

T 

T 

T 

T 

T 

21 

Z 

Y 

Y 

Y 

Y 

22 

u 

U 

U 

U 

U 

23 

I 

I 

I 

I 

I 

24 

0 

o 

0 

o 

0 

25 

p 

p 

P 

p 

P 

26 

0 

[ 

[ 

[ 

[ 

27 

28 

+ 

Return 

] 

] 

] 

] 
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Scancode 

Deutschland 

USA 

England 

Frankreich 

Standard- 

VDI-Code 

29 

30 

Control 

A 

A 

A 

Q 

A 

31 

S 

S 

s 

S 

S 

32 

D 

D 

D 

D 

D 

33 

F 

F 

F 

F 

F 

34 

G 

G 

G 

G 

G 

35 

H 

H 

H 

H 

H 

36 

J 

J 

J 

J 

J 

37 

K 

K 

K 

K 

K 

38 

L 

L 

L 

L 

L 

39 

0 

» 

» 

M 

9 

40 

A 

> 

’ 

\ 

» 

41 

# 

i 

‘ 

« 

i 

42 

43 

Shift  links 

\ 

# 

@ 

\ 

44 

Y 

Z 

Z 

W 

z 

45 

X 

X 

X 

X 

X 

46 

C 

c 

c 

c 

c 

47 

V 

V 

V 

V 

V 

48 

B 

B 

B 

B 

B 

49 

N 

N 

N 

N 

N 

50 

M 

M 

M 

> 

M 

51 

» 

> 

j 

» 

9 

52 

: 

53 

- 

/ 

/ 

= 

/ 

54 

55 

Shift  rechts 
nicht  da 

nicht  da 

nicht  da 

nicht  da 

PRINT 

56 

57 

58 

59 

60 

61 

62 

63 

64 

65 

Alternate 

Leertaste 

CapsLock 

FI 

F2 

F3 

F4 

F5 

F6 

F7 

SCREEN 
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Scancode 

Deutschland 

USA 

England 

Frankreich 

Standard- 

VDl-Code 

66 

F8 

67 

F9 

68 

F10 

71 

ClrHome 

72 

t 

73 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

PAGE  UP 

74 

-  (Ziffemblock) 

75 

<— 

77 

-» 

78 

+  (Ziffemblock) 

79 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

END 

80 

1 

81 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

PAGE 

DOWN 

82 

Insert 

83 

Delete 

84 

Shift-Fl 

Shift-Fl 

Shift-Fl 

Shift-Fl 

Fll 

85 

Shift-F2 

Shift-F2 

Shift-F2 

Shift-F2 

F12 

86 

Shift-F3 

Shift-F3 

Shift-F3 

Shift-F3 

FI  3 

87 

Shift-F4 

Shift-F4 

Shift-F4 

Shift-F4 

F14 

88 

Shift-F5 

Shift-F5 

Shift-F5 

Shift-F5 

F15 

89 

Shift-F6 

Shift-F6 

Shift-F6 

Shift-F6 

F16 

90 

Shift-F7 

Shift-F7 

Shift-F7 

Shift-F7 

F17 

91 

Shift-F8 

Shift-F8 

Shift-F8 

Shift-FS 

F18 

92 

Shift-F9 

Shift-F9 

Shift-F9 

Shift-F9 

F19 

93 

Shift-FlO 

Shift-FlO 

Shift-FlO 

Shift-FlO 

F20 

94 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

F21 

95 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

F22 

96 

< 

nicht  da 

\ 

< 

F23 

97 

Undo 

F24 

98 

Help 

F25 

99 

( (Ziffemblock) 

F26 

100 

)  (Ziffemblock) 

F27 

101 

/  (Ziffemblock) 

F28 

102 

*  (Ziffemblock) 

F29 

103 

7  (Ziffemblock) 

F30 

104 

8  (Ziffemblock) 

F31 

105 

9  (Ziffemblock) 

F32 
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Scancode 

Deutschland 

USA 

England 

Frankreich 

Standard- 

VDI-Code 

106 

4  (Ziffemblock) 

F33 

107 

5  (Ziffemblock) 

F34 

108 

6  (Ziffemblock) 

F35 

109 

1  (Ziffemblock) 

F36 

110 

2  (Ziffemblock) 

F37 

111 

3  (Ziffemblock) 

F38 

112 

0  (Ziffemblock) 

F39 

113 

.  (Ziffemblock) 

F40 

114 

Enter  (Ziffembl.) 

CTRL  PRINT 
SCREEN 

115 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

CTRL  f- 

116 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

CTRL  — > 

117 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

CTRL  END 

118 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

CTRL 

PAGEDOWN 

119 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

CTRL  HOME 

120 

ALT  1 

ALT  1 

121 

ALT  2 

ALT  2 

122 

ALT  3 

ALT  3 

123 

ALT  4 

ALT  4 

124 

ALT  5 

ALT  5 

125 

ALT  6 

ALT  6 

126 

ALT  7 

ALT  7 

127 

ALT  8 

ALT  8 

128 

ALT  9 

ALT  9 

129 

ALTO 

ALTO 

130 

ALT  6 

ALT- 

ALT- 

ALT) 

ALT- 

131 

ALT  ’ 

ALT  = 

ALT  = 

ALT- 

ALT  = 

132 

nicht  da 

nicht  da 

nicht  da 

nicht  da 

CTRL 

PAGEUP 

Die  Standard- VDI-Codes  beziehen  sich  augenscheinlich  auf  eine  amerikanische  PC-Stan- 
dardtastatur.  Die  Tastencodes  ab  131  diirfen  nur  fiir  Applikationen  interessant  sein,  die  auch 
unter  MS-DOS  laufen  sollen.  Die  darunterliegenden  Codes,  die  man  bisher  mit  der  Atari-Ta- 
statur  nicht  erzeugen  kann,  kbnnten  allerdings  bei  einer  tnbglichen  Anderung  des  Tastatur- 
Layouts  wichtig  werden! 
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Der  ASCII-Zeichensatz  (“American  Standard  Code  for  Information  Interchange”)  ist  ein  stan- 
dardisierter  7  -Bit-Zeichensatz,  der  folglich  nur  128  Zeichen  definiert.  Das  achte  Bit  kann  (wie 
beim  Atari-Zeichensatz  geschehen)  fiir  Erweiterungen  dienen,  wobei  der  so  entstandene  er- 
weiterte  ASCII-Zeichensatz  ab  Zeichen  128  nicht  mehr  normiert  ist.  Neuere  Normen  sind 
“ISO-Latin  ”’(ein  8-Bit-Zeichensatz  mit  europaischen  Sonderzeichen,  der  im  UNIX-Bereich 
an  Bedeutung  gewinnt)  und  “UNICODE”  (ein  16-Bit-Zeichensatz). 


Code 

Zeichen 

Beschreibung  (in  Klammern:  deutsch) 

0 

NUL 

Null  (Nil) 

1 

SOH  (Ctrl-A) 

Start  of  Heading  (Anfang  des  Kopfes) 

2 

STX  (Ctrl-B) 

Start  of  Text  (Anfang  des  Textes) 

3 

ETX  (Ctrl-C) 

End  of  Text  (Ende  des  Textes) 

4 

EOT  (Ctrl-D) 

End  of  Transmission  (Ende  der  Ubertragung) 

5 

ENQ  (Ctrl-E) 

Enquiry  (Stationsaufforderung) 

6 

ACK  (Ctrl-F) 

Acknowledge  (Positive  Riickmeldung) 

7 

BEL  (Ctrl-G) 

Bell  (Klingel) 

8 

BS  (Ctrl-H) 

Backspace  (Riickwartsschritt) 

9 

HT  (Ctrl-I) 

Horizontal  Tabulation  (Horizontal-Tabulator) 

10 

LF  (Ctrl-J) 

Line  Feed  (Zeilenvorschub) 

11 

VT  (Ctrl-K) 

Vertical  Tabulation  (Vertikal-Tabulator) 

12 

FF  (Ctrl-L) 

Form  Feed  (Formularvorschub) 

13 

CR  (Ctrl-M) 

Carriage  Return  (Wagenriicklauf) 

14 

SO  (Ctrl-N) 

Shift-out  (Dauerumschaltung) 

15 

SI  (Ctrl-O) 

Shift-in  (Riickschaltung) 

16 

DLE  (Ctrl-P) 

Data  Link  Escape  (Dateniibertragungsumschaltung) 

17 

DC1  (Ctrl-Q) 

Device  Control  1  (Geratesteuerung  1) 

18 

DC2  (Ctrl-R) 

Device  Control  2  (Geratesteuerung  2) 

19 

DC3  (Ctrl-S) 

Device  Control  3  (Geratesteuerung  3) 

20 

DC4  (Ctrl-T) 

Device  Control  4  (Geratesteuerung  4) 

21 

NAK  (Ctrl-U) 

Negative  Acknowledge  (Negative  Riickmeldung) 

22 

SYN  (Ctrl-V) 

Synchronous  Idle  (Synchronisierung) 

23 

ETB  (Ctrl-W) 

End  of  Transmission  Block 
(Ende  des  Dateniibertragungsblocks) 

24 

CAN  (Ctrl-X) 

Cancel  (Ungiiltig) 

25 

EM  (Ctrl-Y) 

End  of  Medium  (Ende  der  Aufzeichnung) 
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Code 

Zeichen 

Beschreibung  (in  Klammern:  deutsch) 

26 

SUB  (Ctrl-Z) 

Substitute  Character  (Substitution) 

27 

ESC  (Ctrl-[) 

Escape  (Fluchtzeichen) 

28 

FS  (Ctrl-\) 

File  Separator  (Hauptgruppentrennung) 

29 

GS  (Ctrl-]) 

Group  Separator  (Gruppentrennung) 

30 

RS  (Ctrl-A) 

Record  Separator  (Untergruppentrennung) 

31 

US  (Ctrl-_) 

Unit  Separator  (Teilgruppentrennung) 

32 

SP 

Space  (Leerstelle) 

127 

DEL 

Delete  (Loschen) 

Die  Zeichen  zwischen  32  und  127  entsprechen  den  Definitionen  im  Systemzeichensatz. 
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Hex. 

Dez. 

Oktal 

Binar  Zeichensatz 

Hex. 

Dez. 

Oktal 

Binar  Zeichensatz 

60 

096 

140 

01100000 

' 

90 

144 

220 

10010000 

E 

61 

097 

141 

01100001 

a 

91 

145 

221 

10010001 

S 

62 

098 

142 

01100010 

b 

92 

146 

222 

1001B010 

(L 

63 

099 

143 

01100011 

c 

93 

147 

223 

10010011 

6 

64 

100 

144 

01100100 

d 

94 

148 

224 

10010100 

b 

65 

101 

145 

01100101 

e 

95 

149 

225 

10010101 

6 

66 

102 

146 

01100110 

f 

96 

150 

226 

10010110 

0 

67 

103 

147 

01100111 

g 

97 

151 

227 

10010111 

u 

68 

104 

150 

01101000 

h 

98 

152 

230 

10011800 

y 

69 

105 

151 

01101001 

i 

99 

153 

231 

10011001 

0 

60 

106 

152 

01101010 

j 

90 

154 

232 

10011010 

[j 

68 

107 

153 

01101011 

k 

98 

155 

233 

10011011 

$ 

6C 

108 

154 

01101100 

1 

9C 

156 

234 

10011100 

£ 

6D 

109 

155 

01101101 

m 

9D 

157 

235 

10011101 

¥ 

6E 

110 

156 

01101110 

n 

9E 

158 

236 

10011110 

P 

6F 

111 

157 

01101111 

□ 

9F 

159 

237 

10011111 

f 

70 

112 

160 

01110000 

P 

00 

160 

240 

10100000 

a 

71 

113 

161 

01110001 

q 

01 

161 

241 

10100001 

I 

72 

114 

162 

01110010 

r 

A2 

162 

242 

10100010 

6 

73 

115 

163 

01110011 

s 

03 

163 

243 

10100011 

u 

74 

116 

164 

01110100 

t 

04 

164 

244 

10100100 

n 

75 

117 

165 

01110101 

u 

05 

165 

245 

10100101 

N 

76 

118 

166 

01110110 

u 

06 

166 

246 

10100110 

a 

77 

119 

167 

01110111 

w 

07 

167 

247 

10100111 

0 

78 

120 

170 

01111000 

X 

08 

168 

250 

10101000 

£ 

79 

121 

171 

01111001 

y 

09 

169 

251 

10101001 

r 

7A 

122 

172 

01111010 

z 

00 

170 

252 

10101010 

n 

7B 

123 

173 

01111011 

{ 

OB 

171 

253 

10101011 

k 

7C 

124 

174 

01111100 

1 

0C 

172 

254 

10101100 

k 

7D 

125 

175 

01111101 

> 

00 

173 

255 

10101101 

i 

7E 

126 

176 

01111110 

1 V 

0E 

174 

256 

10101110 

« 

7F 

127 

177 

01111111 

A 

OF 

175 

257 

10101111 

» 

80 

128 

200 

10000000 

c 

B0 

176 

260 

10110000 

a 

81 

129 

201 

10000001 

u 

B1 

177 

261 

10110001 

6 

82 

130 

202 

10000010 

e 

B2 

178 

262 

10110010 

0 

83 

131 

203 

10000011 

a 

B3 

179 

263 

10110011 

0 

84 

132 

204 

10000100 

a 

B4 

180 

264 

10110100 

te 

85 

133 

205 

10000101 

a 

85 

181 

265 

10110101 

C 

86 

134 

206 

10000110 

a 

B6 

182 

266 

10110110 

A 

87 

135 

207 

10000111 

C 

B7 

183 

267 

10110111 

A 

88 

136 

210 

10001000 

e 

B8 

184 

270 

10111000 

0 

89 

137 

211 

10001001 

e 

B9 

185 

271 

10111001 

" 

80 

138 

212 

10001010 

e 

B0 

186 

272 

10111010 

8B 

139 

213 

10001011 

i" 

BB 

187 

273 

10111011 

t 

8C 

140 

214 

1000U0B 

l 

BC 

188 

274 

10111100 

<y 

8D 

141 

215 

10001101 

i 

BD 

189 

275 

10111101 

© 

8E 

142 

216 

10001110 

A 

BE 

190 

276 

10111110 

8F 

143 

217 

10001111 

A 

BF 

191 

277 

10111111 

TX 
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Hex.  Dez.  Oktal  Binar  Zeichensatz  Hex.  Dez.  Oktal 


C0 

192 

300 

11000000 

Cl 

193 

301 

11000001 

C2 

194 

302 

11000010 

C3 

195 

303 

11000011 

C4 

19B 

304 

11000100 

C5 

197 

305 

11000101 

CB 

198 

306 

11000110 

C7 

199 

307 

11000111 

C8 

200 

310 

11001000 

C9 

201 

311 

11001001 

CA 

202 

312 

11001010 

CB 

203 

313 

11001011 

CC 

204 

314 

11001100 

CD 

205 

315 

11001101 

CE 

206 

316 

11001110 

CF 

207 

317 

11001111 

D0 

208 

320 

11010000 

D1 

209 

321 

11010001 

D2 

210 

322 

11010010 

D3 

211 

323 

11010011 

D4 

212 

324 

11010100 

D5 

213 

325 

11010101 

D6 

214 

326 

11010110 

D7 

215 

327 

11010111 

DS 

216 

330 

11011000 

D9 

217 

331 

11011001 

DA 

218 

332 

11011010 

DB 

219 

333 

11011011 

DC 

220 

334 

11011100 

DD 

221 

335 

11011101 

DE 

222 

336 

11011110 

DF 

223 

337 

11011111 

E0 

224 

340 

11100000 

El 

225 

341 

11100001 

E2 

226 

342 

11100010 

E3 

227 

343 

11100011 

E4 

228 

344 

11100100 

E5 

229 

345 

11100101 

E6 

230 

346 

11100110 

E7 

231 

347 

11100111 

E8 

232 

350 

11101000 

E9 

233 

351 

11101001 

EA 

234 

352 

11101010 

EB 

235 

353 

11101011 

EC 

236 

354 

11101100 

ED 

237 

355 

11101101 

EE 

238 

356 

11101110 

EF 

239 

357 

11101111 

ij 

F0 

240 

360 

U 

FI 

241 

361 

it 

F2 

242 

362 

1 

F3 

243 

363 

J 

F4 

244 

364 

1 

F5 

245 

365 

71 

F6 

246 

366 

7 

F7 

247 

367 

7 

F8 

248 

370 

77 

F9 

249 

371 

0 

FA 

250 

372 

FB 

251 

373 

3 

FC 

252 

374 

7 

FD 

253 

375 

D 

FE 

254 

376 

3 

FF 

255 

377 

D 

V 
3 
2 
P 
"1 
W 

n 

l 

l 

Q 

V 
§ 
A 

CO 

a 

p 

r 

T 

I 

0 

JU 

f 

e 

G 

Q 

5 

<P 

0 

e 

n 


Binar  Zeichensatz 


11110000 
11110001 
11110010 
11110011 
11110100  f 

11110101  J 

11110110  r 
11110111  = 
11111000  ° 
11111001  * 
11111010  . 
11111011 
11111100  n 
11111101  2 
11111110  3 
11111111 


III  HH  /SI  VI 
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Anhang  F: 

Patchvariablen  im  Festplattentreiber  AHDI 


Die  Programmdatej  des  Atari-Festplattentreibers  AHDI  enthalt  ab  Version  3.00  mehrere  zum 
Verandemfreigegebene  Patehvariablen  (zu  finden  in  “AHDI.PRG”  bzw.  “SHDRIVER.SYS”). 
Die  modifizierbaren  Werte  beziehen  sich  auf  GEMDOS-Pool  und  maximale  SektorgroBe 
(sieheGEMDOS-Einleitung)sowiedieReservienmgvonLaufwerkskennungenfiirwechselbare 
Medien  (siehe  BIOS-Einleitung,  “Unterstiitzung  von  Wechselplatten”). 

Die  angegebenen  Offsets  beziehen  sich  auf  das  erste  Byte  der  Programmdatei: 


Offset 

Grofie 

Inhalt 

$28 

UWORD 

“Magic  number”  $F0AD.  Nur  dann,  wenn  hier  der  richtige  Wert 
steht,  diirfen  die  folgenden  Werte  verandert  werden. 

$2A 

UWORD 

Versionsnummer,  zum  Beispiel  $300  fiir  AHDI  3.00. 

$2C 

UWORD 

Anzahl  der  zusatzlichen  Eintrage  fiir  den  GEMDOS-Pool  (nor- 
malerweise  128,  wird  nur  in  GEMDOS-Versionen  vor  0.15 
benutzt,  siehe  Erlauterungen  zu  “FOLDR100.PRG’) 

$2E 

UWORD 

Maximale  SektorgroBe  (siehe  in  der  GEMDOS-Einleitung: 
“GEMDOS-Puffer”) 

$30 

UWORD 

Anzahl  der  Eintrage  in  der  folgenden  Tabelle  (in  Bytes) 

$32 

BYTE 

Anzahl  der  zu  reservierenden  Laufwerksbuchstaben,  falls  es 
sich  um  ein  wechselbares  Medium  handelt  (siehe  BIOS-Einlei- 
tung:  “Unterstiitzung  von  Wechselplatten”). 

Bemerkungen 

Neuere  AHDI-Versionen  (ab  4.00)  haben  fiir  die  SCS  1-Gerate  nicht  etwa  eine  vergroBerte 
Tabelle,  sondem  eine  zweite,  zusatzliche. 


Anhang  G: 

Das  IMG-Format  fur  Rasterbilder 
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Eine  Datei  mit  Bildinformationen  im  IMG-Fonnat  tragt  immer  die  Namenserweiterung 
“IMG”.  Der  Header  der  Datei  hat  die  Gestalt: 

typedef  struct 
{ 

UWORD  ±m_version;  /*  Versionsnummer  der  Iraagedatei  */ 

DWORD  im_headlength;  /*  Lange  des  Headers  in  Words  */ 

UWORD  im_nplanes;  /*  Anzahl  der  Farbebenen  */ 

UWORD  imjpatlen;  /*  Musterlange  in  Byte  */ 

UWORD  im_pixwidth;  /*  Pixelbreite  in  ram/1000  */ 

UWORD  imjpixjheight;  /*  Pixelhohe  in  mm/1000  */ 

UWORD  im_scanwidth;  /*  Zeilenbreite  in  Pixeln  */ 

UWORD  im_nlines?  /*  Anzahl  der  Scanlines  */ 

}  I MG HEADER; 

Die  Lange  des  Headers  muB  immer  tiberpriift  werden,  derm  in  kunftigen  GEM-Versionen 
konnte  sich  seine  Lange  (z.  B.  zur  Aufhahme  einer  Farbpalette)  andem.  Altere  Programme, 
die  diese  Mehrinformation  nicht  verarbeiten  konnen,  iiberspringen  dann  einfach  den  Rest  der 
Struktur.  Die  Lange  der  Muster  liegt  zwischen  1  und  8;  bei  den  meisten  Bildschirmen  betragt 
die  Musterlange  zwei  Bytes.  Jede  Scanline-Information  setzt  sich  aus  zwei  Komponenten 
zusammen: 

-  Wiederholungsteil 

typedef  struct 
{ 

WORD  scjzero;  /*  immer  0  */ 

BYTE  sc_ff;  /*  immer  255  (=0xFF)  */ 

BYTE  sc__cnt;  /*  Anzahl  der  kodierten  Bildzeilen  */ 

}  SCANLINE; 


-  eigentliche  Bildinformation 

Die  Bildinformationen  werden  in  drei  verschiedenen  Kodierungeo  zeilenweise  ab- 
gespeichert; 
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-  Einfarbige  Pixelfolgen  (“Solid  Run”)  werden  als  einfaches  Byte  gespeichert,  wobei  das 
oberste  Bit  den  Status  des  Punktes  bestimmt  (also  “an”  oder  “aus”).  Die  restlichen  sieben 
Bits  teilen  mit,  wie  viele  Bytes  ausgegeben  werden  sollen. 

-  48  gesetzte Pixel  wtirden  also  als  $86  ($80 + $6)  kodiert,  acht  nicht  gesetzte  Pixel  als  $06. 

-  Musterfolgen  (“Pattern  Run”)  haben  als  erstes  Byte  die  0  und  als  zweites  die  Anzahl  der 
Musterwiederholungen.  Die  Musterlange  steht  im  Header  unter  “irnjpatlen”.  Es  folgen 
den  ersten  beiden  Bytes  also  genau  so  viele  Bytes,  wie  bendtigt  werden,  um  das  Muster 
darzustellen. 

typedef  struct 
{ 

BYTE  pr_zero;  /*  irtutier  0  */ 

BYTE  pr_cnt;  /*  Anzahl  der  Bytes  */ 

BYTE  pr_data [ . . .  ] ;  /*  Musterdaten  */ 

}  PATTERNRUN; 


-  Schlecht  oder  nicht  verkiirzbare  Bildinformation  (“Bit  String”5  wird  unverandert 
abgespeichert.  Hier  steht  als  erstes  Byte  eine  $80  und  als  zweites  die  Anzahl  der  Bytes. 
Danachfolgen  danndieentsprechenden  Bytes  mitderunkomprimiertenBildinformation. 

typedef  struct 
{ 

BYTE  bs_first;  /*  immer  0x80  */ 

BYTE  bs_cnt;  /*  Anzahl  der  Bytes  */ 

BYTE  bs_data [ . . ] ;  /*  Bilddaten  */ 

}  BITSTRING; 


Es  folgen  jeweils  die  Bildinformationen  fiir  jede  kodierte  Farbebene  direkt  hintereinander. 
Man  sollte  auch  darauf  achten,  dafi  immer  eine  Zeile  mit  voller  Bytezahl  codiert  wird,  auch 
wenn  das  Bild  effektiv  schmaler  ist. 

Es  konnen  also  bis  zu  sieben  Bits  “uberfliissiger”  Information  vorliegen.  Die  Pixelbreite  des 
Bildes  steht  im  Dateikopf  unter  “im_scanwidth”. 

Leider  ist  das  IMG-Format  fiir  die  Arbeit  mit  Farbgrafiken  nur  sehr  bedingt  geeignet.  Die 
GEM-Dokumentation  spricht  zwar  von  einer  separaten  Speicherung  von  Rot-,  Griin-,  Blau- 
und  Grau-Informationen  -  wie  das  aber  genau  aussehen  soli,  ist  unkiar. 


Anhang  G:  Das  IMG-Format  fiir  Rastcrbilder 
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Mogliche  Abhilfen: 

1.  Farbpaletteninformation  in  einer  begleitenden  Metadatei  (siehe  VDI-Funktion 
“v_bit_image()”)  ablegen. 

2.  Anderes,  leistungsfahigeres  Bildformat  verwenden  (die  PC-  und  Macintosh-Welt  schei- 
nen  dariiber  iibereinzustimmen,  dafi  TIFF  das  Format  der  Wahl  ist). 

3.  Einige  Programme  unterstiitzen  auch  das  sogenannte  “XIMG”-Format,  das  von  Dieter 
und  Jurgen  GeiB  vorgeschlagen  und  bei  dem  der  Dateikopf  um  Paletteninformationen 
erweitert  worden  ist: 


Offset 

GroBe 

Belegung 

$10 

LONG 

Konstante  “XIMG”  als  ASCH-Zeichen 

$14 

WORD 

Farbmodell  (0:  RGB,  1:  CMY,  2:  Pantone) 

$16ff 

WORD 

jeweils  drei  16-Bit-Werte  pro  Farbregister,  im  RGB- 
Modell  mit  der  Standard- VDI-Farbbeschreibung  (Rot-, 
Griin-  und  Blau-Wert  in  Promille) 

Das  Feld  “im_headlength”  muB  natiirlich  angesichts  des  langeren  Dateikopfes  entsprechend 
verandert  werden. 


Anhang  H:  Kurzeinfiihrimg 

in  die  Syntax  der  Programmiersprache  C 
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Diese  Kurzeinfiihrung  soli  es  Nicht-C-Programmierem  erleichtem,  die  abgedruckten  Bei- 
spiele  und  Bindings  zu  lesen.  Sie  erhebt  keinen  Anspruch  auf  Vollstandigkeit  und  kann  na- 
tiirlich  ein  “richtiges”  C-Buch  nicht  ersetzen  -  ebensowenig,  wie  man  in  sieben  Tagen  alle  Se- 
henswiirdigkeiten  Europas  besichtigen  kann.  Alle  Beispiele  beziehen  sich  auf  die  relativ  neue 
ANSI-Nomn,wiesieweitestgehendvon‘Turbo-C’undvollstandigvonGNU-CCimplementiert 
wird. 


Operatoren 


Beispiel 

Ergebnis 

-a 

Negation  von  a 

*a 

Inhalt  des  Zeigers  a 

&  a 

Adresse  der  Variablen  a 

~a 

logische  Negation  von  a 

++a 

inkrementiere  zunachst  a  und  betrachte  a  dann 

a++ 

betrachte  a  und  inkrementiere  a  anschlieBend 

~a 

dekrementiere  zunachst  a  und  betrachte  a  dann 

a- 

betrachte  a  und  dekrementiere  a  anschlieBend 

sizeof  (TYP) 

GroBe  des  Datentyps  TYP  in  Bytes 

sizeof  (EXP) 

GroBe  des  Ausdrucks  EXP  in  Bytes 

(TYP)  EXP 

Wert  des  Ausdrucks  EXP  wird  nach  Datentyp  TYP  konvertiert 

a  +  b 

a  plus  b 

a-b 

a  minus  b 

a  *  b 

a  mal  b 

a  /b 

a  durch  b 

a  %  b 

a  modulo  b 

a»b 

a  urn  b  Bits  nach  rechts  verschoben 

a«b 

a  um  b  Bits  nach  links  verschoben 

a  <b 

ungleich  Null,  falls  a  <  b 

a>b 

ungleich  Null,  falls  a  >  b 

a  <=  b 

ungleich  Null,  falls  a  <=  b 

a>=  b 

ungleich  Null,  falls  a  >=  b 

a  —  b 

ungleich  Null,  falls  a  =  b 
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Beispiel 

Ergebnis 

a  !=  b 

ungleich  Null,  falls  a  ungleich  b 

a  &  b 

a  bitweise  undiert  mit  b 

a  1  b 

a  bitweise  oderiert  mit  b 

a  A  b 

a  bitweise  xoderiert  mit  b  (excl.  oder) 

a&&  b 

a  logisch  undiert  mit  b 

a  lib 

a  logisch  oderiert  mit  b 

!a 

NOT  a 

a?  EXP1:EXP2 

EXP1  falls  a  ungleich  0,  sonst  EXP2 

a  =b 

a  wird  der  Wert  von  b  zugewiesen 

a  +=  b 

zu  a  wird  b  addiert  (*) 

a  -=  b 

von  a  wird  b  subtrahiert  (*) 

a  *=  b 

a  wird  mit  b  multipliziert  (*) 

a/=b 

a  wird  durch  b  geteilt  (*) 

a  %=  b 

a  wird  der  Rest  von  (a/b)  zugewiesen  (*) 

a  »=  b 

a  wird  um  b  Bits  nach  rechts  geschoben  (*) 

a  «=  b 

a  wird  um  b  Bits  nach  links  geschoben  (*) 

a  &=  b 

a  wird  mit  b  undiert  (*) 

a  1=  b 

a  wird  mit  b  oderiert  (*) 

a  A=  b 

a  wird  mit  b  x-oderiert  (*) 

EXP1  ,  EXP2 

erst  wird  EXP1,  dann  EXP2  ausgewertet;  Resultat  ist  der  Wert  von 
EXP2 

a[] 

Feld-Selektor 

a->b 

Element  b  der  Struktur,  auf  die  a  zeigt 

a.b 

Element  b  der  Struktur,  die  bei  a  beginnt 
(*)  Ergebnis  ist  jeweils  der  (neue)  Wert  von  a 

Datentypen 

Folgende  grundlegende  Datentypen  werden  in  diesem  Buch  verwendet: 


char  hier  pa8t  ein  Zeichen  hinein  (GroBe:  8  Bit) 

BYTE  ganzzahliger  Wert  zwischen  0  und  255  (GroBe:  8  Bit) 

WORD  ganzzahliger  Wert  zwischen  -32768  und  32767  (GroBe:  16  Bit) 

UWORD  ganzzahliger  Wert  zwischen  0  und  65535  (GroBe:  16  Bit) 

LONG  ganzzahliger  Wert  zwischen  -2147483648  und  2147483647  (GroBe:  32  Bit) 
ULONG  ganzzahliger  Wert  zwischen  0  und  4294967295  (GroBe:  32  Bit) 


Aus  diesen  “skalaren”  Datentypen  kann  man  neue  Typen  konstruieren.  Das  einfachste  Bei- 
spiel  ist  ein  Array  in  der  Form: 


Anhang  H:  Kurzeinfiihrung  in  die  Syntax  der  Programmiersprache  C 


1271 


TYPNAME  Variablenname[Grofle] ;  /*  Kommentar:  ein  Array  */ 

Ein  Beispiel: 

WORD  int_in[16] ; 

deklariert  also  ein  Feld  mit  Platz  fiir  1 6  WORD- Variablen,  Die  Numerierung  der  Feldelemente 
beginnt  im  Gegensatz  zu  Pascal  immer  bei  Null  -  die  defmierten  Feldelemente  liegen  also 
zwischen  int_in[0]  und  intjn[15]. 

C-Zeichenketten  sind  einfach  nur  Felder  von  “char”-Variablen,  wobei  das  Ende  durch  ein 
Nullbyte  gekennzeichnet  ist. 

char  fragef]  =  "Was  soli  das?"; 

reserviert  also  Platz  fur  14  Zeichen  -  13  fiir  die  Zeichen  und  eines  fiir  das  Nullbyte. 

Wichtig  sind  auch  die  Pointer,  also  Zeigervariablen.  Bei  vielen  Betriebssystemaufrufen 
werden  nicht  die  Daten  selbst,  sondem  ein  Zeiger  darauf  iibergeben.  Dies  passiert  meist  dann, 
wenn  die  Information  nicht  in  einen  skalaren  Datentyp  paBt  -  zum  Beispiel  ein  Dateiname. 
Eine  Zeigerdeklaration  sieht  so  aus: 

TYPNAME  *Variablennajne;  /*  Ein  Zeiger  */ 

Ein  Beispiel: 

WORD  *zeiger;  /*  Ein  Zeiger  auf  ein  WORD  */ 

Zur  Arbeit  mit  Zeigern  braucht  man  zwei  Operatoren,  den  zum  Derefenzieren  und 
zum  Referenzieren. 

Ein  Beispiel: 

WORD  zahl; 

WORD  * zeiger; 

zahl  =  5; 
zeiger  =  szahl; 

*zeiger  =  7; 


/*  zahl  enthalt  den  Wert  5  */ 

/*  zeiger  enthalt  die  Adresse  der  Variablen 
zahl  */ 

/*  die  Variable,  auf  die  zeiger  zeigt  (also 
zahl)  wird  auf  7  gesetzt  */ 
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Intern  behandelt  ein  C-Compiler  Felder  und  Zeigervariablen  (fast)  identisch.  Dies  auBert  sich 
besonders  anschaulich  in  der  Gleichheit  von 

"name  [index] "  und  "*  (name+index)  " 

Dainit  stehen  alle  folgenden  Ausdriicke  fiir  das  gleiche: 

"name[0]",  "*name"  und  "0[name]" 

Es  gentigt  zu  wissen,  daB  man  in  der  Praxis  Zeiger  als  Felder  und  umgekehrt  betrachten  kann. 

Komplizierter  wird  es  da  schon  bei  den  Datenstrukturen,  bei  denen  man  mehrere  einfachere 
Datentypen  zu  einer  gemeinsamen  Struktur  zusammenfaBt: 


typedef  struct 
{ 

WORD 

ob  next; 

/* 

Nummer  des  nachsten  Objekts  */ 

WORD 

ob_head; 

/* 

Nummer  des  ersten  Kinds  */ 

WORD 

ob  tail; 

/* 

Nummer  des  letzten  Kinds  */ 

UWORD 

objtype ; 

/* 

Art  des  Objekts  */ 

DWORD 

ob__flags; 

/* 

Verschiedene  Flags  */ 

UWORD 

ob  state; 

/* 

Status  des  Objekts  */ 

ULONG 

ob  spec; 

/* 

Typabhangig  */ 

WORD 

ob__x; 

/* 

X-Position  (rel.  zum  Parent- 
Objekt)  */ 

WORD 

obj/; 

/* 

Y-Position  (rel.  zum  Parent- 
Objekt)  */ 

WORD 

ob  width; 

/* 

Breite  */ 

WORD 

}  OBJECT; 

ob  height; 

/* 

Hohe  */ 

Dies  wiirde  in  Pascal  folgendermaBen  aussehen: 

TYPE 

OBJECT  =  RECORD 

ob_next  :  integer; 
ob_head  :  integer; 
ob_tail  :  integer; 
objtype  :  integer; 
ob_flags  :  integer; 
ob_state  :  integer; 
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ob_spec  :  long_integer; 
ob_x  :  integer; 

ob_y  :  integer; 

ob_width  :  integer; 
ob_height  :  integer; 

END; 

Wer  in  keiner  Hochsprache  programmiert,  wird  sich  mehr  dafiir  interessieren,  wie  so  eine 
Struktur  im  Speicher  aussieht.  Trifft  ein  Compiler  auf  eine  Strukturdeklaration,  dann  reser- 
viert  er  zunachst  einmal  einen  Speicherbereich  mit  der  GesamtgroBe  der  Struktur,  die  sich  aus 
der  Summe  der  Strukturkomponenten  berechnet.  Beispiel: 

OBJECT  box; 

Damit  ist  ein  24  Bytes  groBer  Speicherbereich  fiir  die  Datenstruktur  reserviert.  Was  passiert, 
wenn  man  auf  eine  Strukturkomponente  zugreift? 

box.ob_width  =10; 

Der  Compiler  iiberlegt  sich  nun,  wie  groB  alle  in  der  Struktur  davor  liegenden  Komponenten 
sind.  Die  Anwort  ist  -  nicht  iiberraschend  -  20.  Erzeugt  wird  also  ein  Assemblerbefehl,  der 
ungefahr  so  aussieht: 

move.w  #10,  box+20 

Das  heiBt,  dab  jede  Strukturkomponente  einen  festen  Offset  innerhalb  der  Objektstruktur  hat, 
die  wir  auch  im  Anhang  “Wichtige  Betriebssystemstrukturen”  angegeben  haben. 

Komplizierter  wird  es  schon  bei  so  einer  Anweisung; 

OBJECT  *boxpnt; 
boxpnt~>ob_width=l 0 ; 

Hier  haben  wir  in  “boxpnt”  einen  Zeiger  auf  ein  Objekt.  Erzeugt  wird  in  diesem  Fall  ungefahr 
Assembler-Code  der  Form: 

move . 1  boxpnt ,  aO 

move.w  #10,  20 (aO) 


Es  wird  also  20  zu  der  Adresse  addiert,  die  in  “boxpnt”  steht  und  das  Ergebnis  als  Zeiger- 
variable  verwendet. 
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Fur  die  vom  Betriebssy  stem  benutzten  S  trukturen  sind  die  Offsets  der  einzelnen  Komponenten 
naturlich  fest  definiert.  Dies  gilt  allerdings  im  allgemeinen  fur  C-Strukturen  nicht.  Ein  C- 
CompOer  kann  durchaus  zwischen  den  einzelnen  Strukturkomponenten  unbenutzte  Bytes 
einfiigen,  um  Laufzeitoptimierungen  zu  erreichen.  Dies  ist  aber  normalerweise  bei  Compilem 
auf  Motorola-Systemen  nicht  der  Fall  -  aufier,  es  werden  Fiillbytes  eingefiigt,  um  einen 
WORD-  oder  LONG- Wert  auf  eine  gerade  Adresse  zu  verschieben. 

Bitfelder  sind  enge  Verwandte  der  normalen  C-Strukturen  -  nur  dieses  Mai  werden  den  ein¬ 
zelnen  Bits  eigene  Namen  zugewiesen: 

typedef  struct 
{ 

unsigned  character 
signed  framesize 
unsigned  framecol 
unsigned  text col 
unsigned  textmode 
unsigned  fillpattern 
unsigned  interiorcol 
}  bfobspec; 

Die  Art  und  Weise,  wie  ein  C-Compiler  diese  Bits  anordnet,  ist  vom  Compiler  anhangig. 
Uberall,  wo  im  Profibuch  Bitfelder  auftauchen,  gelten  die  Angaben  fur  “Turbo-C”,  das  in 
diesem  Fall  folgende  Aufteilung  benutzen  wiirde: 


8;  /*  Wert  zw.  0  und  255  (8  Bits)  */ 

8;  /*  Wert  zw.  -128  und  127  (8  Bits)  */ 
4;  /*  Wert  zwischen  0  und  15  (4  Bits)*/ 
4; 

1;  /*  0  Oder  1  */ 

3;  /*  Wert  zwischen  0  und  7  (3  Bits)  */ 
4;  /*  Wert  zwischen  0  und  15  (4  Bits)*/ 


Bits 

Feldelement 

24.. 31 

character 

16..23 

framesize 

12.. 15 

framecol 

8. .11 

textcol 

7 

textmode 

4.  .6 

fillpattern 

0..3 

interiorcol 

Funktionen 

Eine  C-Funktion  ist  -  grab  vereinfacht  ausgedriickt  -  eine  Reihe  von  Maschineninstruktionen, 
denen  man  einige  Parameter  iibergibt  und  ein  Ergebnis  zuriickerhalt.  Dazu  ein  Beispiel  fur 
eine  Funktionsdeklaration  in  ANSI-C: 
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LONG  Bconin  (WORD  dev) ; 

Eingabeparameter  ist  also  ein  WORD-Parameter  namens  “dev”,  und  zurilckgeliefertwird  von 
der  Funktion  ein  LONG-Retumwert.  Anstelle  einfacher  skalarer  Datentypen  konnen  natiirlich 
auch  kompliziertere  Datenstrukturen  auftreten: 

BPB  *Getbpb  (WORD  dev) ;  /*  Funktion  liefert  einen  Zeiger  auf  eine 

BPB-Struktur  */ 

Im  folgenden  Beispiel  erhalt  die  Funktion  als  ersten  Parameter  einen  Zeiger  auf  eine  Zeichen- 
kette: 

WORD  Fcreate  (char  *fname,  WORD  attribs) ; 

Auf  welche  Art  und  Weise  die  Parameteriibergabe  erfolgt,  kann  fiir  jeden  C-Compiler 
unterschiedlich  sein.  Die  im  TOS  benutzten  Ubergabemechanismen  wurden  natiirlich  durch 
den  bei  der  Entwicklung  von  TOS  benutzten  Compiler  (“Alcyon-C”)  gepragt: 

Parameter  werden  von  rechts  nach  links  nacheinander  auf  dem  Stack  abgelegt. 

Der  Riickgabewert  wird  im  Datenregister  DO  iibergeben. 

“Turbo-C”  hingegeniibergibtnormalerweisemehrere  Parameter  inDaten-und  AdreBregistem, 
was  natiirlich  zu  kiirzeren  und  schnelleren  Maschinencodes  fiihrt.  Normalerweise  kiimmem 
sich  die  Standardbibliotheken  um  die  notwendigen  Anpassungen.  Immer  dann,  wenn  man  di- 
rekt  Betriebssystemfunktionen  aufruft  (zum  Beispiel  bei  der  Benutzung  von  “shell_p”  oder 
bei  der  Programmierung  von  XControl-Erweiterungen),  muS  man  ‘Turbo-C’  durch  das 
Schliisselwort  “cdecl”  anweisen,  die  “alte”  Form  der  Parameteriibergabe  zu  benutzen.  Besit- 
zer  anderer  Compiler  konnen  dieses  Schliisselwort  gefahrlos  ignorieren. 


“void”  und  “const” 

Bei  vielen  Funktionen  taucht  auch  das  Schliisselwort  “void"  auf.  Je  nach  Kontext  hat  es  eine 
geringfiigig  andere  Bedeutung: 

-  Allein  vor  einer  Funktionsdeklaration  stehend,  gibt  es  an,  da8  die  Funktion  keinen  sinn- 
vollen  Wert  zuriickliefert.  Beispiel: 

void  Bconout  (WORD  dev,  WORD  c) ; 

-  Als  einziger  Parameter  einer  Funktion  legt  es  fest,  daft  die  Funktion  tatsachlich  gar  keine 
Parameter  erhalt.  Beispiel: 
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DTA  *Fgetdta  (void); 

-  Im  Zusammenhang  mit  einer  Zeigervariablen  gibt  es  an,  dafi  der  Zeiger  auf  keinen 
bestimmten  Datentyp  zeigt.  Solche  “void”-Zeiger  konnen  jeder  anderen  Zeigervariablen 
zugewiesen  werden.  Beispiel: 

void  *Malloc  (LONG  amount) ; 
char  * zeichenkette; 

OBJECT  *ein_objekt; 


zeichenkette  =  Malloc  (20  *  sizeof  (char) ) ;  /*  Platz  fur  20 

Zeichen  */ 

ein_objekt  =  Malloc  (sizeof  (OBJECT) ) ;  /*  Platz  fur 

OB JECT-St  ruktur  * / 

Anmerkung :  Die  Syntax  in  den  ersten  beiden  Beispielen  ist  tatsachlich  etwas  merkwiirdig. 
Logischere  Schreibweisen  wie 

Bconout  (WORD  dev,  WORD  c) ; 

bzw. 

DTA  *Fgetdta  ()  ; 

waren  allerdings  aus  Griinden  der  Ruckwartskompatibilitat  zum  “alten”  C  nicht  moglich. 

Das  Wortchen  “const”  kommtmeistbei  Parametem  von  Funktionen  vor  und  legt  fest,  daB  die 
aufgerufene  Funktion  den  Inhalt  des  Parameters  nicht  verandert.  Beispiel: 

void  print_it  (const  char  * zeichen) ; 

Hierbliebe  also  die  Zeichenkette,  auf  die  “zeichen”  zeigt,  garantiert  intakt.  Aus  Zeitgriinden 
und  wegen  fehlender  Dokumentation  war  es  uns  leider  nicht  moglich,  diese  Eigenschaft  filr 
jede  einzelne  Betriebssystemfunktion  zu  verifizieren.  Dort,  wo  das  Wort  auftaucht,  darf  man 
aber  davon  ausgehen,  daB  die  Daten  tatsachlich  nicht  verandert  werden. 


Kontrollstrukturen 

Und  schlieBlich  noch  eine  kurze  Ubersicht  fiber  die  Kontrollstrukturen  der  Sprache  C: 
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if  (Ausdruck) 

Anweisung; 

Wenn  der  Ausdruck  wahr  (also  ungleich  Null)  ist,  wird  die  Anweisung  ausgefiihrt.  Uberall 
dort,  wo  eine  Anweisung  stehen  darf,  kann  auch  ein  ganzer  Anweisungsblock  eingefugt 
werden: 

if  (Ausdruck) 

{ 

Anweisungl; 

Anweisung2; 

} 

Zusatzlich  kann  ein  “else”-Zweig  angefiigt  werden: 

if  (Ausdruck) 

Anweisungl; 

else 

Anweisung2; 

Fiir  Fallunterscheidungen  gibt  es  “switch”: 

switch  (Ausdruck) 

{ 

case  Konstantel :  Anweisungen. . . 

case  Konstante2 :  Anweisungen . . . 

default:  Anweisungen... 

} 

Zunachst  wird  der  Wert  des  Ausdrucks  ermittelt.  Stimmt  das  Ergebnis  mit  einer  der  angegebe- 
nen  Konstanten  ti herein,  dann  werden  alle  folgenden  Anweisungen  bis  zum  ersten  “break” 
bzw.  bis  zum  Ende  der  switch-Struktur  ausgefiihrt.  Ist  der  errechnete  Wert  mit  keiner  der  Kon¬ 
stanten  identisch,  wird  bei  “default”  fortgefahren.  Ublicherweise  sehen  daher  switch- Anwei¬ 
sungen  so  aus: 

switch  (wert) 

{ 

case  KONSTANTE1: 
case  KONSTANTE2: 

Anweisungen; 

break; 
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case  K0NSTANTE3: 

Anweisungen; 

break; 

default : 

/*  Fehlerbehandlung  */ 
break; 

} 

C  kennt  mehrere  Typen  von  Schleifen,  die  einfachste  davon  ist  die  while-Schleife: 

while  (Ausdruck) 

Anweisung; 

Die  Anweisung  (oder  der  Anweisungsblock)  wird  also  so  lange  ausgefiihrt,  bis  der  Ausdruck 
nicht  mehr  wahr  ist.  Diese  Form  der  Schleife  ist  abweisend,  die  Anweisung  wird  also  dann  gar 
nicht  ausgefiihrt,  wenn  der  Ausdruck  gleich  zu  Beginn  falsch  ist.  Anders  bei: 

do 

Anweisung; 
while  (Ausdruck) ; 

In  diesem  Fall  erfolgt  der  erste  Test  erst  nach  dem  ersten  Schleifendurchlauf.  Sowohl  lei- 
stungsfahig  als  auch  schwer  lesbar  ist  die  for-Schleife: 

for  (Ausdruckl;  Ausdruck2;  Ausdruck3) 

Anweisung; 

ist  eine  Abkiirzung  fiir: 

Ausdruckl; 
while  (Ausdruck2) 

{ 

Anweisung; 

Ausdruck3; 

} 

Dazu  ein  Beispiel: 

for  (i  =0;  i  <  10;  i++) 
workinfi]  =  0; 


/*  Initialisierung  */ 
/*  Abbruchbedingung  */ 


/*  Schleifenzahler  weiterfuhren  */ 
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ist  identisch  mit: 
i  =  0; 

while  (1  <  10) 

{ 

workinfi]  =  0; 
i++; 


Es  sei  noch  erwahnt,  daB  jeder  der  Ausdriicke  und  auch  die  Schleifenanweisung  leer  sein 
konnen: 

for  <;;)  /*  Endlosschleife  */ 

Anweisung; 

oder 

for  (  ;  i  <  10;  workin[i++]  =  0)  /*  leere  Anweisung  */; 

Zum  AbschluB  noch  “break”  und  “continue”: 

break:  Ausflihrung  der  Schleife  beenden  und  bei  der  nachsten  auf  die  Schleife 

folgenden  Anweisung  fortsetzen. 

continue:  Beginn  des  nachsten  Schleifendurchlaufs  erzwingen. 
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Neben  den  “groBen”  Entwicklungssystemen  gibt  es  eine  ganze  Reihe  von  niitzlichen  Tools, 
die  bei  der  Programmentwicklung  unter  TOS  helfen  konnen.  Die  folgende  Auswahl  erhebt 
keinen  Anspruch  auf  Vollstandigkeit,  sondem  spiegelt  nur  die  Vorlieben  der  Autoren  wieder. 
Speziell  die  Programme  “SysMon”  und  “TempleMon”  seien  jedem  engagierten  Programmie¬ 
rer  ans  Herz  gelegt  -  diese  Werkzeuge  machen  das  Debuggen  von  systemnahenProgrammen 
eigentlich  erst  mbglich! 


BigScreen 

BigScreen  vom  Profibuch- Autor  Julian  Reschke  ermoglicht  es,  auf  herkommlichen  ST-,  STE- 
oder  TT-Systemen  eine  grofiere  Bildflache  zu  simulieren.  Damit  ist  es  moglich,  Programme 
auf  Auflosungsunabhangigkeitzu  testen  oderauch  ohneGrafikkarte  VersucheinFarbauflosun- 
gen  zu  untemehmen.  BigScreen  lauft  in  alien  Standardauflosungen  des  ST,  STE  und  TT  und 
erfordert  eine  TOS-Version  groBer  gleich  1 .04.  Man  bekommt  es  (zusammen  mit  Stefan 
Eissings  Drucker-Spooler  “SPEX”)  bei  der 

SciLab  GmbH 
IsestraBe  57 
D-W2000  Hamburg  13 


SysMon 

SysMon  ist  ein  System-Monitor,  der  genau  an  der  Schnittstelle  zwischen  Betriebssystem  und 
anderen  Programmen  sitzt,  die  mit  diesem  Betriebssystem  arbeiten.  Der  SysMon  ermoglicht 
es,  die  Aufrufe  an  das  Betriebssystem  mitzuprotokollieren.  Er  ist  auch  in  derLage,  den  Zustand 
einzelner  Systemresourcen  -  wie  Speicherblocke  und  Systemvektoren  -  anzuzeigen.  Monitor 
bedeutet  aber  auch,  daG  der  Zustand  des  Systems  nur  beobachtet  und  nicht  verandert  werden 
kann.  SysMon  gliedert  sich  in  zwei  generelle  Teile.  Der  erste  Teil  kann  die  Aufrufe  von  Sy- 
stemfunktionenmitprotokollieren  (der  Tracer),  und  der  zweiteTeil  istfurdie  Anzeige  von  Sy¬ 
stemresourcen  zustandig  (der  Monitor). 

Der  Tracer  unterstiitzt  alle  dokumentierten  Systemfunktionen  und  ist  in  weiten  Bereichen 
konfigurierbar.  Er  kann  alle  Aufrufe  von  Systemfunktionen  durch  das  Betriebssystem  oder 
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von  Programmen  mitprotokollieren.  Einzelne  Systemaufrufe  konnen  bei  der  Ausgabe  unter- 
drlickt  und  einzelne  Programme  vom  Tracen  ausgenommen  werden.  Die  Ausgaben  konnen 
liber  verschiedene  Einstellungen  den  jeweiligen  Bediirfnissen  angepaBt  werden.  Es  sind  sehr 
viele  Erweiterungen  in  den  Tracer  eingebaut.  Es  werden  zum  Beispiel  alle  bekannten  Mes- 
sage-Protokolle,  die  zur  Kommunikation  zwischen  Applikationen  und  den  quasiparallelen 
Accessories  dienen,  unterstiitzt.  Auch  werden  alle  definierten  Konstanten  in  Textform  ausge- 
geben.  Die  Ausgaben  des  Tracers  konnen  auf  einer  zweiten  Bildschirmseite  geschehen,  auf 
die  RS-232-,  Centronics-  Oder  MIDI-Schnittstelle  ausgegeben  oder  in  einer  Datei  mitprotokol- 
liert  werden. 

Der  Monitor  zeigt  mehrere  Informationen  wie  Speicherblocke,  Systemvektoren  und  Struktu- 
ren,  die  teilweise  nur  systemintem  dokumentiert  sind.  Die  Systemvektoren  bestimmen, 
welche  Programme  auf  einzelne  Funktionen  des  Systems  EinfluB  nehmen.  Die  Speicheranzeige 
zeigt  nicht  nur  die  Lange  der  einzelnen  Bereiche,  sondem  macht  auch  Aussagen  liber  deren 
Inhalt  und  das  Programm,  das  den  Bereich  angefordert  hat.  AuBcrdcm  werden  samtliche  im 
Profibuch  dokumentierten  Systemvariablen  und  Strukturen  angezeigt. 

Beim  Starten  installiert  sich  SysMon  in  den  Systemvektoren  und  untersucht  den  Speicher  nach 
vorher  geladenen  Programmen.  Wird  SysMon  dann  iiber  eine  bestimmte  Tastenkombination 
aktiviert,  kann  man  alle  folgenden  Systemaufrufe  dokumentieren.  Da  SysMon  ziemlich  viel 
Speicher  benotigt  (ca  200  KB)  und  somit  auf  Rechnem  mit  wenig  Speicher  nicht  permanent 
geladen  werden  kann,  ist  er  in  der  Lage,  sich  selbst  wieder  aus  dem  System  zu  entfemen. 

Durch  diese  Moglichkeiten  eignet  sich  SysMon  vorziiglich  zum  Debuggen  von  eigenen 
Programmen  oder  zur  Analyse  von  fremden  Programmen.  Auch  friiher  besonders  schwer  zu 
debuggende  Probleme,  wie  die  Kommunikation  zwischen  verschiedenen  Prozessen,  sind  mit 
SysMon  schnell  und  einfach  zu  bewerkstelligen. 

SysMon  arbeitet  auf  alien  Atari-Rechnem  der  ST-,  STE-  und  T-Baureihe  und  unter  alien 
bislang  veroffentlichten  TOS-Versionen.  Da  ein  Monitor  selber  nicht  Systemfunktionen,  die 
er  beobachtet,  zur  Ausgabe  benutzen  kann,  werden  eigene  Funktionen  benutzt.  Diese 
unterstiitzen  alle  Standard-Auflosungen,  wobei  auch  Anpassungen  an  einige  zusiitzliche 
Grafikkarten  vorgenommen  wurden. 

Es  existiert  eine  Schnittstelle  zum  Maschinenspache-MonitorTempleMon,  die  es  ermoglicht, 
die  Analyse  auch  auf  die  Assembler-Ebene  auszudehnen  und  einzelne  Aufrufe  schrittweise 
abzuarbeiten.  SysMon  kostet  149,-  DM  zzgl.  Porto  und  Verpackung.  Er  ist  zu  beziehen  bei 

OverScan  Gbr 
SantisstraBe  166 
D-W1000  Berlin  48 
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Das  umfangreiche  Manual  erklart  die  Benutzung  und  Moglichkeiten  des  SysMon  und  bietet 
neben  einer  Einfiihrung  in  den  Funktionsablauf  des  Atari-Betriebssystems  und  einer  Anlei- 
tung  zum  “Auflosungsunabhangigen  Programmieren”  auch  ein  groBeres  Kapitel  iiber  Tips, 
Tricks  und  Fallstricke  bei  der  Programmierung  der  Atari-Rechner.  Filr  registrierte  Nutzer  der 
Versionen  1.0.x  gibt  es  eine  gunstige  Updatemoglichkeit. 


TempleMon 

TempleMon  ist  ein  speicherresidentes  Monitorprogramm,  das  Fehlermeldungen  (Exceptions) 
der  CPU  abfangt,  und  die  Moglichkeit  der  Betrachtung  und  Modifikation  des  CPU-Zustands 
zum  Fehlerzeitpunkt  bietet.  Bei  geeigneter  Anderung  kann  oft  das  unterbrochene  Programm 
fortgesetzt  werden,  urn  z.  B.  noch  eine  Sicherung  des  gerade  bearbeiteten  Dokumentes  vor- 
zunehmen.  Ferner  ist  auch  das  Disassemblieren  von  Speicherbereichen  und  das  Tracen  von 
Programmen  vorgesehen.  Bei  der  Verwendung  von  TempleMon  sind  Kenntnisse  iiber  Aufbau 
und  Programmierung  der  CPU  empfehlenswert. 

TempleMon  ist  ein  “Public  Domain”-Programm  und  kann  iiber  verschiedene  Mailboxen  oder 
PD-Vertriebe  bezogen  werden.  Die  Autoren  Thomas  Tempelmann  und  Johannes  Hill  bieten 
weiterhin  die  Moglichkeit  an,  sich  als  Anwender  registrieren  zu  lassen.  Dazu  schicken  Sie  bitte 
DM  30  -  mit  ausreichend  frankiertem  (fiir  einen  Brief  ca.  lOOg)  und  vollstandig  beschriftetem 
Riickumschlag  Format  C5  an 

Johannes  Hill 
AlicenstraBe  30 
D-W6100  Darmstadt  1. 

Sie  bekommen  dann  ein  Handbuch  zuriickgeschickt.  Haben  Sie  zusatzlich  noch  eine  forma- 
tierte  Diskette  beigelegt,  dann  gibt  es  auch  noch  die  neueste  Programmversion. 


Wega-Library 

Das  “WEGA”  Developer  Toolkit  ist  eine  C-Library ,  die  Funktionen  zur  komfortblen  Handha- 
bung  von  Dialogboxen  (auch  in  Fenstem)  enthalt.  Nahere  Informationen  gibt  es  beim  Profi- 
buch-Autor 

Dietmar  Rabich 

Koppelbusch  37  (bis  31.12.1991:  Dovelingsweg  2) 

D-W4408  Diilmen 
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Auf  der  Atari-Messe  in  Dusseldorf  stellte  Atari  im  September  1 989  einen  neuen  Computer  der 
ST-Serie  vor.  Er  befindet  sich  im  gleichen  Gehause  wie  der  “1040STF(M)”  und  fallt  damit 
ebenfalls  unter  die  Kategorie  Tastaturcomputer. 

Als  Produktbezeichnung  hat  Atari  die  Modellbezeichnung  “STE”  gewahlt,  was  darauf  hin- 
deuten  soil,  daB  es  sich  hier  im  Prinzip  um  einen  “normalen  ST”  handelt,  der  jedoch  in  einigen 
Punkten  erweitert  wurde  (dafiir  das  E  in  STE!). 

Bevor  es  um  Details  zu  den  einzelnen  Erwei  terungen  geht,  soil  hier  in  Kurzfassung  aufgeftihrt 
werden,  was  denn  beim  STE  anders  als  bei  seinen  “Briidem”  ist  (siehe  hierzu  auch  das  Block- 
schaltbild  Abbildung  0.2  im  Kapitel  “Einfiihrung”  des  Teils  “Die  Hardware  des  ST”). 


Die  Erweiterungen  in  Kurzfassung 

-  Leider  nicht  anders  als  bei  den  “normalen  STs”  (ausgenommen  seien  hier  die  MEGA 
STs)  ist  die  Tastatur  des  STE!  Sie  ist  die  gleiche  wie  die  der  Vorganger. 

Wesentliche  Erweiterungen  und  Anderungen  sind  jedoch  bei  der  Video-Hardware  vorgenom- 

men  worden: 

-  Der  BLITTER  ist  im  STE  serienmaBig  vorhanden! 

-  Fur  jede  der  drei  Primarfarben  Rot,  Grim  und  Blau  existieren  in  den  1 6  Farbregistem  nun 
vier  statt  bisher  drei  Bits  zur  Farbauswahl.  Damit  stehen  (ohne  besondere  Programmier- 
tricks)  in  der  niedrigen  Auflosung  dann  16  Farben  aus  2(,|+4+4>  =  212  =  4096  Farbtonen  zur 
Verfiigung! 

-  Ftir  GENLOCK-Anwendungen  (Mischen  von  Videosignalen  von  z.  B.  Videokamera 
Oder  -Recorder  mit  dem  ST- Videosignal)  ist  der  STE  von  auBen  nun  voll  synchronisierbar. 

-  Ein  zusatzliches  STB-Video-Base-Register  fiir  das  Low-Byte  der  Anfangsadresse  des 
Video-RAMs  erlaubt  nun  die  Positionierung  des  Bildschirmspeichers  im  RAM  auf 
Word-Grenzen  (bei  den  “normalen  STs”  fehlte  das  Register  fiir  das  Low-AdreBby  te,  und 
somit  konnte  der  Bildschirmspeicher  im  RAM  immer  nur  an  einer  256-Byte-Grenze 
beginnen!),  Im  STE  ist  damit  nun  vertikales  Finescrolling  moglich. 
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-  Zur  Unterstiitzung  von  horizontalem  Finescrolling  besitzt  der  STE  eineigenes  HSCROLL- 
Register. 

AuBerdem  ist  der  STE  nun  “zuganglicher”  geworden. 

-  Zusatzlichzum  vom  STbekanntenMaus-  und  JoystickanschluB  iiberdenTastaturprozessor 
hat  Atari  dem  STE  zwei  neue  Portanschlusse  mitgegeben.  liber  Adapter  lassen  sich  daran 
bis  zu  vier  weitere  Joysticks  anschlieBen.  AuBerdem  kann  an  diese  Ports  ein  Light-Pen 
bzw.  eine  Light-Gun  fur  Spiele  angeschlossen  werden.  Fiir  Hardware-Bastler  natiirlich 
besonders  interessant:  Acht  dieser  Portleitungen  an  den  neuen  Joystickbuchsen  lassen 
sich  auch  als  Ausgangsports  “miBbrauchen”! 

-  Bisher  gab  es  bei  den  STs  nur  digitale  Ein-  und  Ausgange.  Beim  STE  stehen  nun  erstmals 
an  den  zwei  neuen  Portanschliissen  auch  analoge  Eingange  zur  Verfiigung,  an  die  je  zwei 
Paddles  (Drehregler)  angeschlossen  werden  konnen. 

Auch  fiir  die  Ohren  hat  der  STE  einiges  zu  bieten: 

-  Zur  Tonerzeugung  stehen  zusatzlich  zum  ST-Soundchip  (PSG)  nun  zwei  PCM- 
Soundkaniile  (Stereo-Sound  moglich)  mit  je  8-Bit  Auflosung  und  eigenen  Ausgangen 
zur  Verfiigung.  Die  Sounddaten  konnen  im  DMA-Betrieb  abgespielt  werden. 

Die  Steuerungder  Lautstarke,  Balance  und  die  Klangbeeinflussung  der  neuen  Soundkanale 
erfolgt  iiber  einen  eigenen  Chip.  Dieser  Chip  wird  iiber  eine  zusatzliche  serielle  Schnitt- 
stelle  im  STE,  das  sogenannte  MICROWIRE™-Interface  angesteuert.  Die  Dateniibertra- 
gungsgeschwindigkeit  auf  dieser  seriellen  Schnittstelle  betragt  1  MBit/s! 

Um  alle  diese  neuen  Komponenten  entsprechend  ansteuem  und  einsetzen  zu  konnen,  waren 

natiirlich  Anderungen  am  Betriebssystem  erforderlich: 

-  Die  zusatzlichen  Routinen  belegen  mehr  ROM-Speicherplatz.  Deshalb  kommt  man  mit 
192  KByte  ROM  im  STE  nicht  mehr  aus.  Der  bisher  benutzte  AdreBraum  fiir  das  TOS 
von  $FC  0000  -  $FE  FFFF  ist  somit  ebenfalls  zu  klein  geworden!  Das  STE-TOS  be- 
findet  sich  deshalb  in  zwei  1  MBit-EPROMS  ab  Adresse  $E0  0000  und  reicht  bis 
$E3  FFFF! 


Zusatzliche  Verbindungen  zur  AuBenwelt 

Wie  ja  schon  zuvor  erwahnt,  besitzt  der  STE  einige  zusatzliche  AnschluBmoglichkeiten.  Als 
augenfalligste  Eiganzungen  bei  den  neu  hinzugekommenen  Anschliissen  sind  die  zwei  zu¬ 
satzlichen  Buchsen  fiir  Joystick/Paddles/Light-Gun  bzw.  Light-Pen  zu  nennen. 
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Abb.  J.l:  Schaltung  der  zusatzlichen  Joystickports  im  STE 
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Zwei  Buchsen  fur  vier  Joysticks  -  und  noch  einiges  mehr 

Nur  drei  zusatzliche  Chips  in  der  STE-Hardware  erlauben  auf  einfache  Weise  den  AnschluB 
von  vier  zusatzlichen  Joysticks  (auf  die  Paddles  gehen  wir  spater  noch  ein!).  Dabei  lassen  sich 
an  jede  derbeiden  15poligen  Subminiatur-Buchsen  zwei  vollwertige  Joysticks  tiber  einen  ent- 
sprechenden  Adapter  anschlieBen.  Die  Pinbelegung  der  beiden  Buchsen  und  die  Anschaltung 
der  Joysticks  iiber  die  zusatzlichen  Chips  zeigt  die  Abbildung  J.  1 . 

Und  nun  zur  Funktionsweise: 

Die  Richtungskontakte  der  Joysticks  und  die  Kontakte  der  Fire-Buttons  miissen  gegen  Masse 
schlieBen,  um  eine  Reaktion  auszulosen.  Wenn  die  Kontakte  nicht  geschlossen  sind,  liegen 
die  Anschliisse  iiber  Pull-up-Widerstande  an  +5V. 

Die  Portanschliisse  sind  auf  die  Eingange  der  drei  Bus-Trciberbausteine  V509/V5 1 0/V5 1 2  des 
Typs  74LS244  gefiihrt.  Dabei  werden  die  Kontakte  fiir  die  vier  Fire-Buttons  vom  Bustreiber 
V509  “bedient”,  wahrend  die  Richtungskontakte  der  vier  Joysticks  an  V5I0  und  V512  auf- 
laufen. 

Die  Bus-Treiberbausteine  arbeiten  nach  folgendem  einfachen  Prinzip:  Liegt  am  _1Q-  bzw. 
_2Q- AnschluB  ein  High-Pegel,  sind  die  Ausgange  IQ  - 1 Q4  bzw.  2Q 1 -2Q4  im  hochohmigen 
Zustand. 

Geht  der  _1Q-  bzw.  _2Q-AnschluB  des  Bustreibers  auf  Low,  so  wird  der  Logik-Pegel  der 
Eingangsanschliisse  1A1  -  lA4bzw.  2A1 -2A4  andenentsprechenden  1Q1  -  1Q4  bzw.  2Q1 
-2Q4-Ausgangen  prasentiert.  In  unserem  Fall  gelangen  die  J^ogikpegel  der  Joysticks  also  iiber 
die  Bustreiber  auf  den  Datenbus! 

Dabei  werden  die  Richtungsinformationen  von  Joystick  0  (Joyport  0)  und  Joystick  2  (Joyport 
1)  auf  die  unteren  acht  Datenleitungen  des  Datenbusses  abgebildet.  Die  Joysticks  1  (Joyport 
0)  und  3  (Joyport  1)  legen  die  Richtungsinformationen  auf  den  oberen  acht  Datenleitungen 
des  16  Bit-Datenbusses  ab. 

Das  “Einlesen”  der  Joystick-Richtungsinformation  erfolgt  also  mit  einem  Low-Impuls  auf  den 
Leitungen  XJOYRL  und  XJOYRH.  Diese  Leitungen  kommen  im  STE  vom  MCU-Baustein, 
in  dem  die  Funktionen  von  GLUE  und  MMU  zusammengefaBt  worden  sind.  Durch  einen 
Word-Lesezugriff  auf  die  Adresse  $FF  9202  wird  dieser  Low-Impuls  auf  den  Leitungen 
XJOYRL  und  XJOYRH  erzeugt  und  somit  der  Zustand  der  Joystick-Richtungstasten  direkt 
iiber  die  Bustreiber  auf  den  Datenbus  gegeben.  Da  die  CPU  ja  gerade  einen  Lesezugriff 
durchftihrt,  werden  so  die  Richtungsinformationen  der  vier  Joysticks  mit  einem  Wordzugriff 
direkt  eingelesen! 
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Das  Einlesen  der  Fire-Button-Informationen  erfolgt  nach  dem  gleichen  Schema.  Jedoch  mu  6 
dazu  auf  der  XBUTTON-Lcitung  ein  Low-Impuls  erzeugt  werden.  Das  geschieht  durch 
entsprechende  Dekodierung  der  AdreBleitungen  der  CPU  durch  den  MCU-Baustein  bei  einem 
Word-Lesezugriff  auf  die  Adresse  $FF  9000.  Die  unteren  vier  Bits  des  Datenwords  an  Adresse 
$FF  9000  geben  damit  den  Zustand  der  vier  Fire-Buttons  wieder. 

Somit  ergeben  sich  im  AdreBraum  des  STE  zwei  Adressen,  an  denen  die  Zustande  der  vier 
Joysticks  direkt  abgefragt  werden  konnen! 


Adresse: 

Bit-Nr. : 

Inhalt: 

SFF  92BB 

15  14  13  12  II  ID  9  ©  7  ©  5  4  3  2  1  0 

M  1"J- 1  1  U.  il--l  11  IsliUTal 

' - unbenutzt - 'Button-Hr  . 

Zustand  der  Fire-Buttons 
flip  Joysticks/Paddles 

(Log.  B  =  Button  betatigt!) 

Adresse: 

Bit-Nr. ! 

Inhalt : 

SFF  9282 

IS  14  13  12  1  1  10  g  S  7  &  5  4  3  2  1  0 

1 M  t  M4  M  M  ♦  IM  Ml  M  ♦  IM  M  M  ♦  I M 

Richtungsinf ornat ionen 
der  Joysticks  0-3 

v . . 1 - A -  1  . 1 - 's-  i 

Stick  3  Stick  1  Stick  2  Stick  0 

CLog.  0  =  Stick  betatigt!) 

Abb.  J.2:  Die  Adressen  der  neuen  Joystickports 


Wie  im  Schaltungsauszug  in  Abbildung  J.  1  dargestellt  ist,  wird  vom  Joyport  1  die  Fire-Button- 
Leitung  des  Joysticks  0  (Pin  6  der  Buchse)  noch  zusatzlich  fiber  die  XPEN-Leitung  zur  MCU 
gefiihrt.  Uber  diese  Leitung  gibt  der  Light-Pen  bzw,  die  Light-Gun  einen  Low-Impuls  ab, 
wenn  der  Elektronenstrahl  beim  Beschreiben  der  Bildschirmflache  jene  Stelle  erreicht,  die 
vom  Light-Pen/Light-Gun  gerade  abgetastet  wird. 

Atari  gibt  fur  die  Genauigkeit  der  abgetasteten  Bildschirmposition  bei  Betrieb  mit  Light-Pen/ 
-Gun  folgende  Toleranzen  an: 

-  In  vertikaler  Richtung  ist  die  Position  auf  ein  Pixel  genau. 

-  In  horizontaler  Richtung  ergeben  sich  je  nach  Betriebsart  unterschiedliche  Toleranzwerte: 


Modus 

Toleranz 

320  x  200 

4  Pixel 

640  x  200 

8  Pixel 

640  x  400 

16  Pixel 
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Diese  Toleranzen  gelten  unabhangig  von  der  Qualitat  des  verwendeten  Light-Pens/-Gun. 
Auch  ein  hoch  wertigerer  Light-Pen  wird  die  angegebenen  Toleranzwerte  nicht  weiter  driicken 
konnen. 

Die  X-  und  Y-Position  des  Lightpens  ist  aus  folgenden  Registem  mit  einem  Wordzugriff  (als 
16  Bit  Wert)  zu  “erfahren”: 


Adresse 

Label 

Inhalt 

$FF  9220 

XPEN 

X-Position  des  Lightpens 

$FF  9222 

YPEN 

Y-Position  des  Lightpens 

Dabei  ist  zu  beachten,  daB  die  Positionswerte  im  XPEN-Register  in  Pixel  fur  den  Lowres- 
Modus  (320x200 Pixel)  geliefert  werden.  Umkoirekte  Werte  im  Midres-Modus  (640x200  Pixel) 
zu  erhalten,  ist  der  Wert  im  XPEN-Register  um  eine  Bitposition  nach  links  zu  shiften.  Bei 
Highres-Betrieb  (640x400  Pixel)  ist  der  XPEN-Wert  um  zwei  Bits  naeh  links  zu  shiften,  um 
die  korrekte  Positionsangabe  zu  erhalten! 


Keine  EinbahnstraBe  fur  Daten  -  Joystick-Ports  als  Ausgange 

Bis  jetzt  war  immer  nur  von  drei  der  vier  zusatzlichen  Chips  an  den  Joystickports  des  STE  die 
Rede.  Im  Schaltungsauszug  befindet  sich  jedoch  noch  ein  weiterer  Chip  im  Joy stickinterface. 
Der  Baustein  V51 1  ist  ein  sogenanntes  Oktal-Latch. 

Die  Funktionsweise  ist  folgende: 

Mit  der  ansteigenden  Flanke  eines  Signals  am  C-AnschluB  werden  die  Logikpegel  der 
Eingange  1 D  -  8D  in  dem  Baustein  gespeichert.  Bei  Lo  w-Pegel  am  _OE-AnschluB  erscheinen 
die  gespeicherten  Informationen  an  den  Ausgangen  IQ  -  8Q.  Ist  der  _OE-AnschluB  des 
Bausteins  jedoch  auf  Fligh-Pegel,  so  gehen  alle  Ausgange  IQ  -  8Q  in  den  hochohmigen 
Zustand. 

Im  STE  sind  die  acht  Eingange  des  Oktal-Latches  an  die  acht  niederwertigen  Leitungen  des 
Datenbusses  angeschlossen,  und  die  acht  Ausgange  des  Bausteins  V511  fiihren  an  die 
Anschliisse  der  Joysticks  0  (Joyport  0)  und  2  (Joyport  1 ).  Vom  MCU-Baustein  steuem  die 
beiden  Leitungen  JOYWL  und  XJOYWE  die  Anschliisse  C  und  _OE  des  Latches  nun  so  an, 
daB  bei  einem  Schreibzugriffmf  die  Adresse  $FF  9202  (Label  JOYDIR)  die  unteren  acht  Bits 
der  geschriebenen  Information  als  Logikpegel  an  den  Joystickanschliissen  0  und  2  ausgegeben 
werden.  Die  Pegelbleiben  so  lange  “stehen”,  bis  ein  emeuter  Schreibzugriff  auf  diese  Adresse 
erfolgt  oder  bis  auf  Adresse  $FF  9202  lesend  zugegriffen  wird! 
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Damit  lassen  sich  also  acht  Bits  an  Informationen  blitzschnell  (so  schnell  die  CPU  kann) 
parallel  ausgeben! 


Von  Analog  nach  Digital  -  Paddles  am  STE 

Schonbei  den  8-Bit-Ataris  (Serie  800/800XL/1 30XE)  war  esm6glich,nichtnurSchalterzustande 
von  z.  B.  Joysticks  abzufragen,  sondem  stufenloseRichtungs-  oder  sonstige  Informationen  an 
den  Computer  weiterzugeben.  So  lassen  sich  mit  sogenannten  Paddles,  das  sind  Drehregler, 
stufenlos  Richtungsinformationen  o.  a.  einstellen.  Je  weiter  der  Regler  aufgedreht  ist,  desto 
hoher  ist  der  iibermittelte  Wert.  Die  Drehregler  bestehen  aus  veranderbaren  Drehwiderstanden 
miteinem  Widerstandswertvon>470kOhm  (Atari-Paddles  haben  680  kOhm-Drehwiderstande 
im  Vollausschlag).  Durch  eine  Elektronik  werden  diese  analogen  Widerstandswerte  der  Dreh¬ 
regler  in  digitale  Zahlenwerte  umgewandelt. 

Im  STE  hat  Atari  wieder  auf  diese  Steuerungsmoglichkeit  zuriickgegriffen  und  erlaubt  den 
AnschluB  von  je  zwei  Paddles  an  jedem  Joyport.  Damit  besteht  sogar  die  Moglichkeit,  soge- 
nannte  analoge  Joysticks  zu  verwenden,  die  stattRichtungskontakten  fiber  veranderbare  Wi- 
derstande  verftigen  und  so  eine  stufenlose  Richtungsangabe  erlauben! 

Wie  der  Schaltungsauszug  in  Abbildung  M.3  zeigt,  existiert  ftir  jeden  der  vier  moglichen 
Paddleanschlfisse  eine  eigene  Schaltung.  Dabei  handelt  es  sich  um  sogenannte  monostabile 
Multivibratoren  Oder  auch  Monoflops.  Im  STE  werden  dazu  sogenannte  Timer-ICs  vom 
Typ  ”LM  556"  verwendet,  wobei  je  zwei  Monoflops  in  einem  IC-Gehause  untergebracht 
sind. 

Monoflops  haben  die  “Angewohnheit”,  durch  einen  Impuls  von  ihrer  Ruhelage  (Ausgangspegel 
in  unserem  Fall  auf  Low)  ftir  eine  bestimmte  Zeit  in  die  Arbeitslage  (Ausgangspegel  in 
unserem  Fall  dann  High)  “umgekippt”  zu  werden.  Die  Dauer,  in  der  das  Monoflop  in  der 
Arbeitslage  “verharrt”,  ist  abhangig  von  einem  Zeitglied,  das  aus  einem  Widerstand  besteht, 
fiber  den  ein  Kondensator  aufgeladen  wird.  Erreicht  die  Ladespannung  an  dem  Kondensator 
einen  bestimmten  Schwellwert,  so  wird  das  vom  Monoflop-Baustein  fiber  einen  FtihleranschluB 
“bemerkt”,  und  das  Monoflop  kippt  zurfick  in  seine  Ruhelage. 

Die  Dauer,  in  der  das  Monoflop  in  Arbeitslage  bleibt,  ist  zum  einen  abhangig  vom  Kondensa- 
torwert  (CT  im  Schaltungsauszug)  und  zum  anderen  vom  Wert  des  Ladewiderstands.  Beim 
STE  wird  der  Ladewiderstand  im  Prinzip  durch  den  Widerstand  eines  Paddles  gebildet.  Da 
dieser  Widerstandswert  veranderbar  ist,  IMBt  sich  so  auch  die  Zeitdauer  der  Arbeitslage  des 
Monoflops  direkt  beeinflussen.  Das  Prinzip  der  Umwandlung  von  Widerstandswerten  (der 
Paddles)  in  im  STE  verwendbare  Zahlenwerte  ist  nun  folgendes  (siehe  auch  den  Schaltungs¬ 
auszug  in  Abbildung  J.3): 
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Abb.  J.3:  Einbindung  der  Paddles  beim  STE 

Fur  jeden  Paddle  existiert  ein  Zahler  in  der  STE-MCU.  In  regelmaBigen  Abstanden  (ca.  alle 
0,52  ms)  werden  alle  vier  Zahler  auf  Null  gesetzt  und  gleichzeitig  die  vier  Monoflops  mit 
einem  Impuls  liber  die  XPADRST-Leitung  in  Arbeitslage  “gekippt”.  Die  vier  Zahler  werden 
in  einem  bestimmten  Takt  weitergezahlt  (ca.  500  KHz  im  STE).  Die  Monoflops  kippen  je  nach 
Widerstandswert  der  Paddles  nach  gewisser  Zeit  wieder  in  ihren  Ruhezustand  zuriick  und 
halten  durch  diesen  Signal  wechsel  an  ihren  Ausgangen  (Leitungen  XPADOX  -  XPAD1 Y  im 
Schaltplanauszug)  “ihren”  Zahler  in  der  MCU  an. 

Der  so  gewonnene  Zahlerstand  ist  damit  direkt  abhiingig  vom  eingestellten  Widerstandswert 
des  Paddles  und  damit  von  dessen  Position !  So  setztman  analoge  Widerstandswerte  in  Zahlen- 
werte  urn.  Die  vierPaddle-Zahler- Register  sinduntcr  den  folgendenAdressenimSpeicherraum 
des  STE  abfragbar: 


Adresse 

Label 

Inhalt 

$FF  9210 

PADDLO 

Position  des  Paddle  0 

$FF  9212 

PADDL1 

Position  des  Paddle  I 

$FF  9214 

PADDL2 

Position  des  Paddle  2 

$FF  9216 

PADDL3 

Position  des  Paddle  3 
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Die  Register  sind  zwar  1 6  Bit  breit.  Es  ist  jedoch  nur  das  Low-Byte  significant  (es  reicht  also 
aus,  das  entsprechende  Low-Byte  zu  lesen!).  Damit  ergeben  sich  magliche  Paddle-Werte 
zwischen  0  und  255,  wobei  aber  Werte  iiber  200  nur  mit  Drehwiderstanden  mit  einem  maxi- 
malen  Endwert  von  ca.  1  MOhm  erreicht  werden. 

Mit  nachfolgender  Faustformel  kann  fiir  einen  gegebenen  Paddle-Widerstandswert  (in  der 
Formel  mit  Rp  bezeichnet  und  in  kOhm  einzusetzen)  der  entsprechende  Paddle-Registerwert 
berechnet  werden: 


394 

RegWert  =  -  [  Rp  in  kOhm!  ] 

1  +  1000/Rp 

Fiir  die  Fire-Buttons  der  Paddles  werden  die  Fire-Button- Anschliisse  der  Joysticks  verwendet 
und  konnen  somit  im  Register  JOYBUTT  an  Adresse  $FF  9200  abgefragt  werden.  Nachfol- 
gend  noch  ein  Verdrahtungsvorschlag  fiir  die  Adaption  von  zwei  handelsiiblichen  Joysticks 
mit  9poligen  AnschluBbuchsen  an  einen  STE-Joyport: 


Abb.  J.4:  Adapter  zum  Anschhift  von  Joysticks  und  Paddles  an  die  neuen  STE-Joystickports 
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Wenn  die  gestrichelten  Verbindungen  ebenfalls  eingelegt  werden,  so  lassen  sich  an  einem  der 
beiden  9poligen  Anschliisse  des  Adapters  zwei  Paddles  anschlieBen, 


Gutes  fur  die  Ohren  -  Sound  in  neuer  Qualitat 

Gegeniiber  den  eher  eingeschrankten  Moglichkeiten  der  Sounderzeugung  mit  Hilfe  des  PSG 
im  “normalen  ST”  hat  sich  beim  STE  doch  einiges  getan.  So  besitzt  der  STE  jetzt  zwei  Sound- 
kanale  mit  je  8  Bit  Auflosung,  herausgefiihrt  auf  entsprechende  Cinch-Buchsen  zum  An- 
schluB  an  handelsiibliche  Verstarker! 

8-Bit- Auflosung  heifit  dabei  nichts  anderes,  als  daB  sich  die  Amplitude  (der  Ausgangswert) 
eines  beliebigen  Tonsignals  in  maximal  256  Stufen  unterteilen  und  damit  nachbilden  laBt.  Je- 
des  Byte  mit  seinen  8  Bit  stellt  dabei  einen  sogenannten  Sample  dar,  also  einen  Wert,  den  das 
Ausgangssignal  zu  einem  bestimmten  Zeitpunkt  annimmt.  Dabei  ist  der  8-B  it- Wert  als  vorzei- 
chenbehaftete  Zahl  zu  betrachten. 

$80  =  -128  =  maximale  negative  Amplitude 

$00  =0  =  minimale  Amplitude  (Ruhestellung) 

$7F  =  +127  =  maximale  positive  Amplitude 

Zur  Tonerzeugung  werden  diese  Samples  nacheinander  zum  Abspielen  an  einen  Digital/ 
Analog-Wandler  (D/A-Wandler)  ausgegeben,  der  diese  in  entsprechende  Spannungswerte 
umwandelt.  Nach  entsprechender  Aufbereitung  (Filterung)  steht  dann  das  Signal  an  den 
Ausgangsanschliissen  zur  Verfiigung. 

Messungen  im  mir  zur  Verfiigung  stehenden  STE  ergaben  jedoch,  daB  sich  nicht  derkomplette 
8-Bit-Bereich  auflosen  laBt.  Zwar  soli  der  komplette  Spannungsbereich  zwischen  -5V..+5V 
(Betriebsspannungen  der  D/A-Wandler)  in  256  Stufen  dargestellt  werden  konnen  (je  Stufe 
also  ein  Spannungshub  von  ca.  39m V).  Die  eingebauten  D/A-Wandler  hatten  jedoch  Pro- 
bleme,  Samples  mit  Werten  >  1801  in  entsprechende  Spannungswerte  umzusetzen.  Man  sollte 
sich  also,  urn  Verzerrungen  zu  vermeiden,  mit  den  Samplewerten  im  Bereich  zwischen  -80 
und  +80  bewegen. 

Aus  der  Aneinanderreihung  vieler  dieser  Samples  laBt  sich  also  ein  beliebiges  Tonsignal 
“zusammenbauen”.  Die  Ausgabe  dieser  im  Speicher  als  8  Bit-Werte  abgelegten  Samples  an 
die  D/A-Wandler  kann  mit  vier  verschiedenen  Gesehwindigkeiten  erfolgen.  Im  STE  stehen 
die  Samplefrequenzen  6,258  kHz,  12,517  kHz,  25,033  kHz  und  50,066  kHz  zur  Verfiigung, 

Mit  der  niedrigsten  Sampleffequenz  werden  also  6258  Samples  pro  Sekunde  abgespielt!  Oder 
anders  ausgedriickt:  Fiir  eine  Sekunde  Sound  sind  6258  Samples  (=  Bytes)  erforderlich! 
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Abb.  J.S:  Aus  Samples  wird  ein  Tonsignal 
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Die  Qualitat  des  Sounds  hangt  wesentlich  von  der  Samplefrequenz  ab.  So  gilt  die  Faustregel, 
daft  die  Samplefrequenz  mindestens  doppelt  so  groB  wie  diehochste  im  Sound  vorkommende 
Tonfrequenz  sein  soil.  Um  also  auch  hohe  Signalfrequenzen  im  Sound  realisieren  zu  konnen, 
sind  entsprechend  hohe  Sampleffequenzen  erforderlich.  Fur  das  menschliche  Horvermogen 
wird  Musik  in  hoher  Wiedergabequalitat  empfunden,  wenn  der  Frequenzbereich  zwischen  ca. 
20  Hz  und  20  kHz  moglichst  unverfalscht  wiedergegeben  wird.  Dazu  sind  also  bei  digitaler 
Signalverarbeitung  Samplefrequenzen  >  40kHz  erforderlich.  In  der  professionellen  Technik 
arbeitet  man  deshalb  mit  Sampleraten  von  ca.  44  kHz,  wobei  jeder  Sample  als  16  Bit-Wert 
vorliegt  (Signalwerte  in  max.  65536  Stufen  darstellbar)! 


Musik  “von  ganz  alleine”  -  DMA  auch  fur  Sounddaten 

Um  nun  die  einzelnen  Samplewerte  nicht  Byte  fiir  Byte  durch  die  CPU  an  die  D/A-Wandler 
ausgeben  zu  miissen,  bedient  sich  der  STE  zum  Abspielen  ganzer  Blocke  von  Samples  (auch 
als  Frame  bezeichnet)  der  DMA-Technik.  Beim  STE  wird  dazu  im  HBlank-Interrupt  jeweils 
ein  Word  (also  zwei  Samples)  durch  das  im  STE-Shifter  mitinlegrierte  Sound-DMA-Modul 
an  die  D/A-Wandler  ausgegeben.  Dabei  kann  in  zwei  Modi  gearbeitet  werden: 

Stereo-Modus:  Von  dem  vom  Sound-DMA-Modul  aus  dem  Speicher  geholten  Word 

wird  das  High-Byte  als  Samplewert  fiir  den  linken  Tonkanal  (D/A- 
Wandler)  verwendet  und  das  Low-Byte  fiir  den  rechten  Kanal  (D/A- 
Wandler). 

Mono-Modus:  Ein  Word  enthalt  zwei  Samplewerte,  die  der  Reihe  nach  (erst  High- 

Byte,  dann  Low-Byte)  an  beide  D/A-Wandler  gleichzeitig  ausgegeben 
werden.  Somit  steht  an  beiden  Soundausgangen  das  gleiche  Signal  zur 
Verfugung. 

Um  also  einen  Frame  (eine  Gruppe  von  Samples)  abzuspielen,  muB  das  Sound-DMA-Modul 
“wissen”,  wo  ein  Frame  beginnt  (Anfangsadresse)  und  wo  dieser  endet  (Endadresse).  Des 
weiteren  laBt  sich  bei  der  Programmierung  des  Sound-DMA-Moduls  festlegen,  mit  welcher 
Geschwindigkeit  die  Samples  ausgegeben  werden  sollen  (Samplefrequenz).  Samples  lassen 
sich  auBerdem  mehr  als  einmal  abspielen.  Das  Sound-DMA-Modul  laBt  sich  dazu  auf 
Dauerbetrieb  einstellen  und  spielt  so  den  Frame  immer  wieder  von  neuem  ab. 

Da  vom  Sound-DMA-Modul  immer  Words  aus  dem  Speicher  gelesen  und  zur  D/A-Wandlung 
gegeben  werden,  laBt  sich  immer  nur  eine  gerade  Anzahl  von  Samples  pro  Frame  abspielen 
(auch  bei  Mono-Mode!).  Entsprechend  ist  das  Low-Bit  der  Frame-Start-  und  Frame-End- 
Adresse  in  den  entsprechenden  DMA-Registem  immer  Null !  Die  in  der  folgenden  Tabelle  mit 
versehenen  Voreinstellungen  sind  nach  Einschalten  des  STE  (Reset)  giiltig! 
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Adresse 

Label 

R/W 

Bits 

Bedeutung 

$FF  8900 

RAV 

- RE 

Sound-DMA-Control-Reg. 

sndmactl 

00 

DMA-Sound  aus  (*) 

01 

DMA-Sound  ein 

11 

DMA-Sound  ein.  Frame 

standig  wiederholen 

$FF  8902 

R/W 

-  00HH  HHHH 

Frame-Start- Adresse 

sndbashi 

(High-Byte) 

$FF  8904 

R/W 

- - MMMM  MMMM 

Frame-Start- Adresse 

sndbasmi 

(Middle-Byte) 

$FF  8906 

R/W 

Frame-Start-Adresse 

sndbaslo 

(Low-Byte) 

$FF  8908 

R 

-  00HH  HHHH  j 

Frame-Adress-Counter 

sndadrhi 

(High-Byte) 

$FF  890A 

R 

-  MMMM  MMMM 

Frame-Adress-Counter 

sndadrmi 

R 

(Middle-Byte) 

$FF  890C 

R 

-  LLLL  LLLL 

Frame-Adress-Counter 

sndadrlo 

(Low-Byte) 

$FF  890E 

R/W 

-  00HH  HHHH 

Frame-End-Adresse 

sndendhi 

(High-Byte) 

$FF  8910 

R/W 

- - MMMM  MMMM 

Frame-End-Adresse 

sndendmi 

(Middle-Byte) 

SFF8912 

R/W 

-  LLLL  LLLL 

Frame-End-Adresse 

sndendlo 

(Low-Byte) 

$FF  8920 

R/W 

-  M0 00  00RR 

Sound-Mode-Control 

sndmode 

II 

00 

6258  Hz  Samplerate  (*) 

01 

12517  Hz  Samplerate 

10 

25033  Hz  Samplerate 

11 

50066  Hz  Samplerate 

C 

) 

Stereo-Modus  (*) 

3 

Mono-Modus 
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Wie  ja  schon  vom  DMA-Baustein  des  ST  bekannt,  kann  man  auch  hier  wieder  nicht  mittels 
Langwort-Zugriff  direkt  die  Start-  und  End-Adressen  setzen.  Man  muB  auf  Assemblerebene 
entweder  in  einem  Datenregister  die  Adressen  “zurechtschieben”  und  dann,  schon  der  Reihe 
nach,  Low-,  Middle-  und  High-Byte  der  Frameadressen  im  entsprechenden  Sound-DMA- 
Register  setzen. 

START: 

move.l  #f start, dO  ;  Frame-Startadresse  ->  DO. 

move.b  dO,sndbaslo  ;  Low-Byte  pafit,  also  einsetzen. 

ror.l  #8,d0  ;  Jetzt  Mid-Byte  passend  schieben. 

move.b  dO,sndbasmi  ;  Middle-Byte  wegbr ingen . 

ror.l  #8,d0  ;  Jetzt  High-Byte  passend  schieben. 

move.b  dO,sndbashi  ;  Und  ab  ins  Register  damit. 

Diese  Version  hat  den  Nachteil,  da8  der  AdreBwert  in  einem  Datenregister  (z.  B.  DO)  stehen 
muB  und  nach  den  Verschiebungen  nicht  mehr  in  seiner  urspriinglichen  Form  vorliegt.  Durch 
eine  weitere  Verschiebung  um  8  Bits  nach  rechts  (“ror.l  #8,d0”)  ist  der  AdreBwert  zwar  wieder 
korrekt  in  DO  enthalten,  aber  das  kostet  natiirlich  auch  alles  CPU-Zeit! 

Die  nachfolgende  Version  benutzt  den  Stack  fur  das  “Aufbroseln”  der  Adressen  in  regi- 
stergerechte  Form. 

START: 

pea  fstart,-(sp)  ;  Frame-Start -Adr.  auf  Stack, 

tst.l  (sp) +  ;  Stackptr.  wieder  korrigieren. 

move.b  -3 (sp) , sndbashi  ;  Nun  die  Bytes  der  Frame-Start- 

move.b  -2  (sp) , sndbasmi  ;  Adresse  wie  sie  benotigt  werden 

move.b  -1  (sp) , sndbaslo  ;  vom  Stack  holen  und  wegbringen! 

Nachdem  die  Anfangs-  und  Endadresse  auf  die  eine  oder  andere  Weise  dem  Sound-DMA- 
Modul  mitgeteilt  worden  sind,  wird  im  Modus-Kontrollregister  (“sndmode”,  Adr.  $FF  8920) 
die  gewiinschte  Samplefrequenz  und  die  Betriebsweise  (Stereo/Mono)  gewahlt. 

Nach  Setzen  von  Bit  0  im  Sound-DMA-Control-Register  (“sndmactl”,  Adr.  $FF  8900)  wird 
der  Frame  abgespielt.  Ist  Bit  1  im  Sound-DMA-Control-Register  ebenfalls  gesetzt,  wird  der 
Frame  standig  wiederholt.  Eine  Null  im  Sound-DMA-Control-Register  stoppt  den  DMA- 
Sound  sofort. 

Wer  wissen  will,  welcher  Sample  als  nachster  gespielt  wird,  kann  jederzeit  die  drei  Sound- 
Adress-Register  auslesen.  Sie  bilden  zusammen  den  Zeiger  auf  das  nachste  Sample-Word. 
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Soundsteuerung  mit  und  ohne  Timer-A-Interrupts 

Um  bei  der  DMA-Soundkontrolle  flexibel  zu  sein,  hat  Atari  beim  STE  ein  wenig  zusatzliche 
Hardware  spendiert. 

Die  Register  fur  Frame-Start- Adresse  und  Frame-End-Adresse  sind  gebuffert.  Das  bedeutet, 
daB  eine  dort  hineingeschriebene  Adresse  zunachst  zwischengespeichert  wird.  “Benutzt”  wird 
diese  Adresse  erst  dann  (die  AdreBwerte  werden  in  die  entsprechenden  Arbeitsregister  trans- 
portiert),  wenn  der  momentan  gespielte  Frame  beendet  wurde.  In  der  Praxis  kann  man  deshalb 
schon  wahrend  des  Abspielens  eines  Frames  die  Adressen  des  nachsten  Frames  eintragen.  Der 
nachste  Frame  wird  dann  “nahtlos”  an  den  vorigen  “angehangt”! 

Mit  der  Information,  wann  ein  Frame  zu  Ende  ist,  besteht  die  Moglichkeit,  eine  ganze  Serie 
von  Frames  hintereinander  zu  ketten!  Dazu  liefert  das  DMA-Sound-Modul  ein  Signal  iiber  den 
augenblicklichen  “Stand  der  Dinge”.  Von  Pin  105  der  MCU  iiber  einen  Inverter  (74LS04) 
gefiihrt,  steht  ein  Signal  (“XSINT”)  zur  Verfiigung,  das  auf  High  liegt,  wenn  gerade  ein  Frame 
gespielt  wird  (siehe  auch  Abbildung  J.6). 


MCU 


Uon  Pin  3  der_ 
Monitorbuchse 

<Bei  uow  an  Pin  9 
wird  an  Pin  4  ein 
ext.  syste-ntakt 
eingospe-ist |J 


Uon  Pin  4  der 
tionitorbuchse 

« Monochrom-De  t  ec  t  - 
Sisnai  Oder  Ex*. 
Syste-rttaKt  Fuer 
Genlock -ftnwcndg . 1 


74S25 7] 


,  32MHz-Takt  von 
Taktoszillator 


Mastertakt  fuer 
das  gesante  SysteM 

fftn  P.S3  des  SHIFTERS) 


.  2MHz-Takt  des  DMA- 
Sound-  Systems 


I74LB1641 


•=Cj>cir 


ID 


1 


HL- 


[74LS8SI 


=1 


1/o-port  7 


MFP 


I/O-Port  7 


Abb ■  J-6:  Signallauf  des  XSINT-Signals  im  STE 
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MitEinlesen  des  letzten  Words  eines  Frames  geht  das  Signal  auf  Low  und  erst  wieder  auf  High, 
wenn  wieder  ein  Frame  begonnen  wird.  Das  geschieht  auch,  wenn  das  Sound-DMA-Modul 
auf  “Dauerbetrieb”  (standiges  Abspielen  eines  Frames)  eingestellt  ist.  Da  das  Sound-DMA- 
Modul  einen  4-Word-FIFO-Buffer  besitzt,  geht  das  Signal  XSINT  also  bereits  vier  Words 
(=  acht  Samples)  vor  Frameende  auf  log.  0! 

Beim  STE  wird  das  XSINT-Signal  sinnvollerweise  (nach  einer  Aufbereitung  durch  ein  mit 
2MHz  getaktetes  8fach-Schieberegister  des  Typs  74LS164)  auf  den  Eingang  des  Timers  A 
vom  MFP  gefiihrt  und  kann  damit  Interrupts  auslosen,  wenn  jeweils  ein  oder  mehrere  Frames 
beendet  wurden  (je  nach  Einstellung  des  Timers  A). 

Um  Impulse  am  Eingang  des  Timers  A  erfassen  zu  konnen,  mufi  im  Aktive-Edge-Register, 
Bit  4  (AER,  Adresse  $FF  FA03)  des  MFP  eingestellt  werden,  auf  welche  Flanke  der  XSINT- 
Impulse  der  Eingang  des  Timers  A  reagieren  soil. 

Mit  diesem  AER-Bit  wird  aber  auch  eingestellt,  auf  welche  Flanke  der  Interrupt  am  Port  104 
des  MFP  (Interruptsignal  von  Midi-  und  Tastatur-ACIA)  auslost.  Atari  hat  das  XSINT-Signal 
deshalb  so  ausgelegt,  dafi  bei  beiden  Signalen  jeweils  auf  fallende  Flanken  reagiert  wird  (Bit  4 
im  AER  auf  0!). 

Man  braucht  sich  deshalb  um  die  Programmierung  des  AER-Bit  4  nicht  mehr  zu  ktimmem, 
denn  das  wird  vom  Betriebssystem  zur  Bedienung  der  Midi-  und  Tastatur-Intermpts  schon 
richtig  voreingestellt! 

Um  nun  also  verschiedene  Frames  direkt  hintereinander  abspielen  und  evtl.  einzelne  Frames 
unterschiedlich  oft  wiederholen  zu  konnen,  ware  die  folgende  Vorgehensweise  angebracht: 

Beispiel :  Frame  A  (eine  Sinusschwingung)  soil  lOOmal  gespielt  werden,  direkt  anschlie- 
Bend  folgt  150mal  eine  Dreieckschwingung  und  zum  SchluB  noch  250mal  der 
Frame  C  fur  eine  Rechteckschwingung. 

1 .  Start-  und  Endadressen  fur  Frame  A  im  Sound-DMA-Modul  setzen. 

2.  Timer-A  auf  Ereigniszahlung  programmieren  (es  sollen  die  XSINT-Impulse  (sprich: 
Frames)  gezahlt  werden).  Interruptvektor  fur  Timer-A  auf  eigene  Interruptroutine 
setzen.  Timer-A  mit  der  Zahl  der  Framewiederholungen  -1  laden. 

3.  Samplerate  und  Modus  (Stereo  oder  Mono)  im  Sound-Mode-Register  einstellen.  Bit  0 
und  1  im  Sound-DMA-Control-Register  (sndmactl,  Adresse  $FF  8900)  setzen.  Frame  1 
wird  gespielt,  Wiederholbetrieb  ist  eingeschaltet.  [Am  Ende  der  99sten  Wiederholung 
von  Frame  A  lost  der  Timer-A  einen  Interrupt  aus!] 
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4.  In  der  Interruptroutine  Adressen  fur  Frame  B  setzen,  Ebenso  die  Anzahl  der  Wiederho- 
lungen  fur  Frame  B  (150)  in  Timer-A  einstellen.  Interruptroutine  verlassen. 

[Sobald  die  letzte  Wiederholung  von  Frame  A  beendet  ist,  wird  der  zweite  Frame 
begonnen  (Bufferung!),  und  der  Timer-A  zahlt  von  150  auf  149.  Am  Ende  der  149sten 
Wiederholung  von  Frame  B  wird  wieder  ein  Interrupt  ausgelost.] 

5 .  In  der  Interruptroutine  Adressen  fur  Frame  C  setzen.  Ebenso  die  Anzahl  der  Wiederho- 
lungen  fur  Frame  C  (250)  in  Timer-A  einstellen.  Interruptroutine  verlassen. 

[Am  Ende  der  letzten  Wiederholung  von  Frame  B  wird  der  dritte  Frame  begonnen,  und 
der  Timer-A  zahlt  von  250  auf  249.  Zum  Ende  der  249sten  Wiederholung  von  Frame  C 
wird  wieder  ein  Interrupt  ausgelost.] 

6.  Im  Interrupt  Bit  1  des  Sound-DMA-Control-Registers  zuriicksetzen.  Damit  ist  die 
standige  Wiederholung  eines  Frames  ausgeschaltet,  und  der  letzte  Frame  wird  noch  zu 
Ende  gespielt,  dann  halt  das  Sound-DMA-Modul  an.  Timer-A  wird  gestoppt,  und  die 
Timer- A-Interrupts  werden  disabled  und  maskiert.  Das  war’s! 

Nachfolgend  ist  ein  Beispiellisting  fur  den  gerade  beschriebenen  Fall  dargestellt. 


;  Definition  der  verwendeten  Adressen  und  Konstanten 


sndmactl 

equ 

$FF8900 

f 

Sound-DMA-Control-Register 

sndbashi 

equ 

$FF8903 

r 

Frame-Start -Address  (High-Byte) 

sndbasmi 

equ 

$FF8905 

r 

Frame-Start -Address  (Middle-Byte) 

sndbaslo 

equ 

$FF8907 

r 

Frame-Start -Address  (Low-Byte) 

sndendhi 

equ 

$FF890F 

r 

Frame-End-Address  (High-Byte) 

sndendmi 

equ 

$FF8911 

r 

Frame-End-Address  (Middle-Byte) 

sndendlo 

equ 

$FF8913 

r 

Frame-End-Address  (Low-Byte) 

sndmode 

equ 

$FF8920 

r 

Sound-DMA-Mode-Register 

MWDATA 

equ 

$FF8922 

r 

MICROWIRE-Data-Register 

MWMASK 

equ 

$FF8924 

t 

MICROWIRE-Mask-Register 

iera 

equ 

$FFFA07 

t 

Interrupt -Enable-Register  A 

isra 

equ 

$FFFA0F 

t 

Interrupt-in-Service-Register  A 

imra 

equ 

$FFFA13 

r 

Interrupt -Mask-Register  A 

tadr 

equ 

$FFFA1F 

t 

Timer-A-Data-Register 

tacr 

equ 

$FFFA19 

r 

Timer-A-Control-Register 
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;  Beispielprogramm  fur  die  Programmierung  des  STE-DMA- Sounds  unter 
;  Ausnutzung  der  Frame-Ende-Signalisierung  (Signal  XSINT)  durch  das 
;  Sound-DMA-Modul  rnit  auf  Ereigniszahlung  programmiertem  Timer-A. 

;  (Das  Programm  mufi  iiri  Supervisor-Modus  ausgefuhrt  werden!) 

start : 


lea 

FRMDAT, a2 

;Ab  FRMDAT  steht  eine  Tabelle  rnit  Zeigern 

move . 1 

(a2)+,a0 

;  auf  Frame-Start /End- Adres sen  und  Werten 

move . 1 

(a2)t,al 

;  fiir  die  Wiederholzahl  der  einzelnen 
;  Frames. 

bsr 

setfram,e 

;  Frameadressen  setzen. 

move . w 

(a2)+,d0 

;  Timer-A-Wert  nach  Register  DO  holen. 

subi.w 

#l,d0 

;  Passend  machen. 

move . 1 

a2, pointer 

;  Zeiger  fiir  nachstes  Mai  verwahren. 

;  Timer-A  wird  jetzt  auf  Ereigniszahlung  programmiert .  Aufierdem 
;  wird  der  zugehorige  Timer-A- Interruptvektor  auf  die  Routine 
;  "t_a_int"  umgeleitet . 

;  Timer-A  wird  rnit  der  Anzahl  der  Wiederholungen-1  fiir  den  ersten 
;  Frame  geladen.  Nach  entsprechend  haufigem  Wiederholen  des  Frames 
;  A  wird  der  Timer-A  einen  Interrupt  auslosen,  und  die  t_a_int- 
;  Routine  tritt  in  Aktion. 

pea  t_a_int  ;  Zeiger  auf  Timer-A-Interruptroutine. 

move.w  d0,-(sp)  ;  Wert  fiir  Timer-A-Data-Register. 

move.w  #$8,-(sp)  ;  Wert  f.  T-A-Ctrl -Register 

(Ereigniszahl . ! ) . 

clr.w  -(sp)  ;  Timer  0  (=  Timer-A)  ist  gemeint. 

move.w  #31f-(sp)  ;  Xbios-Aufruf  Nr.  31  (=  Xbtimer) 

trap  #14 

lea  12(sp),sp  ;  Stack  korrigieren. 

;  MFP-Interrupt  #13  (Timer- A-Interrupt)  wird  freigegeben. 

move.w  #13, -(sp)  ;  Interrupt  #13  des  MFP  einschalten. 

move.w  #27, -(sp)  ;  Xbios-Aufruf  Nr.  27  (=  Jenabint) 

trap  #14 

addq.l  #4,sp  ;  Stack  korrigieren. 
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;  Sound-DMA-Modul  einstellen 

move.w  #$80,sndmode  ;  Mono-Modus  mit  6258Hz  Samplerate 

;  einstellen. 

move.w  #3,sndmactl  ;  Bis  auf  ewig  abspielen! 

;  Uber  MICROWIKE-Interface  den  Volume/Tone-Control-Chip  vor- 
;  einstellen. 

move.w  #$7ff,MWMASK  ;  MICROWIRE -Mask-Register 

;  einstellen. 

move.w  #%10011101000,d0  ;  Lautstarke  des  LMC1992  auf 

;  Maximum! 

bsr  mw_write  ;  Befehl  u.  MICROWIRE- Int erf.  ausgeb. 

the_end : 
rts 


;  Interruptroutine,  die  vom  Sound-DMA-Modul  am  Ende  eines  Frames 
;  jeweils  aufgerufen  wird.  Sie  sorgt  dafiir,  dafi  das  Sound-DMA-Modul 
;  immer  mit  den  nachsten  Framedaten  nachgeladen  wird.  Auflerdem  wird 
;  der  Timer-A  jeweils  mit  der  Anzahl  der  Wiederholungen  fur  den 
;  nachsten  Frame  versehen.  Wenn  der  letzte  Eintrag  in  der  Tabelle 
;  ab  FRMDAT  abgearbeitet  ist  und  der  Interrupt  zu  Beginn  der  letz- 
;  ten  Wiederholung  des  letzten  Frames  auftritt,  wird  das  Sound-DMA- 
;  Modul  auf  Einzelframe-Wiedergabe  geschaltet  {letzten  Frame  noch 
;  zu  Ende  spielen  und  dann  stoppen)  und  Timer-A  "abgeschaltet" ! 

t_a_int : 

movem . 1 

move . 1 
tst.l 
beq.s 
move . 1 
move.l 
bsr 
move . w 
move.b 
move . 1 
bra.s 


dO/aO-a2,  - (sp) 


pointer, a2 
(a2) 

t_a_intl 
(a2)  +,  aO 
(a2)  +,  al 
set frame 
(a2) +,d0 
d0,tadr 
a2 , pointer 
t  a  end 


Benutzte  Register  auf  Stack 
;  retten . 

;  Zeiger  auf  Frame-Daten  holen. 

;  Tabelleneintrag  testen. 

Letzte  Wiederholung  des  letzten  Frames? 
Nein!  Aus  Tabelle  die  nachsten 
Frame-Adressen  holen. 

Und  im  DMA-Modul  setzen. 

Dann  neuen  Wert  fur  Timer-A  holen. 

Und  Timer-A  entsprechend  setzen. 

Neuen  Zeiger  fur  nachstes  Mai  merken- 
Zum  Ende  spr ingen. 
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t_a_intl : 

move . b 
and.b 
and.b 
move , w 

t_a_end: 

move.b 
movem . 1 
rte 


#0,tacr 
#$DF, iera 
#$DF,  imra 
#1, sndmactl 


;  Ja!  Timer-A  stoppen! 

;  Timer-A-Int.  des  MFP  disablen. 

;  "  des  MFP  maskieren. 

;  Frame  noch  beenden  und  dann 
;  SchluB ! 


#$DF, isra 
(sp) +,d0/a0-a2 


MFP  liber  Int.-Ende  informieren! 
Registerinhalte  restaurieren . 


;  Unterprogramm  zum  Setzen  der  Start-  und  Endadresse  des  abzuspie- 
;  lenden  Frames. 


r 

Parameter : 

AO  =  Startadresse  des  Frames 

r 

A1  =  Endadresse  des  Frames 

/ 

Benutzte  Reg. :  Keine 

t 

set frame: 

move . 1 

aO,  -  (sp) 

Startadresse  des  Frames  in 

tst.l 

(sp)  + 

die  Frame-Start-Address-Register 

move . b 

-3 (sp) , sndbashi  ; 

schreiben . 

move . b 

-2 (sp) , sndbasmi 

move . b 

-1 (sp) , sndbaslo 

move . 1 

al,- (sp) 

Endadresse  des  Frames  in 

tst .  1 

(sp)  + 

die  Frame-End-Address-Register 

move.b 

-3 (sp) , sndendhi  ; 

schreiben. 

move .b 

-2 (sp) ,  sndendmi 

move.b 

-1 (sp) , sndendlo 

sfrmend: 

rts 


;  Unterprogramm  zum  Schreiben  uber  MICROWIHE-Interface 
;  Parameter:  DO  =  zu  schreibende  Daten 

;  Benutzte  Reg:  Keine 

r 

mw  write: 

cmp.w  #$7ff,MWMASK  ;  Warten,  bis  letzter 

bne .  s  mw_write  ;  Schreibvorgang  beendet  1st . 
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move.w  dO,MWDATA  ;  Nun  aber  raus  mit  den  Daten! 

rts 


.data 
pointer : 

dc.l  FRMDAT  ;  Zeiger  auf  die  nachsten  Framedaten. 

FRMDAT: 

dc.l  FRAMEA, FRAMEB  ;  Adressen  fur  ersten  Frame  +  Timer- A- 

dc.w  100  ;  Wert 

dc.l  FRAMEB, FRAMEC  ;  Adressen  fur  zweiten  Frame  +  Timer-A- 

dc.w  150  ;  Wert 

dc.l  FRAMEC , FRMENDE  ;  Adressen  fiir  dritten  Frame  +  Timer-A- 

dc.w  250  ;  Wert 

dc.l  0  ;  Null  signalisiert  das  Tabellenende ! 

FRAMEA:  ;  Daten  fur  eine  Sinusschwingung 

dc.b  0,14,27,40,51,61,69,75,79,80 
dc.b  79,75,69,61,51,40,27,14,0 
dc.b  -14,-27,-40,-51,-61,-69,-75,-79,-80 
dc.b  -79,-75,-69,-61,-51,-40,-27,-14 
FRAMEB:  ;  Daten  fiir  eine  Dreieckschwingung 

dc.b  0, 10, 20, TO, 40, 50, 70, 80 
dc.b  70,60,50,40,30,20,10,0 
dc.b  -10, -20, -30, -40, -50, -60,-70, -80 
dc.b  -70,-60,-50,-40,-30,-20,-10 
FRAMEC:  ;  Daten  fiir  eine  Rechteckschwingung 

dc.b  80,80,80,80,80,80,80,80 
dc.b  -80,-80,-80,-80,-80,-80,-80,-80 
FRMENDE: 

Um  nun  nicht  unbedingt  den  letzten  frei  verfiigbaren  Timer  fiir  die  DMA-Soundsteuerung 
benutzen  zu  miissen,  hat  Atari  im  STE  das  XSINT-Signal  noch  an  anderer  Stelle  fiir  Program- 
mierer  verfiigbar  gemacht. 

So  wird  das  Frame-Ende-Signal  noch  zusatzlich  mit  dem  Monochrom-Detect-Signal  der  Mo- 
nitorbuchse  iiber  ein  Exklusiv-Oder  (EXOR)  zusammengefaBt  und  dann  auf  den  Port  107  des 
MFP  gefiihrt  (siehe  hierzu  auch  Abbildung  J.6!). 
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Um  dieses  Signal  jedoch  benutzen  zu  konnen,  muB  man  ein  paar  Gegebenheiten  beriicksich- 
tigen. 

1 .  Der  Interrupt  tritt  an  jedem  Frame-Ende  (eigentlich  vier  Sample- Words  vor  Frameende, 
wegen  des  FIFO-Buffers  im  Sound-DMA-Modul)  auf,  und  nichtnach  einer  bestimmten 
Anzahl  von  Frame wiederholungen. 

2.  Die  mittels  eines  Interrupts  auswertbare  Flanke,  zu  der  das  DMA-Modul  von  “Abspie- 
len”  auf  “Frameende”  umschaltet,  ist  durch  die  EXOR- Verkniipfung  mit  dem  Monochrom- 
detect-Signal  abhangig  vom  verwendeten  Monitor!  Hat  man  einen  Monochrom-Monitor 
angeschlossen,  so  ist  der  l->0-Flanken\veehsel  fiir  die  Interruptauslosung  zu  program- 
mieren.  Istkein  Monochrom-Monitor  angeschlossen,  so  ist  die  0->l -Flanke  zu  benutzen. 
Um  nun  zu  ermitteln,  welche  Flanke  fiir  die  Interruptauslosung  im  AER,  Bit  7,  denn  nun 
zu  verwenden  ist,  ist  folgender  Weg  zu  beschreiten: 

-  Das  Sound-DMA-Modul  abschalten  (0  ins  Sound-DMA-Control-Register  schrei- 
ben),  dadurch  ist  das  XSINT-Signal  auf  0!  Der  Zustand  des  Ports  17  des  MFP  wird 
jetzt  nur  noch  wegen  der  EXOR-Verkniipfung  durch  das  Monochrom-Detect- 
Signal  beeinfluBt! 

-  Port  17  des  MFP  auslesen.  Wenn  eine  log.  1  gelesen  wird,  hat  man  es  mit  einem 
Color-Monitor  zu  tun,  und  das  Bit  7  im  AER  des  MFP  ist  fiir  die  Interruptauslosung 
auf  1  zu  setzen.  Wird  an  Port  17  eine  log.  0  erkannt,  ist  ein  Monochrom-Monitor 
angeschlossen,  und  Bit  7  im  AER  ist  zur  Interruptauslosung  mittels  des  XSINT- 
Signals  auf  0  zu  setzen. 

Man  kann  also  die  Sound-DMA-Steuerung  auch  iiber  diesen  MFP-Port  17-Interrupt  abwik- 
keln.  Es  steht  halt  nur  kein  Timer  fiir  das  Zahlen  der  Frames  zur  Verfiigung;  das  muB  man  dann 
in  der  Interruptroutine  schon  selbst  machen! 


Von  Digital  nach  Analog  -  Der  Weg  des  Tonsignals  im  STE 

Die  Abbildung  J.7  zeigt  das  Zusammenspiel  des  STE-DMA-Soundteils  im  Uberblick. 

Es  ist  deutlich  die  Trennung  in  Linker  und  Rechter  Kanal  zu  erkennen.  Die  vom  SHIFTER 
im  DMA-Betrieb  aus  dem  RAM  gelesenen  Sound-Daten  (Samples)  gelangen  als  8-Bit- Werte 
zunachst  in  ein  8-Bit  D-Flip-Flop  und  werden  dort  “eingefroren”,  bis  der  nacbste  Sample 
folgt!  Das  “Einfrieren”  wird  durch  die  Signale  _LD  (Daten  fiir  linken  Kanal)  und  _RD  (Daten 
fiir  rechten  Kanal)  fiir  jeden  Kanal  getrennt  bewirkt.  Bei  Mono-Betrieb  werden  beide  8-Bit- 
Latches  gleichzeitig  (_LD  und  _JRD  sind  synchron)  bedient. 
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Abb.  J.7:  Das  Zusammenspiel  des  STE-DMA-Soundteils 
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An  den  Ausgangen  der  8-Bit-Latches  steht  also  jeweils  fur  die  Dauer  eines  Samples  eine  8- 
Bit-Information  an.  Diese  wird  durch  die  nachgeschalteten  Digital/Analog-Wandler  in  einen 
entsprechenden  Spannungswert  umgesetzt.  Der  Ausgangswert  wird  hochohmig  iiber  einen 
Impedanzwandler  (1  fach  Verstarker  mithohemEingangs-  und  niedrigem  Ausgangswiderstand) 
abgegriffen  und  einem  geschalteten  TiefpaBfilter  zugefiihrt.  Dieser  geschaltete  TiefpaBfilter 
vierter  Ordnung  wird  direkt  durch  die  Samplefrequenz  (Frameclock)  gesteuert  und  laBt  nur 
noch  Frequenzen  unterhalb  40%  der  Samplefrequenz  durch! 

AnschlieBend  gelangt  das  Signal  iiber  zwei  l6kHz-Tiefpasse  zweiter  Ordnung.  Das  bedeutet 
also,  daB  in  einem  DMA-Sound- Ausgangssignal  nur  Frequenzen  bis  zu  max,  16kHz  “vertre- 
ten”  sein  konnen.  Alles  was  dariiber  liegt,  wird  ausgefiltert.  Am  Ausgang  des  zweiten  16kHz- 
Filters  liegt  das  Signal  dann  zur  Bearbeitung  durch  den  Volume/Tone-Controller  LMC1992 
bereit.  Die  Pegelbeeinflussung  (V  olume)  und  Balancesteuerung  erfolgt  erst  im  LMC 1 992.  Fiir 
die  Anhebung/Absenkung  der  Basse  bzw.  Hohen  kann  der  LMC1992  einen  Teil  des  Signals 
(in  den  Bassen/Hohen  angehoben  Oder  abgesenkt)  zwischen  dem  ersten  und  zweiten  16kHz- 
TiefpaBfilter  einkoppeln. 

An  den  Ausgangen  des  LMC  1992  wird  das  Tonsignal  fiir  den  rechten  und  linken  Kanal  direkt 
abgegriffen  und  iiber  einen  Schutzwiderstand  (gegen  Kurzschliisse  am  Ausgang)  und  einen 
Kondensator  gleichspannungsfrei  auf  die  Cinch-Buchsen  gefiihrt. 

Damit  iiber  den  Lautsprecher  eines  angeschlossenen  Monitors  auch  etwas  zu  horen  ist,  werden 
beide  Kanale  iiber  eine  Mischstufe  (bestehend  aus  zwei  Verstarkerstufen  und  zwei  Mischwi- 
derstanden)  zusammengefaBt.  V on  dort  gelangt  das  Tonsignal  (in  Mono)  an  die  Monitorbuchse 
und  an  den  HF-Modulator. 

Um  aber  das  Tonsignal  vom  “alten”  Soundchip  PSG  nicht  zu  vergessen  (woher  sonst  den 
“schonen”  T astaturklick  nehmen),  hat  Atari  dessen  Audiosignal  ebenfalls  iiber  den  LMC  1992 
gefiihrt.  Zusammen  mit  einem  von  auBen  zufiihrbaren  extemen  Tonsignal  wird  das  PSG- 
Audiosignal  ebenfalls  einer  Bearbeitung  durch  den  LMC1992  unterworfen. 


Kontrolle  iiber  den  Sound  - 
Das  MICROWIRE  "-Interface 

Fiir  die  Beeinflussung  des  vom  Sound-DMA-Modul  gelieferten  Tonsignals  hat  Atari  einen 
eigenen  Chip  von  National  Semiconductor  eingesetzt.  Mit  diesem  speziellen  Chip  ist  es 
moglich,  per  Softwarekontrolle  Einstellung  der  Lautstarke  (Volume),  Balance  (zwischen  den 
beiden  Kanalen)  vorzunehmen.  AuBerdem  ist  eine  Bass-/Hohenregelung  per  Software  reali- 
sierbar. 
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Da  dieser  Chip  nicht  spe/iell  fiir  den  STE  ausgelegt  wurde,  sondem  auch  in  Geraten  der 
Unterhaltungselektronik  (z.  B.  Femseher)  Verwendung  findet,  wird  fiir  die  Ubergabe  der 
Parameter  wie  z.  B.  Lautstarke,  Balance  usw,  ein  einfaches,  serielles  Bussystem  verwendet. 

National  Semiconductors  spricht  hierbei  vom  MICROWIRE<™)-Bussystem.  Sowohl  der 
Volume/Tone-Controller  Chip  LMC1992  als  auch  der  STB  besitzen  dafiir  ein  eigenes 
MICROWIREfrM)-Interface.  Im  STE  wurde  das  Interface  mit  im  SHIFTER-Chip  unterge- 
bracht! 


Noch  eine  serielle  Schnittstelle  im  STE 

Wie  bereits  angesprochen,  wird  der  Parameteraustausch  (Lautstarke,  Balance  usw.)  mit  dem 
LMC1992  liber  einen  seriellen  Bus  abgewickelt.  Der  Bus  besteht  nur  aus  drei  Leitungen, 
wobei  die  MWD-Leitung  (MICROWIRE(TM)-Data)  zum  Transport  der  eigentlichen  Daten 
benutzt  wird. 

Dabei  ist  der  Datentransport  nur  in  eine  Richtung,  namlich  zum  LMC1992  hin,  vorgesehen. 
Das  _MWE-Signal  ( MICRO  WIRE,TM)-Enable)  geht  so  lange  auf  Low,  wie  Daten  gesendet 
werden,  und  iiber  die  M  WK-Leitung  (MICRO  WIRE<TM)-Clock)  erfahrt  der  Empfanger  (in  un- 
serem  Fall  der  LMC 1992),  in  welchemTakt  die  Daten  iibermittelt  werden.  DieDateniibertra- 
gungsgeschwindigkeit  betragt  dabei  im  STE  immerhin  1  MBit/s! 

Das  Bussystem  und  Ubertragungsprotokoll  ist  dabei  sehr  flexibel  ausgelegt,  so  daB  mehrere 
verschiedene  MICROWIREriM,-Devices  angesprochen  werden  konnen. 

Jedes  Device  kann  individuell  vom  Controller  (STE)  adressiert  werden.  Die  Lange  des  zu 
ubermittelnden  Datenstroms  ist  dabei  abhangig  vom  adressierten  Device.  Damit  jedes  Device 
“mitbekommt”,  wann  es  gemeint  ist  und  welche  Daten  iibertragen  werden,  hat  der  serielle 
Bitstrom  folgendes  Format: 

Zunachst  werden  N- AdrBsbits  (beim  LMC 1 992  im  STE  sind  das  zwei  Bits)  zur  Festlegung  des 
gewiinschten  Devices  gesendet.  Darauf  folgen  eventuell  einige  “Don’t  care”~Bits  und  dann 
die  eigentlichen  Datenbits. 

Fiir  die  Bedienung  des  seriellen  Interfaces  werden  im  STE-SHIFTER  zwei  16-Bit-Schiebe- 
register  benutzt.  Dazu  werden  im  MICRO WIRE^-Data-Register  die  Bits  fiir  den  Bitstrom 
(Adrefi-  und  Datenbits)  abgelegt  (Bit  15  wird  zuerst  ausgegeben.  Bit  0  zum  SchluB),  der  iiber 
die  MWD-Leitung  ausgegeben  werden  soli.  Das  MICRO  WERE<TM)~Mask-Registerbestimmt, 
welche  Bits  im  MW-Data-Register  giiltige  Bits  sind  (also  AdreB-  bzw.  Datenbits)  und  welche 
als  “Don’t  care”-Bits  fungieren. 
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Adresse 

Label 

RVV 

Bits 

Bedeutung 

$FF  8922 

RAV 

DDDD  DDDD  DDDD  DDDD 

AdreB-/Datenbits  zur 

MWDATA 

Ausgabe  ii.  MWD-Leitung 

$FF  8924 

RA V 

MMMM  MMMM  MMMM  MMMM 

MICROWIREfrM)-Mask- 

MWMASK 

Register 

Um  also  an  z.  B.  den  LMC1992  des  STE  eine  Information  abzusetzen,  sind  im  MWDATA- 
Register  zunachst  die  Adrefibits  korrekt  zu  setzen.  Der  LMC1992  im  STE  hat  die  Adresse  #2 
entsprechend  binar  “10”.  Danach  folgen  die  zu  sendenden  Datenbits.  Wollte  man  z.  B.  an  den 
LMC1992  den  Binarwert  “1 1011”  senden,  so  konnte  das  mit  folgenden  MWMASK-  und 
MWDATA-Register-Einstellungen  geschehen: 


< - Schieberichtung 


10  11 
1111 


011X  XXXX  XXXX  <-  MWDATA 
1110  0000  0000  <- MWMASK 


oder 


XXXX  10XX  XXII 
0000  1100  0011 


0  1  1  X  <- MWDATA 
1110  <-  MWMASK 


oder 


XXXX 
0  0  0  0 


XXXX 
0  0  0  0 


X  1  0  1 
0  111 


10  11 
1111 


<- MWDATA 
<-  MWMASK 


oder 


1  0  X  X 
110  0 


XXXX 
0  0  0  0 


XXXI 
0  0  0  1 


10  11 
1111 


<-  MWDATA 
<- MWMASK 


(X  =  Don’t  care) 


Wie  in  den  Beispielen  zu  sehen  ist,  kommt  es  also  nur  darauf  an,  daB  AdreB-  und  Datenbits 
gleichzeitig  im  MWDATA-Register  stehen  und  die  zugehorigen  Mask-Bits  gesetzt  sind. 
AdreBinformation  und  Daten  diirfen  durch  mehrere  Bitpositionen  getrennt  werden,  konnen 
aber  auch  direkt  hintereinander  anschlieBen. 
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Bei  der  Bedienung  der  beiden  Register  und  damit  des  MICROWIRE(TM)-Interfaces  im  STE 
ist  zu  beachten,  daB  zuerst  das  MWMASK-Register  gesetzt  wird .  Denn  sobald  das  MWDATA- 
Register  beschrieben  wurde,  gehen  die  Informationen  auf  den  Bus! 

Wahrend  der  Registerinhalt  auf  den  Bus  ausgegeben  wird,  ist  ein  Beschreiben  der  MWMASK 
und  MWD ATA-Register  nicht  moglich.  Um  also  die  nachste  Ausgabe  starten  zu  konnen,  muB 
gewartet  werden,  bis  die  gerade  laufende  Ausgabe  beendet  ist. 

Die  beiden  Schieberegister  werden  zur  Informationsausgabe  dabei  Bit  fur  Bit  nach  links 
rotiert!  Das  bedeutet,  daB  nach  insgesamt  1 6  Bit-Shifts  (also  bei  1  MBits/s  Dateniibertragungs- 
geschwindigkeit  nach  ca.  1 6psec)  die  Register  durch  eine  komplette  Rotation  des  eingeschrie- 
benen  Bitmusters  wiederin  Ausgangsposition  angekommen  sind!  Das  Auslesen  der  Register 
wahrend  der  laufenden  Ausgabe  ist  moglich  und  liefert  jeweils  eine  “Momentaufnahme”  iiber 
den  Zustand  der  Schieberegister. 

Diese  Eigenschaften  kann  man  sich  zunutze  machen,  indem  man  durch  standiges  Auslesen 
des  MWMASK-Registers  nach  Starten  der  Ausgabe  den  Zeitpunkt  feststellt,  wann  das 
MWMASK-Register  wieder  im  Ausgangszustand  angelangt  ist.  Dann  ist  namlich  die  letzte 
Ausgabe  abgeschlossen,  und  der  nachste  Wert  fur  das  MWD  ATA-Register  kann  eingebracht 
werden. 

Da  man  es  im  STE  selten  mit  einem  anderen  Device  als  dem  LMC1992  zu  tun  haben  wird, 
kann  man  das  MWMASK- Registernach  dem  erstmaligen  Setzen  der“  Valid”-Bits  unverandert 
lassen.  Alle  weiteren  Kommandos  an  den  LMC1992  haben  ja  das  gleiche  Format  bezuglich 
der  Anordnung  der  “Valid”-Bits!  Man  braucht  also  nur  das  MWD  ATA-Register  mit  neuen 
Werten  zu  versehen. 


Computer  Controlled  Volume/Tone  -  Der  LMC  1992 

Beim  LMC  1 992  handelt  es  sich  um  einen  relativ  leistungsfahigen  Baustein  zur  Kontrolle  von 
Audiosignalen.  Im  STE  werden  die  im  folgenden  dargestellten  Einstellmoglichkeiten  benutzt: 

LMC1992  Device  Adresse:  10Wn:ir 


Datenbits 

Befehl 

011  V  V 

V  V  V  V 

Lautstarke  einstellen 

0  0 

0  0  0  0 

-80  dB  (Einstellung  in  Schritten 

0  1 

10  0  0 

-40  dB  (zu  je  2  dB  moglich!) 

1  0 

1  X  X  X 

0  dB  =  max.  Lautstarke 
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Datenbits 

Befehl 

101 

X  L 

L 

L 

L 

L 

Lautstarke  linker  Kanal  (2  dB/Schritt) 

0 

0 

0 

0 

0 

-40  dB 

0 

1 

0 

1 

0 

-20  dB 

1 

0 

1 

X 

X 

0  dB 

100 

X  R 

R 

R 

R 

R 

Lautstarke  rechter  Kanal  (2  dB/Schritt) 

0 

0 

0 

0 

0 

-40  dB 

0 

0 

1 

0 

1 

-30  dB 

1 

0 

1 

X 

X 

0  dB 

010 

X  X 

H 

H 

H 

H 

Hohenanhebung  bei  ca.  15kHz  um  2  dB/Schritt 

0 

0 

0 

0 

-12  dB  Absenkung 

0 

1 

1 

0 

0  db  (Linear) 

1 

1 

0 

0 

+12  dB  Anhebung 

001 

X  X 

B 

B 

B 

B 

BaBanhebung  bei  ca,  50Hz  um  2  dB/Schritt 

0 

0 

0 

0 

-12  dB  Absenkung 

0 

1 

1 

0 

0  dB  (Linear) 

1 

1 

0 

0 

+12  dB  Anhebung 

000 

X  X 

X 

X 

M 

M 

Mischen  mit  PSG-Soundsignal/Ext.  Soundsignal 

0 

0 

PSG-Signal  mit  -12  dB  Absenkung  zumischen 

0 

1 

PSG-Signal  1:1  zumischen 

1 

0 

PSG-Signal  nicht  zumischen 

1 

1 

reserviert 

Alle  Kommandos  sind  beim  LMC 1 992  also  neun  Bits  breit.Mit  den  jeweils  zwei  Bits  ( 1 0bWr) 
fiir  die  LMC1992-Adresse  ergeben  sich  also  immer  insgesamt  elf  Bits,  die  iiber  den  Bus 
auszugeben  sind.  Setzt  man  die  Adresse  und  Daten  unmittelbar  aneinander  und  rechtsbiindig 
ins  MWDATA-Register,  so  ist  als  Wert  fiir  das  MWMASK-Register  das  Bitmuster  $07FF  zu 
wahlen.  MWMASK-  und  MWDATA-Register  miiflten  dann  also  folgendermaBen  aussehen: 

MWMASK  0000  0111  1111  1111 

MWDATA  XXXX  X10D  DDDD  DDDD 

III  1 


9  Bits  fiir 

LMC  1 992-Kommando 
Die  beiden  AdreBbits 
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Um  im  STE  den  Volume/Tone-Control-Chip  auf  max.  Lautstarke  einzustellen,  miifile  also 
folgende  Einstellung  in  den  beiden  Schieberegistem  benutzt  werden: 

MWMASK  0000  0111  1111  1111 

MWDATA  XXXX  X100  1110  1000 

Die  Bedienung  der  MWMASK-  und  MWDATA-Register  in  einem  Programm  ist  ebenfalls 
aus  dem  Beispiellisting  ersichtlich. 


Mehr  Kontrollmoglichkeiten  fiir  den  Videoteil 

Atari  hat  dem  STE  noch  einiges  an  zusatzlicher  Hardware  im  Videoteil  “spendiert”.  Damit 
lassen  sich  vor  alien  Dingen  in  der  Colorbetriebsart  einige  interessante  Effekte  realisieren. 
Hauptsachliche  Anwendungen  dieser  zusatzlichen  Effektmoglichkeiten  diiTften  im  Spiele- 
bereich  zu  finden  sein. 

Aber  auch  fiir  einen  anderen  Hobbybereich  diirfte  der  STE  nun  interessanter  werden.  Bisher 
war  es  nur  mit  direkten  Manipulationen  in  der  ST -Hardware  moglich,  sogenannte  GENLOCK- 
Anwendungen  unter  Einbeziehung  von  STs  zu  realisieren.  Gedacht  ist  hierbei  an  das  Mischen 
von  ST-Videosignalen  mit  anderen  Videosignalquellen  (z.  B.  Videokamera),  um  so  beispiels- 
weise  Titelbild-  oder  Hintergrundgestaltung  mittels  Computer  zu  unterstiitzen. 

Um  Videosignale  unterschiedlicher  Quellen  zu  mischen,  ist  es  erforderlieh,  daB  alle  Signale 
zueinander  sy  nchron  sind.  Das  bedeutet  nichts  anderes,  als  daB  ein  Videosignal  als  Mastersignal 
verwendet  wird,  auf  welches  sich  alle  anderen  Videosignale  einzustellen  haben.  Fiir  den  ST/ 
STE  folgt  daraus,  daB  nicht  die  intern  erzeugten  H-  und  V-Synchronisationssignale  verwendet 
werden,  sondem  extern  zugefiihrte  Signale  zu  verwenden  sind.  Das  war  ja  schon  bei  den  STs 
moglich  (Bit  0  im  Sync-Mode-Register  ( Adr.  $FF  820A)  auf  log.  1  setzen  und  an  der  Monitor- 
buchse  HSync-  und  VSync-Signale  einspeisen)!  Aber  damit  war  der  Beginn  des  Bildinhalts 
in  jeder  Zeile  immer  noch  vom  internen  ST -T  akt  abhangig  und  fiihrte  deshalb  zu  unerwiinsch- 
tem  “ZeilenreiBen”  (das  Bild  begann  von  Zeile  zu  Zeile  mehr  oder  weniger  stark  waagerecht 
versetzt  und  erschien  deshalb  ausgefranst  und  unruhig). 

Im  STE  ist  es  jetzt  moglich,  auch  einen  extemen  Mastertakt  als  Systemtakt  einzuspeisen,  der 
von  einer  Mastersignalquelle  abgeleitet  wird.  Diese  Mastersignalquelle  muB  in  der  Lage  sein, 
an  alle  zu  mischenden  Videosignalquellen  die  aus  einem  Mastertakt  abgeleiteten  HSync-  und 
VSync-Signale  zu  liefem  und  dem  STE  einen  Mastertakt  von  32,084988  MHz  (=  PAL- An¬ 
wendungen;  bei  NTSC-Anwendungen  soil  derext.Taktbei  32,215905  MHzliegen)  zurVer- 
fiigung  zu  stellen.  Damit  lauft  der  STE  also  vollig  synchron  zur  Mastersignalquelle,  und  das 
ZeilenreiBen  ist  vorbei. 
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Wie  kommt  der  Mastertakt  nun  in  den  STE  hineiri?  Dafiir  hat  Atari  die  Beschaltung  der  STE- 
Monitorbuchse  gegeniiber  den  STs  etwas  verandert.  An  Pin  3  der  Monitorbuchse  kann  nicht 
langer  das  General-Purpose-Output-Signal  (GPO-Signal)  vom  PSG-Port  IOA  6  abgegriffen 
werden.  Vielmehr  wird  jetzt  durch  das  Anlegen  einer  log.  0  an  diesem  AnschluB  der  “Weg 
frei  gemacht”  fiir  den  ext.  32  MHz-Mastertakt.  Dieser  Mastertakt  wird  dann  an  Pin  4  der  Moni¬ 
torbuchse  eingespeist.  Die  Zusammenhange  zwischen  diesen  beiden  Anschliissen  zeigt  auch 
der  Schaltungsauszug  in  Abbildung  J.6.  Bei  High  an  Pin  3  arbeitet  Pin  4  als  Monochrom-De- 
tect-Eingang,  und  bei  Low  wird  der  Mastertakt  an  Pin  4  erwartet. 

Wichtig!  Nicht  wahrend  des  laufenden  Betriebs  die  Taktumschaltung  mit  Pin  3  vornehmen. 
Also  immer  bei  ausgeschaltetem  STE  Pin  3  gegen  Masse  legen  und  ext.  Mastertakt  an  Pin  4 
zufiihren. 


Mehr  Farben  im  Zugriff  -  Erweiterungen  bei  der  Farbpalette 

Eine  weitere  Hardware-  Anderung  betrifft  den  SHIFTER.  Genauer  gesagt  die  Palette-Register, 
denen  Atari  im  STE  nun  fiir  jede  der  drei  Primarfarben  Rot,  Griin  und  Blau  4  Bit  (statt  bisher 
3  Bit  im  ST)  fiir  die  Verschliisselung  der  Farbintensitat  zugedacht  hat.  Somit  sind  nun 
3  x  4  Bit  zur  Farbauswahl  moglich,  und  man  kann  aus  2A*M  =  2'2  =  4096  Farben  wahlen. 
Dabei  sind  aber  ohne  Tricks  gleichzeitig  auch  kiinftig  nur  16  verschiedene  Farben  darstellbar 
(wegen  der  weiterhin  nur  16  Farbpalette-Register)! 


15 

8  ? 

e 

IBBBBIBB 

BDIBB 

BDIBBBB 

i 

nicht 

1 - 

benutzt 

Palette-Register  in  STE 

Blau-Intensitat  t8. .15) 
Griin-Intensi-tat  (B.  .15) 
Rot-Intensitat  (8. .15) 


Abb.  J.8:  Palette-Register  im  STE 

Um  mit  dem  STE  trotz  der  erweiterten  Farb-Palette  moglichst  kompatibel  zu  bleiben,  ist  die 
Gewichtung  (Intensitat),  mit  der  die  einzelnen  Primarfarben  im  Gesamtsignal  auftauchen,  fiir 
die  unteren  3  Bits  jeder  Primarfarbe  beibehalten  worden.  Die  Voreinstellung  fur  ein  giftiges 
Griin  ist  auf  ST  und  STE  mit  dem  gleichen  Wert  im  entsprechenden  Palette-Register  moglich. 
Beim  STE  kann  man  dieses  Griin  durch  das  zusatzliche  4.  Bit  halt  noch  ein  wenig  “giftiger” 
machen. 
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Entsprechend  den  zusatzlichen  Bits  in  den  Palette-Registem,  wurde  natiirlich  der  D/A~Wand- 
ler  am  SHIFTER -Ausgang  urn  je  ein  Bit  auf  4  Bit-Aufldsung  je  Primarfarbe  erweitert. 


FinescroIIing  mil  Hardware-Unterstiitzung 

Durch  einige  Hardware- Anderungen  ist  es  mit  dem  STE  jetzt  einfacher  moglich,  FinescroIIing 
(Bildverschiebungen  im  Pixel-Raster)  sowohl  in  senkrechter  als  auch  in  waagerechter  Rich- 
tung  vorzunehmen.  Dazu  wurden  zwei  neue  Register  eingeftihrt  und  drei  bereits  bekannte 
Register  des  Videoteils  in  ihrer  Funktion  erweitert. 

Senkrechtes  FinescroIIing 

laBt  sich  einfach  dadurch  realisieren,  dab  man  wahrend  der  Dunkeltastung  des  Elektronenstrahls 
(im  Vertical-Blank)  die  Anfangsadresse  des  Bildschirmspeichers  um  eine  Bildschirmzeile 
(das  sind  in  der  Regel  80  Bytes)  herauf-  oder  heruntersetzt.  Dadurch  ergibt  sich  der  Eindruck, 
als  ware  das  gesamte  Bild  etwas  nach  unten  bzw.  nach  oben  verschoben  worden.  Natiirlich 
muB  man  im  Speicher  schon  etwas  mehr  als  nur  einen  Bildschirminhalt  zur  Verfiigung  haben 
(z.  B.  mehrere  komplette  “Bildschinme”  direkt  hintereinander  in  den  Speicher  laden).  “Oben” 
und  “unten”  vom  gerade  dargestellten  Bildschirminhalt  muB  sich  im  Speicher  ja  ebenfalls 
sinnvolle  Bildinformation  befinden,  die  angezeigt  wird,  wenn  nach  oben  oder  unten  gescrollt 
wird. 

Man  kann  sich  das  Ganze  also  so  vorstellen,  als  wurde  man  auf  dem  Monitor  ein  Fenster  sehen, 
das  in  senkrechter  Richtung  iiber  ein  groBes  Bild  (im  Speicher)  verschoben  werden  kann. 

Das  Problem  mit  dem  senkrechten  FinescroIIing  im  ST  besteht  darin,  daB  man  den  Anfang  des 
Bildschirmspeichers  mittels  des  Video-Base-Registers  (Video-Base-Reg.  High-Byte  bei  Adr. 
$FF  8201,  Video-Base-Reg.  Mid-Byte  bei  Adr.  $FF  8203)  nur  in  256  Byte-Schritten  verset- 
zen  kann.  Es  “fehlt”  ja  im  Video-Base-Register  ein  Registerplatz  fiir  das  Low-Byte  der  An¬ 
fangsadresse  des  Bildschirmspeichers. 

Im  STE  hat  man  dieses  Register  zusatzlich  “eingebaut”,  so  daB  senkrechtes  FinescroIIing  jetzt 
problemlos  moglich  ist.  Der  vollstandige  Registersatz  fiir  die  Anfangsadresse  der  Bildschirm- 
adresse  sieht  damit  im  STE  folgendermaBen  aus: 


Adresse 

Label 

i 

R/W 

Bits 

Bedeutung 

$FF  8201 

R/W 

XXHH  HHHH 

Video-Base-Register,  High-Byte 

dbaseh 
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Adresse 

Label 

R/W 

Bits 

Bedeutung 

$FF  8203 
dbasel 

R/W 

MMMMMMMM 

Video-Base-Register,  Medium-Byte 

$FF  820C 
dbaselow 

R/W 

LLLL  LLL0 

Video-Base-Register,  Low-Byte 

Diese  drei  Register  bilden  zusammen  den  Pointer  auf  den  Anfang  des  Bildschirmspeichers. 
Durch  das  zusatzliche  “dbaselow”-Register  laBt  sich  die  Anfangsadresse  des  Bildschirm- 
speichers  im  STE  auf  jede  beliebige  Word-Grenze  im  RAM  legen. 

Diese  Anfangsadresse  kann  jederzeit  ausgelesen  werden.  Auch  das  Neusetzen  der 
Bildschirmspeicher- Anfangsadresse  kann  jederzeit  durchgefiihrt  werden;  Aus  wirkungen  sind 
aber  erst  nach  dem  nachsten  Vertical-Blank  (also  beim  Neubeginn  des  nachsten  Bildes)  zu 
erwarten.  Denn  was  im  Moment  dargestellt  wird,  ist  von  der  Adresse  im  Video-Address- 
Counter  abhangig,  und  dieser  wird  jedesmal  zu  Beginn  eines  neuen  Bildes  mit  dem  Wert  im 
V ideo-B  ase-Register  initialisiert! 

Nachfolgend  ist  ein  einfaches  Demoprogramm  fur  senkrechtes  Finescrolling  im  Monochrom- 
Modus  aufgefuhrt.  Es  werden  zwei  “normale”  Doodle-Bilder  hintereinander  in  einen  Buffer 
geladen.  Die  aktuelle  Bildschirmspeicher-Basisadresse  wird  abgefragt  und  verwahrt.  Danach 
wird  die  Basisadresse  des  Bildschirmspeichers  auf  den  Anfang  des  Buffers  mit  den  beiden 
Bildem  gelegt.  Arrschliefiend  wird  schrittweise  der  sichtbare  Bildschirmausschnitt  durch 
standiges  Erhohen  der  Bildschirmspeicher-Basisadresse  um  80  Bytes  (=  eine  Zeile)  dariiber 
“hinweggefahren”.  Das  ergibt  den  Effekt,  als  wiirde  das  Bild  von  unten  nach  oben  durchrollen. 

Zum  guten  SchluB  wird  der  Videocontroller  wieder  auf  die  alte  Bildschirmbasisadresse 
zuriickgesetzt. 

1000  '  Vertikales  Pinscrolling  mit  STE  (Einfaches  Demo  im 
'  Monochrom-Modus ! ) 

1010  ' 


1020  '  Es  werden  zwei  Bilddateien  im  Doodle-Format  eingeladen  und 
1030  '  zu  einem  Grofibild  "hintereinander"  kopiert.  Dieses  Groiibild 
1040  '  wird  dann  per  vertikalem  Scrolling  einmal  von  oben  nach 
'  unten  "durchfahren" ! 

1050  ' 


1060  ' 
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1070  MEMORY JBLOCK  00, 64000, Buffer%L: ' 

1080  BLOAD  "BILD_1 .DOO", Buf fer%L: ' 

1090  BLOAD  "BILD_2.DOO",Buffer%L+32000 
1100  ' 

1110  XBIOS  (Physbase%L, 2) : ' 

1120  ' 

1130  XBIOS  (,5,L  -1, L  Buffer%L,-l) 

1140  ' 

1150  FOR  Ypos%L=0  TO  399:' 

1160  Scrnadr%L=Buffer%L+Ypos%L*80 : ' 

1170  XBIOS  (,5,L  -1,L  Scrnadr%L, -1) : ' 
1180  WAIT  .01:' 

1190  NEXT  Ypos%L 
1200  v 

1210  XBIOS  (,5,L  -1, L  Physbase%L, -1) : ' 
1220  FRE  (Buffer%L) : ' 


Platz  fur  zwei 
" .DOO"-Bilder 
Bilder  einladen. 


Alte  Bildschirm- 
adresse  merken. 

Auf  "GroBbild"  um- 
schalten ! 

Vertikale  Pos. 
schrittweise  andern. 
Neue  Screenadresse 
berechnen 
und  einstellen. 
Kleine  Pause! 


Auf  alten  Screen 
zuruckschalten . 
Benutzten  Speicher 
wieder  freigeben! 


Um  unmittelbare  Reaktionen  zu  erzielen  (nach  einer  bestimmten  Zahl  von  Bildschirmzeilen 
auf  einen  anderen  Bildschirmspeicherbereich  umzuschalten  o.  a.),  miifite  man  den  Video- 
Address-Counter  manipulieren  konnen.  Dieser  enthalt  namlich  den  Pointer  auf  das  nachste 
Word  im  Bildschirmspeicher,  das  geholt  und  in  Bildinformation  umgesetzt  werden  soli.  Beim 
ST  ist  der  Video- Address-Counter  ein  3-Byte-/?ea<7-0n/y-Register. 


Im  STE  hat  Atari  dieses  Register  ebenfalls  fiir  Schreibzugriffe  zuganglich  gemacht. 


Adresse 

Label 

R/W 

Bits 

Bedeutung 

$FF  8205 
vcounthi 

R/W 

XXHH  HHHH 

Video-Address-Counter,  High-Byte 

$FF  8207 
vcountmid 

R/W 

MMMMMMMM 

Video-Address-Counter,  Med.-Byte 

$FF  8209 
vcountlow 

R/W 

LLLL  LLL0 

Video-Address-Counter,  Low-Byte 
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Beim  Umgang  mit  diesem  Register  ist  Vorsicht  geboten,  da  das  Resultat  unmittelbar  sichtbar 
wird.  Eine  Bedienung  des  Video-Address-Counters  erscheint  deshalb  nur  wahrend  des 
Horizontal-Blank  sinnvoll.  Dann  ist  der  Elektronenstrahl  im  Monitor  gerade  vom  Ende  des 
Bildinhalts  der  just  geschriebenen  Bildschirmzeile  zum  Anfang  des  Bildinhalts  in  der  neuen 
Zeile  unterwegs  und  deshalb  dunkel  getastet.  Fur  das  Zahlen  der  abgelaufenen  Bildschirmzeilen 
kann  man  ja  wieder  den  Timer  B  als  Ereigniszahler  verwenden  (siehe  auch  im  ST-Hardware- 
teil,  Kapitel  4,  “Der  Multifunktionsbaustein  MFP  68901”). 

Horizontales  Finescrolling 

ist  nicht  gar  so  einfach  zu  realisieren.  Denn  hierbei  mui)  ein  Bild  (genauer  gesagt  jede  Bild¬ 
schirmzeile)  an  einem  beliebigen  Pixel  beginnen  konnen.  Und  das  bedeutet  nichts  anderes, 
als  dal)  man  dem  Videocontroller  mitteilen  mutS,  ab  welcher  Speicheradresse  undab  welchem 
Bit  in  dieser  Adresse  denn  die  Bildschirmzeile  beginnt. 

Im  STE  wurde  dafiir  eigens  das  HScroll-Register  geschaffen. 


Adresse 

Label 

R/W 

Bits 

Bedeutung 

$FF  8265 

RIW 

xxxxssss 

HScroll-Register,  verzogert  den 

hscroll 

Bildbeginn  um  SSSSbjn5r  Bits. 

Mit  diesem  Register  sind  Werte  zwischen  0  und  15  einstellbar.  Das  bedeutet,  daD  zunachst 
SSSSb.oilr-Pixel  bei  der  Ausgabe  als  Bildinformation  iibersprungen  werden.  Bei  HScroll  =  0  hat 
man  also  keine  horizontale  Verschiebung  auf  dem  Bildschirm  und  deshalb  die  gleichen 
Verhaltnisse  wie  im  ST. 

Im  Monochrom-Betrieb  ist  dieses  Verhalten  am  einfachsten  darzustellen,  da  ja  dann  jedem 
Bit  ein  Pixel  auf  dem  Bildschirm  entspricht.  Eine  Zeile  mit  640  Pixel  besteht  dann  aus  80  auf- 
einanderfolgenden  Bytes  im  Bildschirmspeicher. 

Weil  der  Videocontroller  (genauer  gesagt  der  SHIFTER)  im  ST(E)  nicht  einzelne  Bytes  aus 
dem  Bildschirmspeicher  holt  und  als  Bildinformation  umsetzt,  sondem  das  immer  wordweise 
geschieht,  ist  also  eine  Bildschirmzeile  40  Words  lang. 

Ist  HScroll  auf  z.  B.  5  eingestellt,  so  werden  aus  dem  Word  0  des  Bildschirmspeichers  die 
hochstwertigen  fiinf  Bits  iibersprungen  und  nicht  als  Bildinformation  ausgegeben! 

Die  Bildschirmzeile  beginnt  fiinf  Bits  “spater”  mit  Bit  10  des  Word  0  des  Bildschirmspeichers 
und  ist  640  Bit  (=  640  Pixel  bei  Monochrom)  danach  zu  Ende. 
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Das  letzte  Pixel  der  ersten  Zeile  wiirde  also  dem  Bit  1 1  des  Word  40  vom  Bildschirmspeicher 
entsprechen.  Die  zweite  Bildschirmzeile  fangt  dann  friihestens  wieder  (wegen  HScrolI=5)  mit 
Word  41,  Bit  10  an  und  geht  bis  zu  Word  81,  Bit  11  usw.  (siehe  dazu  auch  Abbildung  J.9). 


Abb.  J.9:  Organisation  des  Bildschirmspeichers  im  Monochrombetrieb  mit  H Scroll- 5 


Im  Gegensatz  zu  der  Organisation  des  Bildschirmspeichers  mit  HScroll=0  ist  eine  Zeile  bei 
HScroll>0  also  mindestens  ein  Word  langer,  Denn  die  Zeile  beginnt  ja  nicht  mehr  an  einer 
Word-Grenze,  sondem  um  HScroll-Bits  nach  rechts  verschoben.  Da  die  Anzahl  Bits/Zeile 
aber  weiterhin  gleichbleibt,  “ragt”  das  Ende  der  Zeile  um  HScroll-Bits  in  das  4 1  .Word  hinein! 

Um  diesem  Umstand  Rechnung  zu  tragen,  hat  man  im  STE  ein  weiteres  Hardware-Register 
eingefiihrt.  Das  Line- Width-Register  (“linewid”  an  Adr.  $FF  820F)  gibt  an,  um  wie  viele 
Words  die  Zeile  denn  “langer”  als  eine  normale  Bildschirmzeile  (normalerweise  40  Words/ 
hohe  Auflosung,  80  Words/mittlere  und  niedrige  Auflosung)  ist. 

Da  man  hier  ein  8-Bit-Register  zur  Verfugung  hat,  kann  man  hier  Werte  bis  zu  255  verwenden. 
Das  bedeutet  aber  auch  nichts  anderes,  als  daS  man  eine  Bildschirmzeile  im  Speicher  255 
Words  langer  als  die  “normale”  Zeile  machen  kann! 


Adresse 

Label 

R/W 

Bits 

Bedeutung 

$FF  820F 

R/W 

oooo  oooo 

Line-width-Register 

linewid 

Versatz  in  Words  bis  zum  Beginn 

der  nachsten  Bildschirmzeile 

Man  kann  also  auch  in  horizontaler  Richtung  “grofle”  Bildschirme  aufbauen  und  dann  durch 
entsprechende  Einstellung  des  HScroll-Registers  und  des  Bildschirmbasispointers  (dbasehi, 
dbasel  und  dbaselow)  jeweils  den  gewiinschten  Ausschnitt  davon  auf  dem  Bildschirm 
darstellen.  Das  nachfolgende  Beispiellisting  demonstriert  das. 
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Dabeiwerdenzwei  “nomale”  Monochrom-Bilder  (640  x  400=256  000  Pixel=16  OOOWords) 
“nebeneinander”  in  einen  Buffer  kopiert.  Also  erst  40  Words  (1.  Zeile)  von  Bild  1,  dann 
40  Words  (1.  Zeile)  von  Bild  2,  wieder  40  Words  (2.  Zeile)  von  Bild  1,  dann  40  Words  (2. 
Zeile)  von  Bild  2  usw. 

1000  '  Horizontales  Scrolling  rrdt  STE  (Einfaches  Demo  im  Monochrom- 
'  Modus ! ) 

1010  ' 


1020  '  Es  werden  zwei  Bilddateien  im  Doodle-Format  eingeladen  und 
1030  '  "zu  einem  nebeneinanderliegenden"  GroBbild  zusammenkopiert . 
1040  '  Dieses  Grolibild  wird  dann  per  horizontalem  Scrolling  einmal 
1050  '  "von  links  nach  rechts  abgefahren” ! 

1060  ' 

1070  Lineoffs%L=$FF820F: '  Benutzte  Hardware-Reg . 

fur  Scrolling 

1080  Hscroll%I.=$FF8265 
1090  ' 

1100  MEMORY_BLOCK  00, 64000, A%L: '  Platz  fur  zwei  ".DOO"~ 

Bilddateien 

1110  MEMORY__BLOCK  01,  64000, Buffer%L: '  Platz  fiir  das  "Grofibild" 
1120  BLOAD  "BILD_l.DOO",A%L:'  Zwei  Bilder  einladen 

1130  BLOAD  "BILD_2  .DOO" , A%L+32000 
1140  ' 

1150  XBIOS  (Physbase%L,  2) : '  Alte  Bildschirm- 

speicheradresse  merken . 

1160  ' 

1170  '  Beide  Einzelbilder  "nebeneinander"  im  Buffer  ablegen. 

1180  FOR  X%L=0  TO  399 

1190  MEMORY _MOVE  A%L+X%L*80, 80  TO  Buffer%L+X%L*160 

1200  MEMORY _MOVE  A%L+32000+X%L*80,  80  TO  Buffer%L-l-X%L*160+80 

1210  NEXT  X%L 
1220  ' 

1230  XBIOS  ( ,  5, L  -1,L  Buf fer%L,  -1)  : '  Auf  "GroBbild" 

umschalten ! 

1240  POKE  Lineoffs%L,  39: '  Lineoffs  =  40-1  Words  beim 

Scrollen 

1250  ' 

1260  FOR  Xpos%L=0  TO  639:'  Horizontale  Position 

schrittweise  andern. 

1270  IF  Xpos%L  MOD  16=0  THEN  Word-Grenze  erreicht? 
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1280  Scrnadr%L=Buffer%L+Xpos%L  SHR  3:'  Ja!  Neue  Screen- 

adresse  berech- 

1290  XBIOS  (,5,L  -1,L  Scrnadr%L, -1) : '  nen  und  einstellen. 

1300  XBIOS  ( ,  37) :  ’  Bis  zum  VBlank 

warten . 

1310  POKE  Hscroll%L, 1 : '  Hscroll  =  0  uberspringen . 

1320  ELSE 

1330  POKE  Hscroll%L,  Xpos%L  AND  $F:'  Nein !  Pixel-Delay 

setzen. 


1340  ENDIF 
1350  WAIT  7E-3 : ' 

1360  NEXT  Xpos%L 
1370  ' 

1380  XBIOS  (, 5,L  -1,L  Physbase%L, -1) 

1390  POKE  Hscroll%L, 0 : ' 

1400  POKE  Lineof fs%L, 0 

1410  FRE  (A%L) :  FRE  (Buffer%L):' 


Kleine  Pause! 


Auf  alten  Screen 
zuruckschalten 
Alles  wieder  in 
Ausgangszustand 

Benutzten  Speicher  wieder 
f reigeben ! 


Um  zum  SchluB  des  Programms  wieder  auf  die  “normale”  Bildschirmorganisation  zuriickgreifen 
zu  konnen,  wird  der  aktuelle  Bildschirmbasispointer  gerettet.  Dann  wird  durch  Neuladen  des 
Bildschirmbasisspeichers  mit  der  Anfangsadresse  des  “GroBbildbuffers”  auf  den  neuen 
Bildschirm  geschaltet.  Damit  der  Videocon  troller  des  STE  jetzt  weiB,  dafi  der  Bildschirmspeicher 
“breiter”  angelegt  ist,  wird  das  “linewid’-Register  entsprechend  eingestellt. 

In  einer  Schleife  wird  jetzt  die  Startposition  des  dargestellten  Bildschirms  standig  um  ein  Pixel 
nach  rechts  geriickt.  Dabei  wird  das  “HScroll”-Register  entsprechend  mit  hochgezahlt  und  ein 
pixelweises  Scrollen  nach  rechts  erreicht.  Wenn  mehr  als  16  Pixel  (-  16  Bit  =  1  Word  in 
Monochrom)  gescrollt  wurde,  muB  die  Anfangsadresse  des  Bildschirmspeichers  um  ein  gan- 
zes  Word  weitergeschaltet  (hochgezahlt)  werden.  Danach  kommen  wieder  16  Steps  mit  dem 
“HScrolF’-Register,  gefolgt  durch  das  Inkrementieren  des  Bildschirmbasispointers  usw. 

Das  Andem  der  Videocontroller-Register  sollte  natiirlich  dann  erfolgen,  wenn  es  moglichst 
wenig  auf  dem  Bildschirm  stort,  also  am  besten  im  VBlank.  Die  im  Listing  verwendete 
Xbios(,37)-Funktion  (=  Vsync)  leistet  dabei  schon  gute  Hilfe.  Zum  Ende  des  Programms  wird 
auf  Standardeinstellung  zuriickgeschaltet  und  der  alte  Bildschirmbasispointer  restauriert. 

Mit  dieser  Hardware-Unterstiitzung  lassen  sich  also  relativ  einfach  groBe  Bitplanes  im 
Speicher  (virtuelle  Playfields)  bearbeiten. 
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Im  Monochrom-  und  Low-Resolution-Modus  kommt  es  beim  STE-Shifter  bei  H-Scrolling- 
Anwendungen  zu  kleinen  Storungen  im  Bildaufbau,  immer  wenn  das  HSCROLL-Register 
von  einem  Nicht-Null-Wert  auf  Null  geht!  Atari  empfiehlt  deshalb,  bei  H-Scrolling-Anwen- 
dungen  im  Pixel-Raster  die  erforderlichen  Display-Manipulationen  bei  solch  einem  bevorste- 
henden  Wechsel  von  HSCROLL  <>  0  auf  HSCROLL  =  0  nicht  im  VBlank,  sondem  kurz 
vorher  durchzufilhren! 

Atari  schlagtfolgende  Vorgehensweise  vor,  um  die  fiir  das  horizontale  Scrolling  verwendeten 
Hardware-Register  (Video-Base-Address,  Hscroll  und  linewid)  zum  richtigen  Zeitpunkt  zu 
setzen.  In  einer  VBlank-Interrupt-Routine  werden  jeweils  die  neuen  Registerwerte  ermittelt, 
aber  erst  spater  durch  eine  Interrupt-Routine  gesetzt.  Dieser  Interrupt  wird  durch  den  als  Bild- 
schirmzeilenzahler  verwendeten  Timer  B  des  MFP  ausgelost!  Wenn  Hscroll  auf  Null  wech¬ 
sel  t,  werden  die  Hardware-Register  wahrend  der  letzten  Display-Zeile  geandert.  Bei  Hscroll=0 
wird  nach  der  letzten  Bildschirmzeile  manipuliert! 


Speicheraufriistung  leicht  gemacht  -  Atari  geht 
mit  der  Zeit 

Im  STE  fmdet  man  endlich  das  RAM  in  zeitgemafier  Bauform,  sprich  als  Bausteine,  wie  sie 
heute  im  Zeitalter  fortgeschrittener  Fertigungsmoglichkeiten  immer  verstarkter  angeboten 
werden.  Die  Zeiten,  in  denen  man  fiir  4  MByte  RAM  auf  der  Platine  noch  den  Platz  eines 
halben  DIN-A4-Blattes  brauchte,  sind  nun  langsam  vorbei.  Atari  verwendet  im  STE  zur 
Realisierung  des  RAMs  sogenannte  SIMMs.  Dabei  handelt  es  sich  um  kleine  Platinenstreifen 
mit  Direktsteckkontakten,  auf  denen  je  acht  RAM-Chips  in  SMD-Technik  aufgebracht  sind. 
Diese“RAM-Streifen”gibtessowohl zu256K  x  8  Bit (z.B. “58256- 10”) als auch  IM  x  8  Bit 
(z.  B.  “581000-10”)  organisiert.  Beide  Typen  konnen  verwendet,  sprich  einfach  in  die  vor- 
handenen  vier  Steckfassungen  gesetzt  werden.  Damit  lassen  sich  wieder  die  bereits  vom  ST 
bekannten  Kombinationsmoglichkeiten  fiir  den  RAM-Ausbau  herstellen.  Also  RAM  von 
1MByte  iiber  2,5MByte  bis  zu  4MByte  (in  meiner  Testmaschine)  ist  damit  moglich. 


“Nimm  SIMMS  -  dann  stimmt’s” 

Die  Einbindung  der  vier  moglichen  Fassungen  mit  “RAM-Streifen”  ist  im  nachfolgenden 
Schaltungsauszug  dargestellt.  Je  Bank  sind  auch  hier  wieder  die  Aufteilung  in  High-Byte  und 
Low-Byte  des  Datenbusses  zu  sehen.  Da  auch  hier  Leitungen  gespart  werden  sollen,  wird  der 
Adrefibus,  wie  in  den  STs,  gemultiplext. 

Mit  den  neun  Leitungen  des  Multiplex- AdreBbusses  lassen  sich  folglichnacheinander  2  x  9  = 
18  AdreBleitungen  iibertragen  und  somit  218  =  1.048.576  Speicherzellen  ansprechen. 


Anhang  J:  Die  Hardware  des  ATARI  STE 
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Da  die  RAM-Streifen  byteweise  organisiert  sind,  kann  man  max.  1MByte  je  Streifen 
ansprechen. 

Verv.-endet  werden  auch  hier  dynamische  RAMs,  deren  Inhalt  nach  einer  bestimmten  Zeit 
wieder  ‘aufgefrischt”  werden  muB.  AuBerdem  muB  man  entsprechende  Steuerinformationen 
fiir  dieRAMs  liefem,  damit  diese  wissen,  welche  Halfte  der  AdreBinformation  gerade  auf  dem 
Multiplex-AdreBbus  daherkommt.  Dazu  werden  auch  hier  wieder  die  RAS-  und  CAS-Signale 
benotigt. 


Abb.  J  JO:  Das  RAM  im  STE 
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Anhang  K: 

Die  Echtzeituhr  des  MEGA-ST(E) 


Die  Computer  der  MEGA-ST(E)-Serie  besitzen  alle  einen  batteriegepufferten  Uhrenchip  des 
Typs  “RP5C 1 5”.  Auch  die  Tastaturcomputer  des  Typs  STE  konnten  diesen  Uhrenchip  ansteu- 
em,  die  Steuersignale  sind  an  der  GSTMCU  vorhanden! 

Ab  TOS  Version  1.02  (Blitter-TOS)  wird  dieser  Uhrenchip  auch  benutzt,  wenn  er  denn  vor¬ 
handen  ist!  Das  TOS  ubergibt  die  Zeit-  und  Datumsinformation  an  das  GEMDOS,  wenn  das 
System  initialisiert  wird  und  jedesmal  wenn  ein  Anwenderprogramm  beendet  wird  (mit  dem 
GEMDOS-Aufruf  “PtermO”). 

Die  Einbindung  des  Uhrenchips  in  die  Hardware  des  MEGA-ST  zeigt  der  in  Abbildung  K.l 
dargestellte  Schaltungsauszug.  Der  Uhrenchip  bekommt  seinen  Takt  natiirlich  nicht  vom 
Systemtakt,  denn  der  “verschwindet”  ja  beim  Ausschalten  des  Computers.  Deshalb  also  noch 
ein  zusatzlicher,  eigener  Quarz  nur  fur  den  Uhrenchip.  Wie  der  Schaltungsauszug  zeigt,  besitzt 
der  Uhrenchip  noch  zwei  weitere  Anschlusse,  die  von  ATARI  nicht  benutzt  werden. 

Zum  einen  ware  da  der  Open-Collector-Ausgang  “_ALARM”.  Der  Uhrenchip  kann  namlich 
nicht  nur  Zeit  und  Datum  weiterzahlen,  sondem  wie  ein  normaler  Wecker  zu  einem  bestimm- 
ten  Datum  und  einer  eingestellten  Zeit  ein  Signal  auslosen,  Pin  1 5  des  Uhrenchips  schaltet  bu¬ 
rner  dann  nach  Masse  durch,  wenn  Alarmzeit  und  -tag  mit  den  aktuellen  Daten  iibereinstimmt. 
Das  Durchschalten  halt  eine  Minute  an,  weil  danach  ja  Alarmzeit  und  aktuelle  Zeit  nicht  mehr 
auf  die  Minute  ubereinstimmen,  Damit  durften  Bastler  doch  bestimmtetwas  anfangen  konnen 
(Interrupts  auslosen  o.a.). 

Der  zweite  zu  betrachtende  Ausgang,  der  von  ATARI  freundlicherweise  direkt  auf  einen 
Testpunkt  herausgefiihrt  wurde,  ist  der  Pin  3  (CLKOUT)  des  Uhrenchips.  Hier  kann,  je  nach 
Programmierung  eines  der  Register  des  Uhrenchips,  ein  Takt  abgegriffen  werden,  der  direkt 
aus  dem  Systemtakt  des  Uhrenchips  abgeleitet  wird.  Welche  Taktfr equenzen  an  diesem  Open- 
Collector-Ausgang  entnommen  werden  konnen,  wird  noch  bei  der  Besprechung  der  Chip-Re¬ 
gister  im  einzelnen  aufgefiihrt.  Von  einem  Impuls  pro  Minute  bis  zu  16384  Impulsen  pro  Se- 
kunde  sind  hier  moglich! 

Der  Datenbus  zum  Uhrenchip  ist  auf  ganze  vier  Leitungen  zusammengeschrumpft.  Mehr  sind 
aber  auch  nicht  erforderlich,  da  der  Uhrenchip  fur  jede  Stelle  der  Uhrzeit-  und  Datums¬ 
information  ein  eigenes  4-Bit-Register  besitzt.  Die  Selektion  der  einzelnen  Register  erfolgt 
iiber  vier  AdreBleitungen,  ob  wohl  der  Uhrenchip  iiber  32  Register  (!)  verfugt.  Man  bedient  sich 
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dabei  eines  “Switch-Bits”  in  einem  Register,  mit  dem  man  von  einer  Registerbank  mit  1 6  Regi- 
stem  auf  eine  zweite  Registerbank  umschalten  kann.  Das  Register  mit  dem  “Switch-Bit”  ist 
natiirlich  in  beiden  Banken  vorhanden;  wie  sollte  man  sonst  wieder  zmtickschalten  konnen? 


Abb.  K.l:  Die  Echtzeituhr  im  MEGA-ST 


Anhang  K:  Die  Echtzeituhr  des  MEGA-ST(E) 
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Die  Register  des  Uhrenchips 

Die  Register  des  Uhrenchips  liegen  im  AdreBraum  des  ST  auf  ungeraden  Adressen,  sind  je- 
doch  auch  als  niederwertigstes  Nibble  mit  Word-Zugriffen  auf  die  jeweils  darunterliegende, 
gerade  Adresse  zu  erreichen. 

Nachfolgend  die  Tabelle  mit  den  einzelnen  Registem,  deren  Adresse  und  Bedeutung: 
Zunachst  die  Register  fiir  die  Bank  0 

Bitbelegung 


Adresse 

D3 

D2 

D1 

DO 

Bedeutung 

$FF  FC21. 

s 

s 

s 

s 

Sekunden-Einer  (0..9) 

$FF  FC23 

- 

s 

s 

s 

Sekunden-Zehner  (0..5) 

$FF  FC25 

m 

m 

m 

m 

Minuten-Einer  (0..9) 

$FF  FC27 

- 

m 

IT) 

m 

Minuten-Zehner  (0..5) 

$FF  FC29 

h 

h 

h 

h 

Stunden-Einer  (0..9) 

$FF  FC2B 

- 

- 

h 

h 

Stunden-Zehner  (0..1  in  24h-Modus,  sonst  mit  Bit 
D1  AM/PM-Anzeige  im  12h-Modus  (gesetztes  Bit 
Dl-1  entspricht  PM-Zeit)). 

SFFFC2D 

- 

w 

w 

w 

Wochentag  (0  =  Sonntag).  Vom  TOS  nicht  benutzt. 

$FF  FC2F 

D 

D 

D 

D 

Tage-Einer  (0..9) 

$FFFC31 

- 

- 

D 

D 

Tage-Zehner  (0..3) 

$FF  FC33 

M 

M 

M 

M 

Monate-Einer  (0..9) 

$FF  FC35 

- 

- 

- 

M 

Monate-Zehner  (0..1) 

$FF  FC37 

Y 

Y 

Y 

Y 

Jahre-Einer  (0..9) 

SFFFC39 

Y 

Y 

Y 

Y 

Jahre-Zehner  (0..9)  (da  das  TOS  immer  in  Jahren 
ab  1980  rechnet,  wird  fiir  das  Jahr  1988  in  “Jahre- 
Einer”  also  eine  8  und  fiir  “Jahre-Zehner”  eine  0 
eingetragen) 

FFFC3B 

ST 

AL 

- 

BK 

Modus-Register  (Bitbedeutung  siehe  unten) 

“Switch-Bit”  (0-  Bank  0,  1-  Bank  1  angewahlt) 
Alarm-Bit  (0=  Alarm  aus,  1=  Alarm  ein) 
Stop-Bit  (0=UhrStop,  l=Uhrlauft) 
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Bitbelegung 

Adresse  D3  D2  D1  DO  Bedeutung 

$FFFC3D  0  0  0  0  Test-Register  (alle  Bits  miissen  0  sein!) 

$FFFC3F  T1  T2  RS  AR  Reset-Register  (Bitbelegung  siehe  unten) 

Alarm-Reset  (1=  setzt  alle  Alarm-Reg.  auf  0) 
Uhr-Reset  (1=  setzt  alle  int.  Uhr-Reg.  zuriick) 
16Hz  ein  (0=  16Hz-Impulse  an  Pin  15  ausgeben) 
1Hz  ein  (0=  lHz-Impulse  an  Pin  15  ausgeben) 

Und  nun  die  Register  der  Bank  1: 

Bitbelegung 


Adresse 

D3 

D2 

D1 

DO 

Bedeutung 

$FF  FC21 

- 

C2 

Cl 

CO 

Diese  drei  Bits  steuem  die  Impulsfolge,  welche  an 
Pin  3  ausgegeben  wird 

- 

0 

0 

0 

Open-Collector-Ausgang  “CLKOUT”  gesperrt 

- 

0 

0 

1 

Ausgangsfrequenz  16384  Hz 

- 

0 

1 

0 

Ausgangsfrequenz  1024  Hz 

- 

0 

1 

1 

Ausgangsfrequenz  128  Hz 

- 

1 

0 

0 

Ausgangsfrequenz  16  Hz 

- 

1 

0 

1 

Ausgangsfrequenz  1  Hz  (Sekundentakt) 

- 

1 

1 

0 

Ausgangsfrequenz  1/60  Hz  (Minutentakt) 

1 

1 

1 

Open-Collector-Ausgang  “CLKOUT”  durch- 
geschaltet 

SFFFC23 

AD 

Adjust-Bit.  Bei  Setzen  von  Bit  “AD”  gehen  die 
Sekundenregister  auf  0!  Wenn  die  Sekunden 
zwischen  30..59  waren,  werden  gleichzeitig  die 
Minuten  um  1  hochgezahlt. 

$FF  FC25 

am 

am 

am 

am 

Alarmzeit  Minuten-Einer  (0..9) 

SFFFC27 

- 

am 

am 

am 

Alarmzeit  Minuten-Zehner  (0..5) 

$FF  FC29 

ah 

ah 

ah 

ah 

Alarmzeit  Stunden-Einer  (0..9) 

$FF  FC2B 

- 

- 

ah 

ah 

Alarmzeit  Stunden-Zehner  (0..2) 

$FFFC2D 

- 

aw 

aw 

aw 

Alarmzeit  Wochentag  (0=Sonntag) 

$FF  FC2F 

aD 

aD 

aD 

aD 

Alarmzeit  Tage-Einer  (0..9) 

Anhang  K:  Die  Echtzeituhr  des  MEGA-ST(E) 
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Bitbelegung 


Adresse 

D3 

D2 

D1 

DO 

Bedeutung 

$FF  FC31 

_ 

_ 

aD 

aD 

Alarmzeit  Tage-Zehner  (0..3) 

$FF  FC33 

- 

- 

- 

- 

Nicht  benutzt! 

$FF  FC35 

- 

- 

- 

24 

Ist  das  “24”-Bit  gesetzt,  so  arbeitet  der  Uhrenchip 
im  24h-Modus. 

$FF  FC37 

- 

- 

SJ 

SJ 

Schaltjahr-Register  (es  wird  mit  den  Jahren  von 

0..3  hochgezahlt,  0  =  Schaltjahr!) 

SFFFC39 

_ 

- 

- 

Nicht  benutzt! 

SFFFC3B 

ST 

AL 

- 

BK 

Modus-Register  (Wie  in  Bank  0) 

$FF  FC3D 

0 

0 

0 

0 

Test-Register  (Wie  in  Bank  0) 

SFFFC3F 

T1 

T2 

RS 

AR 

Reset-Register  (Wie  in  Bank  0) 

Wie  man  sieht,  1st  dieser  kleine  Chip  doch  ganz  schon  leistungsfahig.  Leider  wird  vom 
Betriebssystem  auBer  der  Abfrage  des  laufenden  Datums  und  der  Uhrzeit  kaum  von  den 
Moglichkeiten  Gebrauch  gemacht. 

Die  Alarmfunktion  des  Chips  kann  man  leider  nicht  nutzen,  da  die  gegenwartige  TOS-Version 
nichts  Besseres  zu  tun  hat,  als  das  Register  “AlarmzeitMinuten-Einer”  zum  Test  zu  benutzen, 
ob  denn  der  Uhrenchip  iiberhaupt  anwesend  ist.  Dazu  wird  bei  der  Systeminitialisierung  ein 
unsinniger  Wert  in  dieses  Register  geschrieben  und  anschlieBend  verglichen,  ob  dieser  Wert 
auch  wirklich  dort  steht  (=  Chip  vorhanden),  Leider  wird  vor  dem  Test  nicht  der  augenblick- 
liche  Inhalt  des  Registers  gerettet  und  nach  dem  Test  wieder  zuriickgeschrieben! 

Zu  allem  UberfluB  werden  beim  Aufruf  der  XBIOS-Funktion  #22  (“Settime”)  und  auch  der 
GEMDOS-Funktionen#43  (“Tsetdate”)  und#45  (“Tsettime”)  zwardieZeit-  undDatumsregister 
im  Uhrenchip  korrekt  gesetzt,  aber  im  Modus-Register  wieder  das  Alarm-Bit  geloscht,  und 
ins  RESET-Register  wird  ein  Wert  von  $2  eingeschrieben.  Das  fiihrt  dann  dazu,  daB  der 
Alarm-Ausgang  shindig  im  1  Hz-  und  16  Hz-Takt  gegen  Masse  schaltet. 

Hat  man  nun  (wie  im  Schaltbild  angegeben)  beispielsweise  eine  Leuchtdiode  angeschlossen, 
so  flackert  diese  im  standigen  Takt.statt  nur  dann  zu  leuchten,  wenn  ein  Alarm  ausgelost  wird. 

AuBerdem  wird  bei  jedem  GEMDOS- Aufruf,  der  zum  Verlassen  eines  Programms  dient,  der 
Uhrenchip  ausgelesen.  Dazu  testet  aber  das  TOS  wieder  jedesmal,  ob  der  Uhrenchip  denn  vor¬ 
handen  ist,  was  dann  zu  dem  bereits  beschriebenen  Uberschreiben  der  Register  Alarmzeit  Mi- 
nuten-Einer  und  -Zehner  und  dem  Riicksetzen  des  Alarmbits  im  Modusregister  fiihrt. 
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Will  man  also  die  Alarm-Funktion  des  Uhrenchips  zumindest  bei  eingeschaltetem  Rechner 
benutzen  (z.  B.  als  Weckfunktion  durch  Aufleuchten  der  Leuchtdiode.  Stattder  Leuchtdiode 
laBt  sich  aber  auch,  wie  in  Abbildung  K.  1  bereits  angedeutet,  eine  Treiberschaltung  ansteuem, 
iiber  die  ein  Relais  geschaltet  wird,  das  dann  z.  B .  einen  Netzverbraucher  einschaltet. ),  so  sollte 
man  zum  Stellen  von  Uhrzeit/Datum  nicht  die  XBIOS- bzw.  GEMDOS-Funktion  benutzen, 
sondem  eigene  Routinen  verwenden,  welche  die  Alarmfunktion  des  Uhrenchips  unterstiitzen 
und  nicht  unterdriicken! 

Eine  MoglichkeitfiiremeeingeschrankteNutzung  der  Alarmfunktion  bestehtdarin,GEMDOS- 
Aufmfe,  die  zueiner  Veranderung  der  Alarmregister  fiihren,  abzufangen.  Dazu  muB  man  den 
Vektor,  der  auf  den  GEMDOS-Dispatcher  im  ROM  zeigt,  auf  eine  eigene  Routine  umleiten. 
Diese  testet  bei  jedem  GEMDOS-Aufruf,  ob  Alarmregister  zerstort  werden  konnten.  Ware  das 
der  Fall,  liest  man  sich  den  gegenwartigen  Stand  der  Alarmregister  aus  und  speichert  diesen 
zwischen.  AnschlieBend  kann  man  den  GEMDOS-Aufruf  ausfiihren,  der  die  Alarmdaten  im 
Uhrenchip  zerstort,  und  restauriert  nach  diesem  GEMDOS-Aufruf  wieder  die  Alarmregister 
mit  den  zwischengespeicherten  Werten. 


Anhang  L:  Der  Coprozessor  MC68881 
im  MEGA  ST(E) 
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Im  MEGA  ST  ist  iiber  den  MEGABUS-AnschluB  eine  Karte  mit  einem  1 6  MHz-Coprozessor 
des  Typs  MC6888 1  nachriistbar.  Beim  MEGA  STE  dagegen  ist  dieser  Coprozessor  im  Plati- 
nenlayout  bereits  vorgesehen  und  teil  weise  direkt  mit  eingebaut.  Daaber  in  beiden  Rechnertypen 
weiterhin  eine  MC68000er-CPU  zum  Einsatz  kommt,  muB  das  Kommunikationsprotokoll 
zwischen  CPU  und  Coprozessor  per  Software  nachgebildet  werden.  Erst  die  Prozessoren 
68020/68030  beherrschen  dieses  Protokoll  selbst.  Siehe  dazu  auch  die  Erlauterungen  im  Kapi- 
tel  “Damit’s  noch  schneller  geht  -  der  Coprozessor  MC68882". 

Beim  MC68000  wird  dagegen  bei  Erkennen  eines  Coprozessor-Befebls  ein  sogenannter  Line- 
F-Trap  ausgelost,  weil  das  hochstwertige  Nibble  des  ersten  Coprozessor-Befehlsworts  $F  lau- 
tet. 

DainfriiherenTOS-VersionenderLine-F-Trapvon  ATARI  fiirbestimmteBetriebssystemcalls 
verwendet  wurde,  ist  es  beim  Einsatz  eines  Coprozessors  evtl.  erforderlich,  diesen  Trap  abzu- 
fangen  und  Coprozessorbefehle  entsprechend  demnachfolgend  naher  erlauterten  Kommunika¬ 
tionsprotokoll  an  die  FPU  weiterzuleiten  (wie  so  ein  Treiber  in  der  Praxis  aussehen  konnte, 
war  mal  in  der  c’t  4/90,  “Schneller  rechnen”,  beschrieben.)  Fiirdie  MC68000-CPU  erscheint 
der  Coprozessor  wie  ein  Peripheriebaustein,  der  bestimmte  Register  besitzt  und  dariiber  ange- 
sprochen  wird. 


Die  Coprozessor  Interface  Register  (CIR) 

Fiir  den  Austausch  von  Signalen  und  Daten  zwischen  CPU  und  Coprozessor  sind  eine  ganze 
Zahl  von  intemen  Registem  in  der  FPU  vorgesehen.  Das  Registermodell  dieser  Coprozessor 
Interface  Register  (CIR)  stellt  sich  fiir  den  Programmierer  wie  folgt  dar: 


Adresse: 


$FF  FA40 

Response 

(READ) 

$FF  FA42 

Control 

(WRITE) 

Save 


WORD-Zugriffe 


SFFFA44 


(READ) 
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Adresse: 


$FF  FA46 

Restore  (RAV) 

$FF  FA48 

Operation  Word  (*) 

WORD-Zugriffe 

$FF  FA4A 

Command  (WRITE) 

$FF  FA4C 

(Reserved)  (*) 

$FF  FA4E 

Condition  (WRITE) 

$FF  FA50 

Operand 

(RAV) 

$FF  FA54 

Register  Select  (R) 

WORD-Zugriffe 

SFFFA56 

(Reserved)  (*) 

$FF  FA58 

Instruction  Address 

(WRITE) 

$FFFA5C 

Operand  Address  (*) 

LONG 


LONG 

LONG 


Die  mit  (*)  versehenen  Register  haben  (noch)  keine  Funktion. 


Uber  das  Response-Register  erfahrt  die  CPU  durch  Auslesen,  wie  weit  die  FPU  mit  der 
Abarbeitung  von  einem  Coprozessor-Befehl  gekommen  ist  bzw.  was  die  FPU  von  der  CPU 
als  nachstes  erwartet.  Es  miissen  ja  evtl,  noch  Operanden  in  die  FPU  gebracht  oder  auch  von 
dort  abgeholt  werden.  AuBerdem  werden  iiber  dieses  Register  Informationen  iiber  an  den 
Coprozessor  gestellte  Bedingungsabfragen  (“wahr”  oder  “falsch”)  ausgetauscht. 

Die  CPU  muB  also  bei  der  Emulation  des  Protokolls  mit  dem  Coprozessor  dieses  Register  aus¬ 
lesen  und  nach  Auswertung  entsprechend  darauf  reagieren. 

Die  im  Response-Register  iibergebenen  16  Bit-Words  werden  auch  als  sogenannte  Response 
Primitives  bezeichnet.  Die  FPU  beginnt  mit  der  Ausfiihrung  eines  neuen  Befehls  immer  erst 
nach  dem  erstmaligen  Auslesen  des  Response-Registers! 

Ein  Schreibzugriff  auf  das  Control-Register  (egal  mit  welchem  Wert!)  bewirkt  beim  MC 
68881  einen  Abbruch  aller  FPU-Operationen!  Der  MC68881  ist  damit  bereit  fur  eine  neue 
Operation.  Das  Ziel-FP-Datenregister  einer  so  unterbrochenen  Operation  ist  unbestimmt! 
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Die  Save-  und  Restore-Register  wird  man  im  ST(E)  wahrscheinlich  selten  gebrauchen,  da  sie 
fur  das  Sichem  und  Wiederherstellen  des  Coprozessor-intemen  Zustands  z.  B.  wegen  eines 
Taskwechsels  verwendet  werden  konnen.  Deshalb  soli  hier  nicht  weiter  darauf  eingegangen 
werden. 

Was  die  FPU  eigentlich  tun  soil,  erfahrt  sie  in  der  Regel  fiber  das  Command- Register!  Durch 
einen  Schreibzugriff  wird  der  “normale”  Dialog  zwischen  CPU  und  Coprozessor  gestartet. 
Hier  “landet”  das  zweite  Befehlsword  eines  “normalen”  Coprozessor-Befehls. 

Das  Condition- Register  wird  verwendet,  wenn  eine  Bedingungsabfrage  ausgeffihrt  werden 
soli.  Dabei  landet  dann  das  zweite  Coprozessor-Befehlsword  (mit  den  Bedingungsabfrage- 
Bits)  in  diesem  Register!  Ob  die  Bedingung  erfullt  wurde  oder  nicht,  teilt  der  Coprozessor  dann 
fiber  das  Response-Register  mit. 

Das  Operand-Register  kann  beschrieben  und  gelesen  werden.  Es  dient  dem  Transfer  von 
Daten  zwischen  CPU  und  FPU.  Die  Breite  betragt  zwar  32  Bit,  aber  es  konnen  naturlich  auch 
Operanden  in  Byte-  oder  Word-Grofie  ubergeben  werden.  Wichtig  dabei  ist,  dab  alle  Operan- 
den  in  diesem  Register  immer  “linksbundig”  ubergeben  werden.  D.  h.  beispielsweise,  daB 
Byte-  Operanden  in  den  Bits  24.. 31  des  Registers  ubergeben  werden! 

Wenn  mehrere  FP-Datenregister  mit  dem  FMOVEM-Befehl  transportiert  werden  sollen,  so 
muB  die  FPU  der  CPU  naturlich  irgendwie  mitteilen  konnen,  welche  und  wie  viele  FP-Register 
dies  sind.  Dazu  werden  die  oberen  acht  Bits  des  Register  select- Registers  benutzt.  Sie  ent- 
halten  die  Registermaske.  Ein  gesetztes  Bit  signalisiert  jeweils  ein  zu  transferierendes  FP-Re- 
gister.  Dabei  kommt  es  gar  nicht  mal  auf  die  Reihenfolge  der  gesetzten  Bits  an,  sondem  viel- 
mehr  auf  die  Anzahl !  So  weiB  die  CPU  dann,  wie  viele  Registerinhalte  bewegt  werden  miissen 
(jedes  FP-Datenregister  benotigt  12  Bytes  Platz!). 

Das  Instruction  Address- Register  kann  bei  der  Programmierung  eines  MC6888 1  auBer  acht 
gelassen  werden.  Hier  wird  dem  Coprozessor  bei  Bedarf  (nur  beim  MC68882  mit  seiner 
parallelen  Betriebsweise  fur  verschiedene  Befehle)  der  augenblickliche  Wert  des  CPU- 
Programmzahlers  ubergeben.  Der  MC68882  verlangt  das  immer  dann,  wenn  eine  Exception 
durch  einen  FPU-Befehl  ausgelost  werden  konnte.  Damit  hat  ein  Trap-Handler  ffir  FPU- 
Exceptions  dann  spater  die  Moglichkeit,  den  Befehl,  bei  der  die  Exception  auftrat,  festzustel- 
len  und  dort  wieder  aufzusetzen. 


Das  ProtokoU 


Die  Kommunikation  mit  dem  Coprozessor  muB  iiblicherweise  nach  dem  folgenden  Schema 
ablaufen: 
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1.  Die  CPU  trifft  auf  einen  Coprozessor(=  Line-F)-Befehl  und  lost  eine  Ausnahmeverar- 
beitung  aus.  In  dieser  Ausnahmeverarbeitungsroutine  muB  dann  das  entsprechende  CIR 
mit  befehlsspezifischen  Informationen  geladen  werden. 

Bei  “normalen”  Befehlen  wird  das  Command-Register  mit  dem  zweiten  Coprozessor- 
Befehlswort  geladen  und  so  der  Dialog  CPU  <->  FPU  gestartet. 

Bedingungsanfragen  an  die  FPU  werden  durch  Einschreiben  des  zweiten  Befehlsworts 
in  das  Condition-Register  gestartet. 

2.  Durch  Auslesen  des  Response-Registers  erfahrt  die  CPU  liber  die  Response  primitives, 
ob  die  FPU  noch  mehr  Daten  benotigt.  Folgende  Moglichkeiten  ergeben  sich: 

-  Die  FPU  ist  “beschaftigt”!  Also  kann  sich  die  CPU  erstmal  um  evtl.  aufgelaufene 
Interrupts  usw.  ktimmem.  Nach  “getaner  Arbeit”  wird  dann  wieder  im  Response- 
Register  der  Stand  der  Dinge  gepriift. 

-  Es  liegt  eine  Exception-Bedingung  von  seiten  der  FPU  vor.  Der  entsprechende 
Exception-Vektor  geht  aus  der  Response  primitive  hervor.  Die  CPU  kann  die 
Ausnahmeverarbeitung  einleiten. 

-  Die  FPU  mochte  etwas  durch  die  CPU  erledigt  haben  (AdreBberechnung  fiir  zu 
transportierende  Daten  und  die  Durchftihrung  des  Transports  durch  die  CPU. 
AuBerdem  kann  die  FPU  signalisieren,  daB  die  CPU  nach  “getaner  Arbeit”  wieder 
im  Response-Register  nachschaut.). 

Die  FPU  ist  mit  allem  versorgt  und  signalisiert  der  CPU,  daB  sie  sich  mit  “ihrem 
eigenen  Kram”  beschaftigen  soli. 

Die  Durchfuhrung  des  Protokolls  hangt  natiirlich  von  den  im  ersten  Coprozessor-Befehlswort 
enthaltenen  Daten  ab.  Weitere  wichtige  Informationen  sind  dem  zweiten  Befehlswort  zu  ent- 
nehmen.  Deshalb  soil  hier  kurz  auf  deren  Struktur  eingegangen  werden. 


Das  erste  Coprozessor-Befehlswort 

hat  folgenden  Aufbau: 


15 

0 

1 

1 

1 

1 

Cp- ID 

i r  i 

i  i 

TYP  , 

1 - 1  1  1 - S - 

k  Abhangigi  vom  Typ 

Durch  das  Cp-ID-Feld  konnen  max.  acht  Coprozessoren  angesprochen  werden. 
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StandardmaBig  verwendet  Motorola  in  seinem  Assembler  jedoch  nur  die  Cp-ID  =  001bj[i.  Im 
Typ-Feld  ist  kodiert,  um  welche  Art  Coprozessor-Befehl  es  sich  handelt: 


Typ 

Bedeutung 

000 

Normaler  Befehl  (Rechenoperation  oder  Datentransport-Befehl) 

00  1 

FDBcc,  FScc,  FTRAPcc 

0  1  0 

FBcc.W 

0  1  1 

FBcc.L 

100 

FSAVE  (intemen  FPU-Zustand  sichem) 

101 

FRESTORE  (intemen  FPU-Status  wiederherstellen) 

1  1  0 

(Reserved) 

1 1 1 

(Reserved) 

Die  Bedeutung  der  Bits  0..5  ist  vom  Befehlstyp  abhangig.  Bei  normalen  Befehlen  bestimmen 
die  Bits  3..5  (Modus-Bits)  den  Adressierungsmodus,  und  in  Bit  0..2  (Register-Bits)  stebt  dann 
die  Register-Nummer  der  CPU  (wenn  denn  ein  Register  beteiligt  ist). 


1 15  0 


I1 

1 

1 

1 

1  1 

Cp-ID 

_ i _ i _ 

f  i — 

_Typ  i 

1  i 

Modus 

— i — i — 

Register 
- 1 - 1 _ 

Adressierungs¬ 

modus 

Mode 

Bits 

Register- 

Bits 

Dn 

Reg.-Nummer  des  Datenreg.  der  CPU 

An 

Reg.-Nummer  des  AdreBreg.  der  CPU 

(An) 

010 

Reg.-Nummer  des  AdreBreg.  der  CPU 

(An)+ 

01  1 

Reg.-Nummer  des  AdreBreg.  der  CPU 

-<An) 

100 

Reg.-Nummer  des  AdreBreg.  der  CPU 

(dl6,An) 

101 

Reg.-Nummer  des  AdreBreg.  der  CPU 

(dg,An,Xn) 

1  1  0 

Reg.-Nummer  des  AdreBreg.  der  CPU 

(bd,An,Xn) 

1  1  0 

Reg.-Nummer  des  AdreBreg.  der  CPU  (*) 

([bd,An,Xn],od) 

1  10 

Reg.-Nummer  des  AdreBreg.  der  CPU  (*) 

([bd,An],Xn,od) 

1  10 

Reg.-Nummer  des  AdreBreg.  der  CPU  (*) 

(xxx).W 

1 1 1 

000 

(xxx).L 

1 1 1 

001 

#<data> 

1 1 1 

100 

(d16>PC) 

1 1 1 

0  10 

(d8,PC,Xn) 

1 1 1 

0  l  1 
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Adressierungs- 

Mode 

Register- 

modus 

Bits 

Bits 

(bd,PC,Xn) 

1  1  1 

0  1  1  (*) 

([bd,PC,Xn],od) 

1  1  1 

0  1  1  (*) 

([bd,PC],Xn,od) 

1  1  1 

0  1  1  (*) 

(*)=  Adressierungsart  existiert  beim  MC68000/68010  nicht! 


Der  Aufbau  des  zweiten  Coprozessor-Befehlsworts 

Das  Command-Word  hat  bei  alien  arithmetischen  Befehlen  und  den  Datentransportbefehlen 
(auBer  FSINCOS,  FMOVECR,  FMOVE  from  FPcr  und  FMOVEM)  den  folgenden  Aufbau: 


15  0 


0 

R/M 

0 

- 1 - i - 

Source 

_ 1 _ 1 _ 

1  1 

Dest . -Reg . 

_ i - 1 - 

— i  i  i  i — i — i — 

Befehlsnummer 

_ i _ i _ i _ i _ i _ i _ 

Folgende  Zuordnung  gilt,  wenn  das  R/M-Bit  gesetzt  ist: 


Source- 
bits  (*) 

Bedeutung 

000 

Datenformat  ist  LONG 

00  1 

Datenformat  ist  Single  Real 

010 

Datenformat  ist  Extended  Real 

01  1 

Datenformat  ist  Packed  Decimal 

100 

Datenformat  ist  WORD 

1  0  1 

Datenformat  ist  Double  Real 

1  10 

Datenformat  ist  BYTE 

(*)=  Nur  beim  Befehl  “FMOVE  from  FPn”  verwendet! 

Wenn  das  R/M-Bit  allerdings  geloscht  ist,  wird  in  den  Sourcebits  die  Nununer  des  Floatingpoint- 
Registers  (FPn)  angegeben,  welches  als  Quelle  benutzt  wird. 

Die  drei  Dest.-Reg-Bits  geben  die  Nummer  des  Floating-Point-Registers  an,  welches  als  Ziel 
verwendet  werden  soil.  In  der  Befehlsnummer  ist  die  Nummer  des  jeweiligen  Befehls 
enthalten. 
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(Die  Befehle  sind  im  Kapitel  “Damit’s  noch  schneller  geht  -  Der  Coprozessor  MC68882"  von 
ihrer  Funktion  her  kurz  beschrieben!): 


Befehls¬ 

nummer 

Befehlsmnemonic 

Befehls¬ 

nummer 

Befehlsmnemonic 

0 

FMOVE  to  FPn 

$18 

FABS 

1 

FINT 

$19 

FCOSH 

2 

FSINH 

$1A 

FNEG 

3 

FINTRZ 

$1C 

FACOS 

4 

FSQRT 

$1D 

FCOS 

6 

FLOGNP1 

$1E 

FGETEXP 

8 

FETOXM1 

$1F 

FGETMAN 

9 

FTANH 

$20 

FDTV 

$A 

FATAN 

$21 

FMOD 

$C 

FASIN 

$22 

FADD 

$D 

FATANH 

$23 

FMUL 

$E 

FSIN 

$24 

FSGLDIV 

$F 

FTAN 

$25 

FREM 

$10 

FETOX 

$26 

FSCALE 

$11 

FTWOTOX 

$27 

FSGLMUL 

$12 

FTENTOX 

$28 

FSUB 

$14 

FLOGN 

$38 

FCMP 

$15 

FLOG  10 

$3A 

FTST 

$16 

FLOG2 

Der  Befehl  FSINCOS  berechnet  ja  zugleich  Sinus  und  Kosinus  einer  Zahl.  Er  hat  als 
Befehlsnummer  den  Wert  von  $3X.  Dabei  mu8  fiir  X  die  Nummer  des  zweiten  FP-Ziel- 
registers  angegeben  werden,  wo  dann  der  Wert  des  berechneten  Kosinus  landed 

Mit  dem  FMOVECR- Befehl  kann  man  haufxg  benotigte  Konstanten  (Pi,  e  usw.)  aus  einem 
Konstanten-ROM  der  FPU  holen.  Der  Wert  fiir  den  Offset  in  dieses  ROM  wird  dazu  in  den 
unteren  sieben  Bits  des  Command-Words  eingetragen. 


15 


1 - 1  I  I  I  I  1 

ROM-Offset 


1 

0 

1 

1 

1 

- 1 - 1 - 

Dest.-Reg. 

Eine  Liste  dieser  Konstanten  mit  Offset- Werten  ist  ebenfalls  in  dem  Kapitel  “Damit’s  noch 
schneller  geht  -  Der  Coprozessor  MC68882"  enthalten. 
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Die  Dest, -Reg. -Bits  miissen  mit  der  entsprechenden  Nummer  des  Ziel-FP-Registers  geladen 
werden. 

Mit  FMOVEfrom  FPn  wird  ein  FP-Register  ausgelesen  und  an  einer  Zieladresse  (darf  auch 
ein  CPU-Register  sein,  wenn  die  Operandenlange  Byte,  Word  oder  Long  ist!)  abgelegt. 


15  0 


0 

1 

1 

T  1 

Dest .-Form. 

: _ 1 _ 1 _ 

T  1 

Source-Reg. 

_ i _ i _ 

i  r~  r  i  i 

k-Faktor 

_ i _ i _ i _ i _ i _ i _ 

In  den  Source -Reg. -Bits  ist  die  Nummer  des  Quell-FP-Registers  anzugeben. 

Bei  k-Faktor  ist  eine  Formatangabe  zu  machen,  wenn  das  Ergebnis  im  Packed  Decimal-For¬ 
mat  erstellt  werden  soli  (Naheres  zuni  k-Faktor  im  Kapitel  “Damit ’s  noch  schneller  geht  -  Der 
Coprozessor  MC68882"). 

Die  Angabe  muB  im  Zweierkomplement  erfolgen. 

Wenn  mit  dynamischem  k-Faktor  gearbeitet  wird  (der  k-Faktor  steht  dann  in  einem  Datenreg. 
der  CPU),  so  ist  in  den  Bits  4..6  die  Nummer  des  CPU-Datenregisters  anzugeben  (Bits  0..3 
bleiben  dann  geloscht!). 

Die  Dest.-Form.-Bits  sind  nach  der  folgenden  Tabelle  kodiert: 


Dest.- 

Format 

Bedeutung 

000 

Datenformat  ist  LONG 

00  1 

Datenformat  ist  Single  Real 

010 

Datenformat  ist  Extended  Real 

0  1  1 

Datenformat  ist  Packed  Decimal  (statischer  k-Faktor) 

100 

Datenformat  ist  WORD 

101 

Datenformat  ist  Double  Real 

1  1  0 

Datenformat  ist  BYTE 

1 1 1 

Datenformat  ist  Packed  Decimal  (dynamischer  k-Faktor) 

Mit  FMOVE  FPcr  wird  auf  die  Control-Register  der  FPU  zugegriffen.  Das  Command-Word 
dazu  sieht  folgendermafien  aus: 
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15 


- r - 1 

Register 


DR 


0  0  0  0  0  0  0 


0  01=  FPIAR  (FP-Instruction  Address  Register) 
0  10  =  FPSR  (FP-Status  Register) 

10  0  =  FPCR  (FP  Control  Register) 

Direction  (0  =  Move  nach  FPcr) 

(1  =  Move  aus  FPcr) 


Mehrere  Control-Register  der  FPU  werden  mit  dem  FMOVEM  FPcr  bewegt. 

|  15  |  0 


1 


0  DR 


t - r 


Register 

_ i _ i _ 


0 

0 

0 

0 

0 

- 1 

0 

0 

0 

0 

I —  0  0  0  =  (Reserviert) 


0  01=  FPIAR 
010  =  FPSR 

011=  FPSR,  dann  FPIAR 

10  0  =  FPCR  (FP  Control  Register) 

101=  FPCR,  dann  FPIAR 

110  =  FPCR,  dann  FPSR 

111=  FPCR,  dann  FPSR,  dann  FPIAR 

Direction  (0  =  Move  nach  FPcr) 

(1  =  Move  aus  FPcr) 


Mehrere  FP-Datercregisterinhalte  konnen  ebenfalls  mit  einem  FMOVEM  FPn-Befehl  trans- 
portiert  werden. 

1 15  |0 


1 

0 

DR 

- 1 - 

Modus 

_ i _ 

0 

0 

0 

i  r  i  i  i  i  i 

Liste  der  zu  transp.  Register 

—  1  =  Statische  Registerliste 

0  =  Dynamische  Registerliste 

—  1  =  (An)+ 

0  =  -{An) 

—  Direction  (0  =  Move  nach  FPcr) 

(1  =  Move  aus  FPcr) 
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Die  Modus-Bits  legen  den  Adressierungsmodus  fest  und  wie  die  Liste  der  Register  vorliegt. 

Statische  Liste  Die  untersten  achtBits  stelleneine  Auswahlmaske  fiir  die  zu  transportie- 

renden  Register  dar.  Wenn  ein  Register  bewegt  werden  soil,  ist  das  ent- 
sprechende  Bit  gesetzt,  sonst  geloscht! 

Aufbau  der  Liste: 


Bitnummer 

Adr.-Art 

7 

6 

5 

4 

3 

2 

1 

0 

-(An) 

FP7 

FP6 

FP5 

FP4 

FP3 

FP2 

FP1 

FPO 

(An)+ 

FPO 

FP1 

FP2 

FP3 

FP4 

FP5 

FP6 

FP7 

Dynamische  Liste  Die  FP-Register- Auswahlmaske  steht  in  einem  CPU-Datenregister.  Die 
Nummer  des  CPU-Datenregisters  ist  in  den  Bits  4..6  des  Command- 
Words  eingetragen.  Der  Listenaufbau  ist  der  gleiche  wie  bei  der  stati- 
schen  Liste,  nur  daB  eben  die  acht  untersten  Bits  des  CPU -Datenregisters 
diese  Maske  enthalten  miissen! 

Nun  zu  den  “nicht  normalen”  Coprozessor-Befehlen.  FPU-Anweisungen,  die  FPU-Be- 
dingungscodes  auswerten,  wie  FScc,  FDBcc,  FTRAPcc  und  FBcc  enthalten  ja  schon  im  er- 
sten  Coprozessor-Befehlswort  (das  mit  $F..  beginnt!)  eine  andere  Typkennung.  Damit  wer¬ 
den  sie  von  den  “normalen  Befehlen”  abgegrenzt. 

Der  Aufbau  dieser  Befehle  ist  wegen  der  unterschiedlichen  Benutzung  der  unteren  sechs  Bits 
des  ersten  Coprozessor-Befehlsworts  deshalb  nochmal  komplett  mit  alien  erforderlichen 
Befehlsworten  angegeben. 

FSeoBefehl  ($FF  ->  Reg./Speicherstelle,  wenn  Bedingung  erfiillt) 


1 15  |0 


1 

1 

1 

1 

- r —  r — - 

CP -ID 

0 

0 

1 

1  i  1  1 

Modus  Register 

0 

0 

0 

0 

0  0  0 

0 

0 

0 

~r  i  l  i 

Bedingungsabfrage 

Modus-  und  Register-Bits  haben  die  gleiche  Bedeutung,  wie  bereits  bei  der  Erlauterung  des 
ersten  Coprozessor-Befehlsworts  gezeigt.  Die  Bedingungsabfrage-Bits  enthalten  dabei  das 
Bitmuster,  mit  der  die  Abfrage  kodiert  ist. 
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Die  so  “formulierte”  Bedingung  ist  dann  von  der  FPU  auszuwerten  und  am  Ende  der  Bear- 
beitung  mit  “Ja”  oder  “Nein”  an  die  CPU  zu  beantworten. 

Die  Beantwortung  erfolgt  dann  iiber  ein  Bit  im  Response-Register. 


Bedingungs-Bits 

Mnemonic 

Bedeutung 

0 

0 

0 

0 

0 

0 

F 

Falsch 

0 

0 

0 

0 

0 

1 

EQ 

Gleich 

0 

0 

0 

0 

1 

0 

OGT 

GroBer 

0 

0 

0 

0 

1 

1 

OGE 

Gleich  oder  groBer 

0 

0 

0 

1 

0 

0 

OLT 

Kleiner 

0 

0 

0 

1 

0 

1 

OLE 

Kleiner  oder  gleich 

0 

0 

0 

1 

1 

0 

OGL 

GroBer  oder  kleiner 

0 

0 

0 

1 

1 

1 

OR 

GroBer,  kleiner  oder  gleich  (es  ist  kein  NAN!) 

0 

0 

1 

0 

0 

0 

UN 

(Die  gleichen  Bedingungsbits  wie  vorher, 

0 

0 

1 

0 

0 

1 

UEQ 

nur  daB  hiermit  gepriift  wird,  ob 

0 

0 

1 

0 

1 

1 

UGT 

eine  nicht  zulassige  Zahl  (NAN) 

0 

0 

1 

1 

0 

0 

UGE 

entstanden  ist  bzw.  bei  der  letzten 

0 

0 

1 

1 

0 

1 

ULE 

Verkntipfung  mit  “im  Spiel  war”!) 

0 

0 

1 

1 

1 

0 

NE 

»♦  *1  99 

0 

0 

1 

1 

1 

1 

T 

99  99  99  99  99 

0 

1 

0 

0 

0 

0 

SF 

In  diesem  Teil  der  Tabelle  werden  die 

0 

1 

0 

0 

0 

1 

SEQ 

gleichen  Bedingungsabfragen  wie  vorher 

0 

1 

0 

0 

1 

0 

GT 

nochmals  mit  ihren  (aber  anderen)  Mnemonics 

0 

1 

0 

0 

1 

1 

GE 

aufgefiihrt. 

0 

1 

0 

1 

0 

0 

LT 

0 

1 

0 

1 

0 

1 

LE 

Durch  das  gesetzte  Bit  4  wird  der 

0 

1 

0 

1 

1 

0 

GL 

FPU  bei  solchen  Bedingungsabfragen 

0 

1 

0 

1 

1 

1 

GLE 

signalisiert,  daB  eine  Exception 

0 

1 

1 

0 

0 

0 

NGLE 

ausgelost  werden  soli,  wenn  bei 

0 

1 

1 

0 

0 

1 

NGL 

der  Bedingungsabfrage  ein  NAN 

0 

1 

1 

0 

1 

0 

NLE 

mit  “im  Spiel  war”! 

0 

1 

1 

0 

1 

1 

NLT 

(Das  BSUN-Bit  im  EXC-Byte  des  FPSR 

0 

1 

1 

1 

0 

0 

NGE 

wird  dann  gesetzt!) 

0 

1 

1 

1 

0 

1 

NGT 

0 

1 

1 

1 

1 

0 

SNE 

0 

1 

1 

1 

1 

1 

ST 
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FDBcc-Befehl 

Syntax:  FDBcc  Dn,<label> 

Funktion:  IF  Bedingung  cc  wahr,  THEN  No  operation 

ELSE  Dn  :=  Dn  -  1; 

IF  Dn  <>  -1,  THEN  go  to  <label> 


15  |  0 


B 

B 

B 

B 

B 

0 

0 

i 

n  i 

0  0  1 

i  i 

0 

0 

0 

0 

0 

0 

0 

0 

° 

0 

1  1 

Bedingung; 

i  i 

r  i  i 
sabfrage 

_ 1 

1 _ 

1 _ 1 

l  l 

16-B 

i _ i 

i 

it-Spn 

mgdist 

:anzw( 
1 _ ! 

ert 

1  1  1 

I _ i _ I _ l 

i _ l _ i _ 

Bei  Reg.-Dn  ist  die  Nummer  des  CPU-Datenregisters  einzutragen,  welches  dekrementiert 
wird,  wenn  die  Bedingung  nicht  erfiillt  ist.  'Die.Bedingungsabfrage-Bits  sind  wie  in  der  Tabelle 
zuvor  zu  setzen. 

Das  dritte  Coprozessor-Befehlswordenthaltdann  den  Sprungdistanzwert  im  Zweierkomple- 
ment. 

FTRAPcc- Befehl 

Syntax:  FTRAPcc.  W  #<data> 

FTRAPcc . L  #<data> 

Funktion:  Wenn  die  Bedingung  cc  erfullt  ist,  wird  ein  Trap  ausgelost  und  der  evtl .  folgen- 

de  Operand  dera  Traphandler  iibergeben. 


I15  |  0 


1 

1 

i 

i 

CP- 

ID 

0 

0 

i 

1  | - 

111  Modus 

i  i 

0 

0 

0 

0 

0 

0 

16- 

_ 

Bit- 

_ 

Operc 

nd  o 

der  t 

_ 

loher 

_ 

werti 

_ 

ges 

_ 

/ford  1 

l  i  I  1  l 

)ei  32-Bit~Operand 

_ i _ i  i  i  i 

1  I  i  i  i  i  i  i  i  i  l  i  1  i - 1 

niederwertiges  Word  bei  32-Bit-Operand  (wenn  erforderlich) 

iii  iii  i  ii  i  i  i  i  i  i 
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Modus:  010  Operand  ist  16  Bits  lang 

Oil  Operand  ist  32  Bits  lang 
10  0  Es  folgt  kein  Operand! 


FZfcc-Befehl 

Syntax:  FBcc .  w  <label> 

FBcc.L  <label> 

Funktion:  Wenn  die  Bedingung  cc  erfiillt  ist,  wird  zum  <label>  verzweigt. 


15  I  0 


I 

D 

D 

mmm 

0 

BBI 

16- 

_ 

■ 

f  1  1  1 1 1 

ord  bei  32-Bit-Distanz 
i  i _  j _ i _ i _ i _ i _ 

I  I  1  1  1  1  I  1  1  1  |  1  1  !  1 

niederwertig.  Word  bei  32-Bit -Sprungdistanzwert  (wenn  erforderlich) 
_ 1 _ 1 _ 1 _ 1 _ J _ L _ _  1 _ _ J _ l _ l _ _ _ 1 _ 1 _ 1 _ 1 _ 1 _ 

Sz  0=16  Bit-Sprungdistanzwert 
1  —  32  Bit-Sprungdistanzwert 

Der  Sprungdistanzwert  ist  im  Zweierkomplement  anzugeben! 


FAOP-Befehl 

Syntax:  FNOP 

Funktion:  No  Operation! 


15 

0 

1 

1 

1 

1 

! 

[  1 
CP-IE 

1 

0 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

Es  folgen  die  Spezialbefehle  fiir  das  Sichem  und  Wiederherstellen  des  FPU-Zustandes  -  z.  B. 
wegen  eines  Taskwechsels  in  Multitasking-Anwendungen.  Sie  unterscheiden  sich  im  ersten 
Coprozessor-Befehlsword  nur  im  S/R-Bit.  Ein  zweites  Befehlsword  ist  nicht  erforderlich! 
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15  0 


1 

1 

1 

1 

- 1 - 1 - 

Cp- ID 

i  i 

1 

0 

S/R 

1  1 
Modus 

i  \ 

i  i 

Register 

0  =  FSAVE;  1  =  FRESTORE 


Modus-  und  Register-Bits  haben  die  gleiche  Bedeutung,  wie  schon  bei  den  “normalen” 
Befehlen  erlautert. 


Die  Coprozessor  Response  primitives 

Wie  ja  schon  weiter  oben  erwahnt,  kann  die  CPU  durch  Auslesen  des  Response-Registers 
feststellen,  wie  weit  die  FPU  ist  bzw.  was  diese  noch  z.  B.  an  Daten  benotigt.  Die  FPU  geht 
davon  aus,  da8  nach  dem  Auslesen  des  Response-Registers  der  entsprechende  Inhalt  von  der 
CPU  iibemommen  wurde  und  entsprechend  ausgewertet  wird!  Das  bedeutet,  daft  die  FPU 
schon  intern  weiterarbeiten  kann,  bis  sie  wieder  iiber  das  Response-Register  weitere  Service- 
Anfragen  an  die  CPU  signalisiert!  Diese  als  Response  primitives  bezeichneten  16-Bit-Worte 
sollen  nun  kurz  erlautert  werden. 


Null  primitive 

Diese  Response  primitive  wird  hauptsachlich  zur  Synchronisation  zwischen  CPU  und  FPU 
benutzt.  Daran  kann  die  CPU  namlich  erkennen,  ob  die  FPU  noch  beschaftigt  ist  oder  ob  spater 
nochmal  “nachgeschaut”  werden  soli! 


15  0 


CA 

PC 

0 

0 

0 

0 

0 

IA 

0 

0 

0 

0 

0 

0 

PF 

CA  Come  again-Bit.  Wenndas  Bit  gesetzt  ist,  bedeutet  das,  daB  die  CPU  nach  Erledigung 

der  angeforderten  Aufgaben  das  Response-Register  nochmals  auslesen  soli. 

PC  Pass-Program-Counter-Bit.  Ein  gesetztes  Bit  bedeutet:  Programmzahlerinhalt  soli 
sofort  der  FPU  irn  Instruction  Address-Register  iibergeben  werden.  Kann  beim  MC 
68881  ignoriert  werden. 

IA  Interrupts-Allowed-Bit.  Durch  ein  gesetztes  Bit  signalisiert  die  FPU,  daB  sich  die 
CPU  (bei  Bedarf)  um  anstehende  Interrupts  kiimmem  darf. 
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PF  Process-Finished-Bit.  Ein  gesetztes  Bit  meldet  der  CPU,  da(5  die  FPU  zu  neuen  Taten 

bereit  ist.  1st  das  Bit  geloscht,  so  ist  die  FPU  noch  mit  einer  Operation  beschaftigt. 

TF  True/Faise-Bit.  Das  Resultat  einer  Bedingungsanfrage  an  die  FPU  wird  hiermit 
signalisiert.  TF  =  0:  Bedingung  nicht  erfiillt!  TF  =  1:  Na,  raten  Sie  mal! 


Evaluate  effective  address  and  transfer  data  primitive 

Diese  Response  primitive  tritt  auf,  wenn  Daten  zwischen  FP-Daten-  Oder  -Control-Registem 
und  CPU-Registem  oder  Speicherbereichen  ausgetauscht  werden  sollen.  Die  CPU  hat  anhand 
der  Daten  in  dieser  Primitive  und  den  im  ersten  Coprozessor-Befehlswort  enthaltenen  Mode- 
und  Register-Bits  die  gewiinschte  “Effektive  Adresse”  zu  ermitteln  und  eine  entsprechende 
Anzahl  von  Bytes  (wie  viele,  steht  in  “Lange”!)  liber  das  Operanden-Register  zu  transportie- 
ren. 


15  I  0 


CA 

PC 

DR 

1 

0 

- 1 - ! - 

BA 

_ l _ l _ 

i  1  1  1  1  II 

Lange 

_ i _ i _ i _ i _ i _ i _ i _ 

Das  CA-  und  PC-Bit  haben  die  gleiche  Bedeutung,  wie  bei  der  Null  primitive  beschrieben. 

DR  Direction-Bit.  Bestimmt  die  Datentransportrichtung.  Ein  gesetztes  Bit  sagt  der  CPU, 

daB  aus  der  FPU  (iiber  das  Operanden-Register)  gelesen  werden  soli. 

EA  Kodierbits  fur  die  Klasse  der  Effektiven  Adresse.  Hiermit  gibt  die  FPU  die  Klasse 
der  effektiven  Adresse  an,  die  ermittelt  und  dann  zum  Datentransport  verwendet  wer¬ 
den  soil.  Die  genaue  Bestimmung,  ob  die  effektive  Adresse  ein  CPU-Register,  Spei- 
cher  oder  Konstante  ist,  wird  ja  durch  die  Mode-  und  Register-Bits  im  er¬ 
sten  Coprozessor-Befehlswort  vorgenommen.  Mit  den  EA-Bits  kann  nur  noch  mal 
gepruft  werden,  ob  die  vereinbarte  Adressierungsklasse  auch  mit  der  Kodierung  in 
den  Mode-  und  Register-Bits  iibereinstimmt.  Kann  ignoriert  werden.  Wer  sich  fur  die 
genaue  Zuordnung  von  Adressierungsklassen  zu  Adressierungsarten  interessiert,  sei 
auf  das  “MC6888 1/68882 Floating-Point  Coprozessor  User  ’  s  Manual”  von  Motorola 
verwiesen. 

Lange  Das  Langen-Feld  gibt  die  Anzahl  der  Bytes  an,  die  beim  Datentransport  iiber  das 
Operanden-Register  bewegt  werden  mtissen.  Mogliche  Werte  sind  1  (Byte),  2 
(Word),  4  (Long  oder  Single  Precision),  8  (2  FPCR  oder  Double  Precision)  oder  12 
(alle  3  FPCR,  Extended  Precision  oder  Packed  dezimal). 
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Transfer  single  main  processor  register  primitive 

Diese  Primitive  wird  verwendet,  urn  den  Inhalt  eines  CPU-Registers  zur  FPU  zu  iibertragen 
(iibergeben  wird  der  CPU-Registerinhalt  wieder  “linksbtindig”  iiber  das  Operand-Register der 
FPU!). 

Verwendung  frndet  diese  Primitive  bei  dem  Dialog  anlaBlich  eines  FMO  VEM  FPn-Befehls. 
Wenn  namlich  die  Liste  der  zu  iibertragenden  FP-Datenregister  als  dynamische  Liste  vorliegt 
(also  als  Bitmaske  in  einem  CPU-Datenregister!),  bekommt  die  CPU  hiermit  angezeigt,  wel¬ 
ches  CPU-Register  diese  Liste  enthalt.  Die  CPU  hat  dann  den  Registerinhalt  im  Operanden- 
register  zu  iibergeben. 

1 15  10 


CA 

PC 

DR 

0 

1 

1 

0 

0 

0 

0  1 

0 

0 

D/A 

Das  CA-  und  PC-Bit  haben  die  gleiche  Bedeutung,  wie  bei  der  Null  primitive  beschrieben. 
Das  DR-Bit  legt  wieder  die  Transportrichtung  fest  (1  =  FPU  =>  extern). 

D/A  Data-/Address-Register-Bit.  Ein  geloschtes  Bit  signalisiert,  daB  ein  CPU-Datenregister 

gemeint  ist.  Sonst  geht’s  um  ein  AdreBregister  (kommt  nicht  vor!). 

Regist.  Hiermit  wird  die  Registemummer  (0..7)  iibergeben. 


Transfer  multiple  coprocessor  registers  primitive 

Wird  benutzt  beim  Transfer  von  mehreren  FPU-Registern.  Die  Quelle  oder  das  Ziel  des 
Datentransports  (die  “effektive  Adresse”)  geht  ja  bereits  aus  den  Mode-  und  Register-Bits  im 
ersten  Coprozessor-Befehlswort  hervor.  Die  Liste  der  zu  transferierenden  Register  muB  die 
CPU  nach  Erkennen  dieser  Primitive  aus  dem  Register  select-Register  auslesen! 

Jedes  gesetzte  Bit  entspricht  dabei  einem  Transfer  von  in  “Lange”  angegebener  Menge  von 
Bytes! 


15  I  0 


CA 

PC 

DR 

0 

0 

0 

0 

1 

- ! - , - 1 - 1 - 1 - i - i - 

Lange 

iii  i  i  ii 

Das  CA-,  PC-  und  DR-Bit  haben  die  gleiche  Bedeutung,  wie  bereits  zuvor  beschrieben. 
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Lange  Operandenlange  in  Bytes. 

Auf  die  Response  primitives  fur  die  Exception-Bearbeitung  soil  hier  nicht  naher  eingegangen 
werden.  Wenn  der  Coprozessor  als  Peripheriebaustein  betrieben  wird  (im  ST(E)  der  Fall), 
kommen  diese  speziellen  Anwendungen  ohnehin  kaum  vor! 

Wer  aber  auch  das  bis  ins  Detail  wissen  will  (mu8),  sollte  auf  das  bereits  mehrmals  erwahnte 
MC6888 1/68882-Usermanual  zuriickgreifen. 
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Anhang  M: 

Kurziibersicht  iiber  die  Hardware-Register 


Beim  TT  finden  sich  die  Hardware-Register  zum  einen  im  ST-AdreBraum,  zum  anderen  am 
oberen  “Ende”  des  Speicherbereichs  (ab  Adresse  $FFFF  8000).  Angegeben  ist  jeweils  nur  die 
Adresse  im  ST-AdreBraum! 


Speicherkonfiguration 

Adresse  Zugriff  Bezeichnung  Label 


$FF  8001  R/W  Memory-Config.-Register  (Byte)  memconf 

- cccc 

Bank  1 

00 - -  64  KBit  Chips  (128  KByte/Bank) 

01 -  256  KBit  Chips  (512  KByte/Bank) 

10  -  1  MBit  Chips  (2  MByte/Bank) 

11  -  Reserviert 

BankO 

00  -  64  KBit  Chips  (128  KByte/Bank) 

01  - -  256  KBit  Chips  (512  KByte/Bank) 

10  - —  1  MBit  Chips  (2  MByte/Bank) 

11  - Reserviert 

Achtung!  Diese  Bitbelegung  gilt  nicht  beim  TT! 

Videocontroller 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8201 

R/W 

Video-Base-Reg.  High  (Byte) 

dbaseh 

$FF  8203 

R/W 

Video-Base-Reg.  Mid  (Byte) 

dbasel 

$FF  8205 

RC) 

Video-Adr.-Counter  High  (Byte) 

vcounthi 

$FF  8207 

R(*> 

Video-Adr.-Counter  Mid  (Byte) 

vcountmid 

$FF  8209 

R<*> 

Video-Adr.-Counter  Low  (Byte) 

vcountlow 

(*)  =  Beim  STE  ist  auch  Schreiben  moglich! 
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Adresse 


$FF  820A 


$FF  820C 


$FF  8240 


SFF  8242 
$FF  8244 
$FF  8246 
$FF  8248 
$FF  824A 
$FF  824C 
SFF  824E 
SFF  8250 
SFF  8252 
SFF  8254 
SFF  8256 
$FF  8258 
SFF  825A 
SFF  825C 
$FF  825E 


Zugriff  Bezeichnung 


Label 


R/W  Sync-Mode-Register  (Byte)  syncmode 

- V  S 

^ - Synchronisation  (0=  Intern,  1  ^Extern) 

(Beim  TT  genau  andersherum!!!) 

- Vertikalfrequenz  (0=60  Hz,  1=50  Hz) 

(Nicht  beim  TT!) 

R/W  Video-Base-Reg.  Low  (Byte)  dbaselow 

(Nur  bei  TT/STE-Maschinen!) 

R/W  - rRRR  gGGG  bBBB  Farbreg.  0  colorO 

-  0  =  Normal  Monochrom 

1  =  Invertiert  Monochrom 


R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  1 

colorl 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  2 

color2 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  3 

color3 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  4 

color4 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  5 

color5 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  6 

color6 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  7 

color7 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  8 

color8 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  9 

coIor9 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  10 

color  10 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  11 

colorl  1 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  12 

color  12 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  13 

colorl  3 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  14 

color  14 

R/W 

- rRRR 

gGGG  bBBB 

Farbreg.  15 

color  15 

R  =  Rot-Intensitat  (r  =  LSB  nur  bei  TT/STE) 
G  =  Griin-Intensitat  (g  =  LSB  nur  bei  TT/STE) 
B  =  Blau-Intensitat  (b  =  LSB  nur  bei  TT/STE) 
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Adresse  Zugriff  Bezeichnung 


Label 


$FF  8260  R/W 


$FF  8262  R/W 


$FF  827E  R/W 


ST-Shift-Mode-Register  (Byte)  shiftmd 

- ss 

Hor.-  x  Vert.-Auflosung 

0  0  -  320x200, 4  Planes  (16  Farben) 

0 1  -  640x200, 2  Planes  (4  Farben) 

1 0  -  640x400, 1  Plane  (Monochrom) 

1 1  -  Reserviert 


TT-Shift-Mode  Register  (Word)  shift_tt 

S — H-MMM - PPPP 

- ^ -  Reg.-Bank-Nr. 

fur  ST-Palette 
000  ST-Low  (320  x  200, 4  Planes) 

001  ST-Mid  (640  x  200, 2  Planes) 

010  ST-High  (640  x  400,  1  Plane) 

Oil  <Reserviert> 

100  TT-Mid  (640  x  480, 4  Planes) 

101  <Reserviert> 

110  TT-High  (1280  x  960, 1  Plane) 

111  TT-Low  (320  x  480,  8  Planes) 
- —  Hyper-Mono-Modus 

- - — —  Sample  &  Hold-Mode 

Register  existiert  nur  im  TT! 


STACY  Display-Steuerung 

- I,D-  (Byte) 


=1:  Display  Off 
=1:  Beleuchtung  Off 


stacydsp 


Register  existiert  nur  im  STACY  (STBOOK?) 
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TT-Farbpalettenregister 

Register  existieren  nur  beirn  TT! 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8400 

R/W 

- RRRrGGGgBBBb 

TT-Pal.  0 

TT_col0 

$FF  8402 

R/W 

- RRRrGGGgBBBb 

TT-Pal.  1 

TT_coll 

$FF  85FC 

R/W 

- RRRrGGGgBBBb 

TT-Pal.  254 

TT_col254 

$FF  85FE 

R/W 

- RRRrGGGgBBBb 

TT-Pal.  255 

TT_col255 

r,  g,  b  =  Least  Significant  Bits! 

DMA-Controller 

Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8604  R/W 


Oder 


$FF  8606  R 


Controller-Access-Register  disked 

(nur  wenn  DMA-Mode-Reg.,  Bit  4=0!) 

Sector-Counter-Register 

(nur  wenn  DMA-Mode-Reg.,  Bit  4=1 !) 

Word-Zugriff,  nur  Low-Byte  benutzt! 

DMA-Status-Register  (Word)  fifo 

- SSS  (Nur  Low-Byte  relevant!) 

—  0=  Fehler  bei  DMA-Op. 

- 0=  Sekt.  Count.  Reg.  =  0 

- 0=  DATA  REQ.  v.  FDC/ACSI  inaktiv 
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Adresse  Zugriff  Bezeichnung 


Label 


W 


$FF  8609  R/W 

$FF  860B  R/W 

$FF  860D  R/W 


DMA-Mode-Register  (Word)  fifo 

- cccccccc- 

|  ' -  CA1  (Achtung!  Cmd-Phase  fiir  AC- 

SI-Bus  oder  FDC-Reg.-Adressierg.) 
-  CA2 

-  1-  ACSI-,  0=  FDC-Zugriff 

- 1=  Sect.-Cnt.-Register 

0=  Contr.-Acc.-Register 

0 - Reserviert 

0 - —  Reserviert  (int.  Verwendung) 

-  I-  DMA  mit  FDC 

0=  DMA  rait  ACSI-Bus 
0=  DMA-Read 
1=  DMA-Write  an  Periph. 

DMA-Base+Count.-Reg.-High  (Byte)  dmahigh 

DMA-Base+Count.-Reg.-Mid  (Byte)  dmamid 

DMA-Base+Count.-Reg.-Low  (Byte)  dmalow 
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Floppy  Disk  Controller  WD1770/1772 


Abb.  M.l :  So  wird  ein  Track  im  Speicher  zusammengebaut  und  dann  mit  dem  Befehl  WRITE 
TRACK  aufDisk  geschrieben  ( Formatierung ) 


eden  Sektop 
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Abb.  M2:  Die  Kommandos  des  Floppy-Controllers  WD1772 
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Bit-Hr . 

Bedeutung 

7 

Zustand  des  'Motor  on'-Anschlusses  (*1'  =  Motor  on) 

£ 

Bei  READ  SECTOR  und  READ  TRACK  ohne  Funktion.  Bei  jeden 
WRITE— Befehl  wind  hiernit  ein  Sthreibschutz  angezeigt. 

5 

Typ  I-Konnandos:  Gesetzt  sobald  Motor-'Spin  up*  erfolgt  ist. 

C£  Indexpulse  nach  'Motor  on1 3 

Typ  II.  , 1 1 1-Konnandos :  ‘ 1 ' =  Sektor  wit  ■ De leted *  — Data  nark. 

*0'  =  Sektor  nit  'Ualid'-Data  nark. 

4 

Gesetztes  Bit  zeigt  an,  daB  gewunschter  Sektor,  Spur  Oder 
Seite  nicht  gefunden  wurde,  [Record  not  found) 

3 

Gesetzt  uenn  CRC“Error  f estgestellt  wurde. 

2 

Typ  I-Konnandoss  Zustand  des  'Track  BO ‘ -ftnschl up . 

11*  =  Kopf  iiber  Spur  88J 

Typ  II . . III-Konnandos i  Mird  *1*  uenn  die  CPU  CDMftJ  bein  Da- 

tentransfer  zu  lanysan  reagiert  hat. 
('Lost  Data'— Bit'l 

1 

Typ  I -Konnandos !  Zustand  des  Index- Anschl uft 

Typ  II. .III-Konnandos:  Zustand  des  DRQ-Ansc hluB . 

f'l'  =  Data  Register  nuB  'bedient' 
werden . J 

0 

' BUSY ' —Bit .  Ein  Konnando  ist  in  Bearbeitung. 

Abb.  M.3:  Die  Bedeutung  der  Bits  im  FDC-Status-Register 


SCSI-DMA  (Nur  TT!) 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8701 

R/W 

DMA-Address-Pointer  (Highest  Byte) 

tt_dmabas 

$FF  8703 

R/W 

DMA-Address-Pointer  (High  Byte) 

tt_dmabas+2 

$FF  8705 

R/W 

DMA-Address-Pointer  (Low  Byte) 

tt_dmabas+4 

$FF  8707 

R/W 

DMA-Address-Pointer  (Lowest  Byte) 

tt_dmabas+6 

$FF  8709 

R/W 

DMA-Bytezahler  (Highest  Byte) 

tt_dmacnt 

$FF  870B 

R/W 

DMA-Bytezahler  (High  Byte) 

tt_dmacnt+2 

$FF  870D 

R/W 

DMA-Bytezahler  (Low  Byte) 

tt_dmacnt+4 

$FF  870F 

R/W 

DMA-Bytezahler  (Lowest  Byte) 

tt_dmacnt+6 

$FF  8710 

R 

Restdatenregister  (High- Word) 

tt_dmarsd 

SFF8712 

R 

Restdatenregister  (Low-Word) 

tt_dmarsd+2 

$FF  8714 

R/W 

KontroIIregister  (Word) 

tt_dmactl 

•BC0000ED 


Richtung  (1=  WRITE) 
DMA-Enable  (1=  On) 
=1 :  Byte  Count  auf  0 
=1 :  Bus  Error  bei  DMA 
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SCSI-Controller  5380  (Nur  TT!) 

Adresse  Zugriff  Bezeichnung 


$FF  8781  R 
oder  W 

$FF  8783  W 


$FF  8783  R 


$FF  8785  R/W 


Akt.  Inhalt  des  SCSI-Datenbusses 


Ausgabedaten  fiir  SCSl-Datenbus 


Inltiator-Befehlsregister 


cccccccc 


(Byte) 

Assert  Data  to  Bus 
Assert  _ATN 
Assert  _SEL 
Assert  „BSY 
Assert  „ACK 
0 

Test  Modus 
Assert  RST 


Initiator-Befehlsregister 


CCCCCCCC 
L 


(Byte) 

Assert  Data  to  Bus 
Assert  _ATN 
Assert  _SEL 
Assert  _BSY 
Assert  „ACK 
Lost  Arbitration 
Arbitration  in  Progress 
Assert  RST 


Betriebsartenregister 


(Byte) 

Arbitrate  (=1 :  On) 
DMA-Mode  (=1:  On) 
Monitor  Busy 
Enable  End  of  Process-Int. 
Enable  Parity  Interrupt 
Enable  Parity  Check 
=1:  Targetmode 
=1:  Blockmode-DMA 


Label 

s_data 

s„data 

s_icr 


sjcr 


s_mode 
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Adresse  Zugriff  Bezeichnung 


Label 


$FF  8787  R/W 


$FF  8789  R 


W 


Target  Befehlsregister  s_tcr 

0000TTTT  (Byte) 

1  I _  Assert  .  .I/O 

L _  Assert  _C/D 

_  Assert  _MSG 

-  Assert  _REQ 


Busstatusregister 

ssssssss 


s  idstat 


(Byte) 

Zustand  Parity-Line 
Zustand  _SEL  (l^aktiviert) 
Zustand  _I/0 
Zustand  _C/D 
Zustand  MSG 
Zustand  _REQ  ” 

Zustand  JBSY  ” 

Zustand  RST  ” 


ID-Mask  f.  SELECTION-Phase 


s_idstat 


$FF  878B  R 


Statusregister 

SSSSSSSS 


(Byte) 

Zustand  _ACK  (I=aktiviert) 
Zustand  _ATN  “ 

1  -  Busy  Error 
1  =  Phase  match 
I  =  IRQ  aktiv 
I  =  Parity  Error 
1  =  DMA-Request  steht  an 
1  =  End  of  DMA 


s_dmastat 


W 

Start  DMA-Ausgabe 

s_dmastat 

$FF  878D 

R 

Eingabedaten  vont  SCSI-Bus 

s„targrcv 

W 

Start  Target-DMA-Eingabe 

s_targrcv 

$FF  878F 

R 

Reset  Interrupts  +  Parityfehler 

s_inircv 

W 

Start  Initiator-DMA-Eingabe 

s_inircv 

Anhang  M:  Kurziibersicht  iiber  die  Hardware-Register 
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Soundchip  AY-3-8910 

Adresse  Zugriff  Bezeichnung  Label 


$FF  8800  R 


Selektiertes  Reg.  auslesen 


giread 


W  Chip-Register  anwahlen 

- ssss 


giselect 


|  |  Reg. -Nr. 

0000  -  0 

00  01 -  1 

0010 -  2 

0011 -  3 

0100 -  4 

0101 -  5 

0110 -  6 


0111 -  7 


Bitbelegung  Registerfunktion 


PPPPPPPP  Per.-Dauer  Low  (A) 

. . .  .PPPP  Per.-Dauer  High  (A) 

PPPPPPPP  Per.-Dauer  Low  (B) 

. . .  .PPPP  Per.-Dauer  High  (B) 

PPPPPPPP  Per.-Dauer  Low  (C) 

....  PPPP  Per.-Dauer  High  (C) 

. .  .RRRKR  Per.-Dauer 

Rauschen 

PPRRRSSS  Mix-Ctrl. 

+I/0-Portsel. 

-  Sound  A  aus 

(0-Ein) 

- -  Sound  B  aus 

(0=Ein) 

-  Sound  C  aus 

(0=Ein) 

-  Rauschen  A  aus 

(0=Ein) 

-  Rauschen  B  aus 

(0-Ein) 

-  Rauschen  C  aus 

(0-Ein) 

-  PortAaufOUT 

(0=IN) 

' - Port  B  auf  OUT 

(0=IN) 
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Adresse  Zugriff  Bezeichnung 


Label 


W 

giselect 


Chip-Register  anwahlen 


— ssss 

Reg.-Nr.  Bitbelegung 

1 

.oc 

>0 

8 

- MLLLL 

1001 

9 

- MLLLL 

1010 

10 

- MLLLL 

Registerfunktion 

Voi.  A  / 

Envelope  Ein 
Vol.  B  / 

Envelope  Ein 
Vol.  C  / 

Envelope  Ein 
Level-Ctrl.-Bits(LCB) 
l=Env.  Generator  Ein 
0=Volume  durch 
LCB 


1011 

11 

PPPPPPPP 

Per.-Dauer  Env. 

Low 

1100 

12 

PPPPPPPP 

”  ”  High 

1101 

13 

- CEEE 

Hiillkurvenform 

1110 

14 

DDDDDDDD 

I/O  Port  A  (Ausg. 

-  Disk  Side  (l=Side  0) 

-  Drv-Sel.  A  (0=Select) 

-  Drv-Sel.  B  (0=Select) 

-  RS  232  RTS-Leitg. 

— -  RS  232  DTR-Leitg. 
Strobe  Parallelport 
P.3  Monitor-Buchse 
(ST) 

—  SPEAKER  ON /IT 

—  CLKDIR/ 

MEGA  STE 

t —  0=LAN 

-  1=SERIAL2 

(NurTT  +  MEGA 
STE) 


1111 


15 


DDDDDDDD 


I/O  Port  B  (Parallel- 
Port  fur  Drucker) 
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Adresse  Zugriff 

Bezeichnung 

Label 

SFF  8802  W 

Schreiben  in  angew.  Reg. 

giwrite 

DMA-Sound-Subsystem 

Diese  Register  existieren  im  ST  nicht! 

Adresse  Zugriff 

Bezeichnung 

Label 

$FF  8900  RAV  Sound-DMA-Control  sndmactl 

- re  (WORD) 


DMA-Sound  Enable 
(l=Ein) 

Frame  Repeat  (1-Repcat) 


SFF  8902 

RAV 

Frame-Start-Adr.  High-Byte 

-  OOHH  HHHR 

sndbashi 

SFF  8904 

RAV 

Frame-Start-Adr.  Middle-Byte 

- - MMMM  MMMM 

sndbasmi 

$FF  8906 

RAV 

Frame-Start-Adr.  Low-Byte 

-  LLLL  LLLL 

sndbaslo 

SFF  8908 

RAV 

Frame-Adr.-Counter  High-Byte 

-  OOHH  HHHH 

sndadrhi 

SFF  890A 

RAV 

Frame-Adr.-Counter  Middle-Byte 

- - MMMM  MMMM 

sndadrmi 

SFF  890C 

RAV 

Frame-Adr.-Counter  Low-Byte 

-  LLLL  llll 

sndadrlo 

SFF  890E 

RAV 

Frame-End-Adresse  High-Byte 

-  OOHH  HHHH 

sndendhi 

SFF  8910 

RAV 

Frame-End-Adresse  Middle-Byte 

-  MMMM  MMMM 

sndendmi 

SFF  8912 

RAV 

Frame-End- Adresse  Low-Byte 

-  LLLL  LLLL 

sndendlo 

SFF  8920 

RAV 

Sound-Mode- 

- b 

Control  sndmode 

1000  OOKR(Word) 

'  II 

00  —  6258  Hz  Samplerate 

01- 12517  Hz  ” 

10 -  25033  Hz  ” 

11  -  50066  Hz  ” 

- 0  -  Stereo  / 1  -  Mono 
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Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8922 

R/W 

MICRO  WIRE<™>  Adr.+Data-Bits 

DDDD  DDDD  DDDD  DDDD 

MWDATA 

$FF  8924 

R/W 

MICRO  WIRE<™>  Mask-Register 

MMMM  MMMM  MMMM  MMMM 

MWMASK 

Uhrenchip  des  TT 

Nachfolgend  aufgefiihrte  Register  existieren  nur  ira  TT! 


Abb.  M.4:  Die  Register  des  TT-JJhrenchips 


Adresse  Zugriff  Bezeichnung 


Label 


$FF  8961  R/W 


Registerauswahl  im  Uhrenchip 


rtc_mr 


Anhang  M:  Kurziibersicht  tiber  die  Hardware-Register 


1363 


Adresse  Zugriff  Bezeichnung  Label 


$FF  8963  RAV  Daten  des  selekt.  Uhrenregisters  rtc„data 

Reg. 

Nr.  Bitbeleg.  Bedeutung 

$A  UDDDRRRR 

| 

- - Rate-Select  f.  Int.-Periode 

— - Divider-Ctrl.  (Taktfrequenz!) 

1=  Update  in  Progress 

$B  SPAUQD2Z 

I - 1-Sommer-AVinterzeit  umschalten 

- l=24-Stunden-Modus 

- l=Zeitwerte  in  Binar,  sonst  BCD 

*• - -  1=SQW-Ausgang  einschalten 

Update  ended-Int.  Enable 

- Alarm-Int.  Enable 

- Periodic-Int.  Enable 

- l=Uhr  stellen  (Update  gestoppt) 

$C  IPAU0000 

I 

1 - Update  ended  Int.-Flag 

- Alarm-Int.  Flag 

- Periodic-Int. -Flag 

- bit.  Request-Flag  ( 1  =Int.  steht  an) 

$D  VOOOOOOO 

^ - 1=  RAM  und  Zeitwerte  sind  gultig 


Blitter 

Nachfolgende  Register  existieren  nicht  im  TT! 

Adresse  Zugriff  Bezeichnung  Label 

$FF  8A00  R/W  Halftone-RAM,  Word  0  Halftone 

$FF  8A1E  RAV 


Halftone-RAM,  Word  15 


1364 


ATARI  Profibuch 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8A20 

R/W 

Source-X-Inc.-Reg.  (Word) 

Src_Xinc 

$FF  8A22 

R/W 

Source- Y-Inc.-Reg.  (Word) 

Src_Yinc 

$FF  8A24 

R/W 

Source- Address-Reg.  (Long!) 

Src_addr 

$FF  8A28 

R/W 

ENDMASK  I  (Word) 

Endmaskl 

$FF  8A2A 

R/W 

ENDMASK  2  (Word) 

Endmask2 

$FF  8A2C 

R/W 

ENDMASK  3  (Word) 

Endmask3 

$FF  8A2E 

R/W 

Dest.-X-Inc.-Reg.  (Word) 

Dst_Xinc 

$FF  8A30 

R/W 

Dest.-Y-Inc.-Reg.  (Word) 

Dst_Yinc 

$FF  8A32 

R/W 

Dest.-Address-Reg.  (Long!) 

Dst_Addr 

SFF  8A36 

R/W 

Worte/Zeile  im  Bit-Block  (Word) 

X_Count 

$FF  8A38 

R/W 

Zeilen/Bit-Block  (Word) 

Y_Count 

$FF  8A3A 

R/W 

Halftone-OP-Register  (Byte) 

HOP 

Verkniipfungsergebnis  zwischen  Halftone- 
und  Source-Daten 

00—  Alle  Bits  =“1” 

01 —  Nur  Halftone 

10 —  Nur  Source 

11  —  Halftone  AND  Source 

$FF  8A3B  R/W  Log.  OP-Register  (Byte)  OP 

- 0000 

(Verkmipfg.  zwischen  Quell-  und  Zieldaten) 

0000  —  Ziel  =  “0” 

0001 —  Ziel  =  Quelle  AND  Ziel 

0010—  Ziel  =  Quelle  AND  NOT  Ziel 

0011  —  Ziel  =  Quelle 

0100—  Ziel  =  NOT  Quelle  AND  Ziel 

0101—  Ziel  =  Ziel 

Olio—  Ziel  =  Quelle  XOR  Ziel 
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Adresse  Zugriff  Bezeichnung 


Label 


$FF  8A3B  RAV  Log.  OP-Register  (Byte)  OP 

- oooo 

mi 

0111  —  Ziel  =  Quelle  OR  Ziel 

1000  —  Ziel  =  NOT  Quelle  AND  NOT  Ziel 

1001  —  Ziel  =  NOT  Quelle  XOR  Ziel 

1010  —  Ziel  =  NOT  Ziel 

1011  —  Ziel  =  Quelle  OR  NOT  Ziel 

1100  —  Ziel  =  NOT  Quelle 

1101  —  Ziel  =  NOT  Quelle  OR  Ziel 

1110  —  Ziel  =  NOT  Quelle  OR  NOT  Ziel 

1111  —  Ziel  =  “1” 


$FF  8A3C  R/W 


$FF  8A3D  R/W 


Line-Number-Register  (Byte)  Line_Num 

BHS-LLLL 


Line-#  fiir  Halftone-RAM 
Smudge  (Line-#  aus  Source  Buffer) 
HOG-Bit  (Buszugriff  Blitter  <->  CPU) 
0=  Blitter  4-  CPU  abwechselnd 
1=  Blitter  allein,  CPU  gestoppt 

Busy-Bit  (1=  Transfer  starten) 


SKEW-Register  (Byte)  Skew 

FN--SSSS 

I  I  I 

- -  Bitversatz  zwischen  Quell-  und  Ziel-Block 

I - NFSR  (No  Final  Source  Read) 

- FXSR  (Force  Extra  Source  Read) 


SCC-DMA  (Nur  TT!) 

Adresse  Zugriff  Bezeichnung  Label 


$FF  8C01  RAV 


DMA-Address-Pointer  (Highest  Byte) 


scdmabas 
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Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  8C03 

RAV 

DMA-Address-Pointer  (High  Byte) 

scdmabas+2 

$FF  8C05 

RAV 

DMA-Address-Pointer  (Low  Byte) 

scdmabas+4 

$FF  8C07 

RAV 

DMA-Address-Pointer  (Lowest  Byte) 

scdmabas+6 

$FF  8C09 

RAV 

DMA-Bytezahler  (Highest  Byte) 

scdmacnt 

$FF  8C0B 

RAV 

DMA-Bytezahler  (High  Byte) 

scdmacnt+2 

$FF  8C0D 

RAV 

DMA-Bytezahler  (Low  Byte) 

scdmacnt+4 

$FF  8C0F 

RAV 

DMA-Bytezahler  (Lowest  Byte) 

scdmacnt+6 

$FF  8C10 

R 

Restdatenregister  (High-Word) 

scdmarsd 

$FF  8CI2 

R 

Restdatenregister  (Low-Word) 

scdmarsd+2 

$FF  8C14 

RAV 

Kontrollregister  (Word) 

scdmactl 

BC0000ED 


Richtung  (1=  WRITE) 
DMA-Enable  (1=  On) 
=1 :  Byte  Count  auf  0 
=1:  Bus  Error  bei  DMA 


Serial  Communications  Controller  (SCC) 


Dieser  Baustein  existiert  nur  im  TT/MEGA  STE! 


Adresse  Zugriff  Bezeichnung 


Label 


$FF  8C81  R/W 

$FF  8C83  RAV 

$FF  8C85  RAV 

$FF  8C87  RAV 


CtrLReg.  Kanal  A 
Data-Reg.  Kanal  A 
CtrLReg.  Kanal  B 
Data-Reg.  Kanal  B 


sccctl_a 

sccdat_a 

sccctl_b 

sccdat_b 


Die  Control-Register  werden  auf  folgende  Weise  in  zwei  Stufen  “bedient”: 

-  Der  erste  Schreibzugdff  auf  die  Control-Register  “landet”  in  Write-Register  0  des  ent- 
sprechenden  SCC-Kanals  und  wird  zur  Einstellung  der  gewiinschten  Registemummer 
verwendet. 


Der  nachste  Zugriff  (Schreiben  oder  Lesen)  auf  das  Control-Register  erreicht  dann  das 
im  ersten  Zugriff  ausgewahlte  Register! 
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Die  Data-Register  erlauben  mit  einem  Schreibzugriff  direktes  Einschreiben  eines  By  tes  in  den 
Sendebuffer  (Write-Register  8).  Bei  einem  Lesezugriff  erhalt  man  das  Byte  aus  dem  Emp- 
fangsbuffer  (Read-Register  8). 

Also  ist  ein  Zugriff  auf  die  “zeitkritischen  Daten”  ohne  groBe  Umwege  moglich. 

Naheres  zum  komplexen  Registersatz  des  SCC  findet  sich  im  TT-Hardware-Teil,  Kapitel  7, 
“Seriell,  aber  schnell  -  Der  SCC  macht’s  moglich”. 


System  Control  Unit  (SCU) 

Dieser  Baustein  iibemimmt  im  TT/MEGA  STE  u  .a.  das  Interrupt-Handling.  Im  ST/STE  ist 
der  Baustein  nicht  vorhanden! 


Adresse  Zugriff  Bezeichnung 


Label 


$FF  8E01  RAV 


$FF  8E03  R 


$FF  8E05  RAV 

$FF  8E07  RAV 

$FF  8E09  RAV 

$FF  8E0B  RAV 


System  Int,  Mask-Register  sys_mask 

SSSSSSS-  (Byte) 


System-Soft.-Int.  (l=aktiviert) 
HSYNC-Interrupt  (l=aktiviert) 
Nicht  benutzt 

VSYNC-Interrupt  (l=aktiviert) 
IRQ  von  SCC  (l=aktiviert) 

IRQ  von  MFPs  (l=aktiviert) 
_SYSFAIL-Int.  VME  (1-aktiviert) 


System  Int.  Status-Register 

Bitbelegung  wie  vor.  Gesetzte  Bits 
stellen  Interruptanforderungen  dar. 

(Vor  “sys_mask”  auslesen,  da  Lese¬ 
zugriff  auf  “sys_mask”  IRQs  zuriick- 
setzt!) 

sys_stat 

System  Software  Int.  erzeugen 

sysjnt 

VME-Bus-IRQ  Level  3  erzeugen 

vme_int 

SCU  General  Purpose  Reg.  1 

SCU  General  Purpose  Reg.  2 

scu_gpl 

scu_gp2 
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Adresse  Zugriff  Bezeichnung 


Label 


$FF  8E0D  R/W 


$FF  8E0F  R 


$FF  8E21  R/W 


VME-Bus  Int.  Mask-Register  vme_mask 

WVWW-  (Byte) 

L 

IRQl  v.  VME-Bus  (l=aktiviert) 

—  _IRQ2  v.  VME-Bus  (l=aktiviert) 

- _IRQ3  /  Soft-Int.  ( l=aktiviert) 

- _1RQ4  v.  VME-Bus  (l=aktiviert) 

- _IRQ5  /  SCC-Int.  (l=aktiviert) 

- _IRQ6  /  MFP-Int.  (I— aktivicrt) 

_IRQ7  v.  VME-Bus  (l=aktivieit) 

VME-Bus  Int.  Status-Register  vme_stat 

Bitbelegung  wie  vor.  Gesetzte  Bits  stellen  Interrupt- 
anforderungen  dar.  (Vor  “vme_mask”  auslesen,  da  Lese- 
zugriff  auf  “vme„mask”  IRQs  zuriicksetzt!) 

MEGA  STE  Cache  +  Taktctrl.  (Byte)  ste_ctl 

Die  unteren  beiden  Bits  kontrollieren  die  Taktfrequenz 
und  den  Cache-Speicher. 


Joystickports  beim  STE 


Adresse: 
$FF  3288 


Bit-Nr.! 


rr 

i  m  nrr 

1, 131112181 

- 'Button-Mp 

Inhalt: 

Zustand  der  Fire-Buttons 
fur  Joysticks/Paddles 

tLog.  8  =  Buxton  betatigt!) 


ftdresse:  Bit-Hr.: 

IB  14  13  12  1  1  10  3  8  7  6  B  4  3  2  1  0 

SFF  5202 

** - 1 - - 1 - '' - 1 - - ! - ' 

Stick  3  Stick  1  Stick  2  Stick  0 


Inhalt: 

Ri  chtungsinf  omationen 
der  Joysticks  0-3 

CLog.  8  -  Stick  betatigtSJ 


Abb.  M.5:  Die  Adressen  der  neuen  Joystickports 


Adresse 

Label 

Inhalt 

SFF  9220 
SFF  9222 

XPEN 

YPEN 

X-Position  des  Lightpens 
Y-Position  des  Lightpens 

Anhang  M:  Kurziibersicht  iiber  die  Hardware-Register 
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Adresse 

Label 

Inhalt 

$FF  9210 

PADDLO 

Position  des  Paddle  0 

SFF9212 

PADDL1 

Position  des  Paddle  1 

SFF9214 

PADDL2 

Position  des  Paddle  2 

SFF9216 

PADDL3 

Position  des  Paddle  3 

Multifunktionsbaustein  MFP  MC68901 

Dieser  Chip  ist  in  alien  Maschinen  vorhanden,  jedoch  zum  Teil  geringe  Abweichungen  bei 
der  Belegung  der  GPIP-Anschliisse! 

Alle  Register  sind  mit  Bytezugriffen  zu  erreichen. 

Adresse  Zugriff  Bezeichnung  Label 


SFFFA01  R/W 


•J 


GPIP-Data-Register  gpip 

(Meldeleitungen,  interruptfahig) 

*  I  I  I  II  Ml 

BUSY  von  par.  Port  (Drucker) 

RS  232  Data  Carrier  Detect  (DCD) 

RS  232  Clear  To  Send  (CTS) 

GPU  Done  (nichtTT!) 

CLKDIR  (nur  TT!) 

IRQ  von  Tastatur-/  MIDI-ACIA 
INT  von  FDC/ACSI-Bus 
RS  232  Ring  Indicator  (RI) 

Monochrome  Monitor  Detect 
XORED  m.  Frame-Ende-Signal  (STE/TT) 


$FF  FA03  R/W  Active-Edge-Register  aer 

Bitbelegung  wie  bei  “gpip”! 

Interruptauslosung  bei 
l=steig.,  0-fall.  Flanke 

$FF  FA05  R/W  Data-Direction-Register  ddr 

Bitbelegung  wie  bei  “gpip”! 

Signalrichtung  fur  GPIP-Port 
1  -  Out,  0  =  In 
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Adresse  Zugriff  Bezeichnung 


Label 


$FF  FA07  R/W 


Interrupt-Enable-Register  A  iera 

EEEEEEEE 


Timer  B  (Display  enable  Signal) 
XMIT  Error  (RS  232) 

XMIT  Buffer  empty  (RS  232) 

RCV  Error  (RS  232) 

RCV  Buffer  full  (RS  232) 

Timer  A  (BUSY-Signal  bei  ST) 
Timer  A  (Frame-Ende  bei  TT/STE) 
Port  16  (RS  232  Ring  Indicator) 
Port  17  (Monochr.-Monitor  Detect) 


$FF  FA09  R/W 


Interrupt-Enable-Register  B  ierb 

EEEEEEEE 


Port  10  (BUSY  v.  par.  Schnittst.) 
Port  II  (RS  232  Data  Carrier  Detect) 
Port  12  (RS  232  Clear  To  Send) 

Port  13  (GPU  done,  nicht  TT!) 

Timer  D  (Baudraten-Gen.  RS  232) 
Timer  C  (200  Hz  Systemtakt) 

Port  14  (IRQ  Tastatur-/  MIDI-ACIA) 
Port  15  (IRQ  von  FDC/ACSI-Bus) 


$FF  FAOB 

R/W 

Interrupt-Pending-Register  A 

(Bitbelegung  siehe  “iera”) 

ipra 

$FF  FAOD 

R/W 

Interrupt-Pending-Register  B 

(Bitbelegung  siehe  “ierb”) 

iprb 

$FF  FAOF 

R/W 

Interrupt-In-Service-Register  A 

(Bitbelegung  siehe  “iera”) 

isra 

$FF  FA  11 

R/W 

Interrupt-In-Service-Register  B 

(Bitbelegung  siehe  “ierb”) 

isrb 

$FF  FA  13 

R/W 

Interrupt-Mask-Register  A 

(Bitbelegung  siehe  “iera”) 

imra 

Anhang  M:  Kurziibersicht  iiber  die  Hardware-Register 
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Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  FA  15 

RAV 

Interrupt-Mask-Register  B 

(Bitbelegung  siehe  “ierb”) 

imrb 

$FF  FA17 

RAV 

Interrupt-Vektor-Register 

vw vs — 

vr 

End-of-Interrupt-Modus 
High-Nibble  der  Vektomummer 

$FF  FA  19  R/W  Timer- A-Ctl.-Reg.  tacr 

Bei  ST  wird  Timer  A-Eingang 
vom  BUSY-Anschlu6  angesteuert. 

Bei  TT/STE  wird  Timer  A-Eingang 
mit  Frame-Ende-Signal  des  DMA-Sound- 
Moduls  angesteuert. 

Bitbelegung  wie  bei  Timer-B-Ctl.-Reg.! 


SFFFAIB  RAV  Timer-B-Ctl.-Reg.  tbcr 

- RCCCC  (Display  Enable-Signal) 

j  |  Modus  Vorteiler 

0000  Stop 

0001  Delay  4 

0010  Delay  10 

0011  Delay  16 

0100  Delay  50 

0101  Delay  64 

0110  Delay  100 

0111  Delay  200 

1000  Ereignis  - 

1001  Pulsbreite  4 

1010  Pulsbreite  10 

1011  Pulsbreite  16 

1100  Pulsbreite  50 

1101  Pulsbreite  64 

1110  Pulsbreite  100 

1111  Pulsbreite  200 


Timer  Ausgang  auf  Low 
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Adresse  Zugriff  Bezeichnung 


Label 


$FF  FA1D  R/W 


Timer: 

$FF  FA1F  R/W 
$FF  FA21  R/W 
$FF  FA23  R/W 
$FF  FA25  R/W 

$FF  FA27  R/W 

SFFFA29  R/W 


Timer  C+D  Control  Reg.  tcdcr 

-CCC-DDD 

(C:  200Hz-System  Takt) 

(D:  Baudrate  fur  RS232  des  MFP) 


Modus  Vorteiler 


000-000 - 

—  STOP 

- 

001-001 - 

—  Delay 

4 

010-010  — 

—  Delay 

10 

011-011  — 

—  Delay 

16 

100-100  — 

—  Delay 

50 

101-101' — - 

—  Delay 

64 

110-110  — 

—  Delay 

100 

111-111  — 

—  Delay 

200 

(C)  (D) 

(Takt=2,4576  MHz) 


Timer  A  Data  Register  tadr 

Timer  B  Data  Register  tbdr 

Timer  C  Data  Register  tcdr 

Timer  D  Data  Register  tddr 


Sync.-Character-Register 


scr 


USART-Control-Register  ucr 

ccccccc- 

1 - l=Even-,  0=Odd-Parity 

Parity  Enable 


II 

Start 

Stop 

Modus 

00  — 

—  0 

0 

Synchron 

01  — 

—  i 

1 

Asynchron 

10  - — 

—  1 

1,5 

Asynchron 

11  — 

—  1 

2 

Asynchron 

I  I  Wortlange  in  Bits 

00  8 

01  7 

10  6 

II  5 

-  Clock  Mode  (l=Clk/l6,  0=Clk) 


Anhang  M:  Kurziibersicht  iiber  die  Hardware-Register 
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Adresse  Zugriff  Bezeichnung  Label 

$FF  FA2B  RAV  Receiver-Status-Register  rsr 

ssssssss 

II 

1 —  Receiver  Enable 
—  Synchronous  Strip  Enable 
— --  Match  bzw.  Character  in  progress 
— —  Found/Search  bzw.  Break 

' - Frame  Error 

-  Parity  Error 

- — -  Overrun  Error 

— - Buffer  Full 

$FF  FA2D  RAV  Transmitter-Status-Register  tsr 

SSSSSSSS 

I —  Transmitter  Enable 

Sender-Ausgangsleitung 
00  —  Hochohmig 

$FF  FA2D  RAV  Transmitter-Status-Register  tsr 

SSSSSSSS 

Sender-Ausgangsleitung 
Low-Pegel 
High-Pegel 
Schleife 

Break  senden 
Senden  beendet 
Auto  Turnaround 
Underrun  Error 
Sendepuffer  leer 

SFFFA2F  RAV  USART-Data-Register  udr 

(Lesen  holt  Byte  aus  Empfangspuffer) 

(Schreiben  bringt  Byte  in  Sendepuffer) 
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Floating  Point  Processor  MC68881  (SFP004) 

Die  Register  des  Floating-Point-Processor-Adapters  (SFP004)  sind  im  MEGA-ST(E)  ab 
Adresse  $FF  FA40  zu  finden !  Nahere  Informationen  zu  diesen  Hardware-Registern  finden  Sie 
im  Anhang  im  Kapitel  “Der  Coprozessor  MC6888 1  im  MEGA  ST(E)”. 


Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  FA40 

R 

Response-Register 

(Word) 

FPstat 

SFFFA42 

W 

Control-Register 

(Word) 

FPctl 

$FF  FA44 

R 

Save-Register 

(Word) 

FPsave 

$FF  FA46 

R/W 

Restore-Register 

(Word) 

FPrestor 

$FF  FA48 

? 

(Reserviert!) 

$FF  FA4A 

W 

Command-Register 

(Word) 

FPcmd 

$FF  FA4C 

? 

(Reserviert!) 

$FF  FA4E 

R 

Condition-Code-Reg. 

(Word) 

FPccr 

SFFFA50 

R/W 

Operanden-Register 

(Long!) 

FPop 

$FF  FA54 

R 

Register  Select 

(Word) 

FPselct 

$FF  FA56 

7 

(Reserviert!) 

$FF  FA58 

W 

Instruction  Address 

(Long!) 

FPiadr 

$FF  FA5C 

? 

(Reserviert!) 

(Long!) 

TT-MFP  MC68901 

Dieser  Chip  ist  nur  im  TT  zu  finden!  AJle  Register  sind  mit  Bytezugriffen  zu  erreichen. 

Adresse 

Zugriff 

Bezeichnung 

Label 

SFFFA81  R/W 


GPIP-Data-Register  GPIP_TT 

IIIIIIII  (Meldeleitungen,  interruptfahig) 


Auf  Pfostenstecker  gefiihrt  und  fiir 
kiinftige  Erweiterungen  reserviert! 

IRQ  (Low)  von  SCC-DMA-Controller 
Ring  Indicator  von  MODEM  2-Buchse 
Von  P.34  des  intemen  Disk-Drives 
Busfehler  (Low)  von  SCSI-DMA-Ctl. 
IRQ  (Low)  von  TT-Uhrenchip 
IRQ  (High)  von  SCSI-Controller 


Anhang  M:  Kurziibersicht  iiber  die  Hardware-Register 
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Adresse  Zugriff  Bezeichnung 


Label 


SFFFA83  R/W 


$FF  FA85  R/W 


$FF  FA87  R/W 


$FF  FA89  R/W 


SFFFA8B  R/W 


Active-Edge-Register  AER_TT 

Bitbelegung  wie  bei  “GPIP_TT”! 

Interruptauslosung  bei 
1  =  steig.,  0  =  fall.  Flanke 

Data-Direction-Register  DDR_TT 

Bitbelegung  wie  bei  “GPIP_TT”! 

Signalrichtung  fiir  GPIP-Port 
1  =  Out,  0  =  In 


Interrupt-Enable-Register  A  IERAJIT 

EEEEEEEE 

^ -  Timer  B  (Display  enable  Signal) 

-  XMIT  Error  (RS  232) 

- -  XMIT  Buffer  empty  (RS  232) 

L- -  RCV  Error  (RS  232) 

L- - RCV  Buffer  full  (RS  232) 

L - •  Timer  A 

— - - Port  16  (IRQ  von  Uhrenchip) 

- - Port  17  (IRQ  von  SCSI-ControUer) 

Interrupt-Enable-Register  B  EERB_TT 

EEEEEEEE 

I -  Port  10 

-  Port  II 

- —  Port  12  (IRQ  v.  SCC-DMA-Controller) 

-  Port  13  (RI  von  MODEM  2-Buchse) 

I - Timer  D  (Baudr.-Gen.  fiir  SERIAL  1) 

- -  Timer  C  (Takt  fur  SCC-Kanal  B) 

-  Port  14  (P.34  von  int.  Floppy-Disk) 

- — —  Port  15  (Busfebler  SCSI-DMA-Chip) 

Interrupt-Pending-Register  A  IPRAJTT 

(Bitbelegung  siehe  “IERA_TT”) 


$FF  FA8D  R/W 


Interrupt-Pending-Register  B 

(Bitbelegung  siehe  “IERBJTT”) 


IPRB_TT 
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Adresse 

ZugrifT 

Bezeichnung 

Label 

SFF  FA8F 

R/W 

Interrupt-In-Service-Register  A 

(Bitbelegung  siehe  “IERAJTT”) 

ISRAJTT 

$FF  FA9 1 

R/W 

Interrupt-In-Service-Register  B 

(Bitbelegung  siehe  “IERB_TT”) 

ISRB_TT 

$FF  FA93 

R/W 

Interrupt-Mask-Register  A 

(Bitbelegung  siehe  “IERAJTT”) 

IMRA_TT 

SFFFA95 

R/W 

Interrupt-Mask-Register  B 

(Bitbelegung  siehe  “IERB_TT”) 

IMRB_TT 

$FF  FA97 

R/W 

Interrupt-Vektor-Register 

wv vs - 

VR_TT 

End-of-Interrupt-Modus 
High-Nibble  der  Vektomummer 


$FF  FA99 

R/W 

Timer-A-CtL-Reg. 

Bitbelegung  wie  bei  Timer-B-Ctl.-Reg.! 

TACR_TT 

SFF  FA9B 

R/W 

Timer-B-Ctl.-Reg. 

- RCCCC  (Display  Enable-Signal) 

TBCRJTT 

|  |  |  |  Modus  Vorteiler 

0000 -  Stop  - 

0001 - Delay  4 

0010  - — -  Delay  10 

0011 - Delay  16 

0100 - Delay  50 

0101 - Delay  64 

0110 - Delay  100 

0111 - Delay  200 

1000  - Ereignis  - 

1001  - Pulsbreite  4 

1010  - Pulsbreite  10 

1011  - Pulsbreite  16 

1100  - Pulsbreite  50 

1101  -  Pulsbreite  64 

1110 -  Pulsbreite  100 


1111 - Pulsbreite  200 

-  Timer- Ausgang  auf  Low 


Anhang  M:  Kurziibersicht  fiber  die  Hardware-Register 
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Adresse  Zugriff  Bezeichnung 


Label 


SFFFA9D  R/W  Timer  C+D  Control  Reg.  TCDCR_TT 

-CCC-DDD 

(C:  Takt  fur  SCC-Kanal  B) 

(D:  Baudrate  fur  SERIAL  1) 


Modus  Vorteiler 


000-000 - STOP 

- 

(Takt-2,4576  MHz) 

001-001 - Delay 

4 

010-010 - Delay 

10 

011-011 - Delay 

16 

100-100  - Delay 

50 

101-101 - Delay 

64 

110-110 - Delay 

100 

111-111 - Delay 

200 

Timer: 

(C)  (D) 

$FF  FA9F 

R/W 

Timer  A  Data  Register 

TADRJTT 

SFFFAAl 

RAN' 

Timer  B  Data  Register 

TBDRJTT 

$FF  FAA3 

RAV 

Timer  C  Data  Register 

TCDRJTT 

$FF  FAA5 

RAV 

Timer  D  Data  Register 

TDDRJTT 

$FF  FAA7 

RAV 

Sync.-Character-Register 

SCR_TT 

$FF  FAA9 

RAV 

USART-Control-Register 

UCR_TT 

ccccccc- 

l=Even-,  0=Odd -Parity 
Parity  Enable 


II 

Start  Stop 

Modus 

00 - 

- 0  0 

Synchron 

01 - 

- 1  1 

Asynchron 

10  — 

-  1  1,5 

Asynchron 

11  — 

— -  1  2 

Asynchron 

|  i  Wortlange  in  Bits 

00 - 8 

01 - 7 

10 - 6 

11 - -  5 

- Clock  Mode  (l=Clk/16,  0=Clk) 
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Adresse  Zugriff  Bezeichnung 


Label 


$FF  FAAB  R/W 


$FF  FAAD  R/W 


Receiver-Status-Register 


RSR_TT 


ssssssss 


-  Receiver  Enable 

-  Synchronous  Strip  Enable 

- Match  bzw.  Character  in  progress 

-  Found/Search  bzw.  Break 

-  Frame  Error 

— -  Parity  Error 

-  Overrun  Error 

-  Buffer  Full 


Transmitter-Status-Register 

SSSSSSSS 


Transmitter  Enable 

Sender- Ausgangsleitung 

Hochohmig 

Low-Pegel 

High-Pegel 

Schleife 

Break  senden 
Senden  beendet 
Auto  Turnaround 
Underrun  Error 
Sendepuffer  leer 


TSR_TT 


IFFFAAF 


R/W 


USART  -Data-Register 

(Lesen  holt  Byte  aus  Empfangspuffer) 
(Schreiben  bringt  Byte  in  Sendepuffer) 


UDR_TT 


Anhang  M:  Kurziibersicht  iiber  die  Hardware-Register 


1379 


Tastatur-ACIA 

Adresse  Zugriff  Bezeichnung  Label 


$FF  FCOO  R 


ACIA-Statusregister  (Byte) 

ssssssss 


Receive  Data  Register  Full 
Transmit  Data  Register  Empty 
Data  Carrier  Detect 
Clear  To  Send 
Framing  Error 
Receiver  Overrun 
Parity  Error 
Interrupt  Request 


keyctl 


$FFFC01  W 


ACIA-Steuerregister  (Byte)  keyctl 

cccccccc 

|  |  (ACIA-Betriebsart/Vorteilerfaktor) 

00  —  Baudrate=Taktfrequenz 
01  —  Baudrate=Taktfrequenz/16 

10  —  Baudrate=Taktfrequenz/64 

11  —  ACIAReset 


1 

Bits/Wort 

Parity 

Stopbits 

000 

7 

gerade 

2 

001  - 

7 

ungerade 

2 

010 - 

7 

gerade 

1 

Oil  - 

7 

ungerade 

1 

100 - 

8 

- 

2 

101  - 

8 

~ 

1 

110  - 

8 

gerade 

1 

111 - 

8 

ungerade 

1 

00- 

01- 

10- 

11- 


RTS  auf  Low,  TxINT  gesperrt 
RTS  auf  Low,  TxINT  ffeigeben 
RTS  auf  High,  TxINT  gesperrt 
RTS  auf  Low,  TxINT  gesperrt 
“Break”  senden 
RxINT  freigeben 
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Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  FC02  RAV 

MIDI- ACIA 

ACIA-DATA-Register  (Byte) 

(READ  =  Empfangsdaten) 

(WRITE=  Sendedaten) 

keybd 

Adresse 

Zugriff 

Bezeichnung 

Label 

$FF  FC04 

R 

ACIA-Statusregister  (Byte) 

(siehe  Tastatur-ACIA) 

midictl 

W 

ACIA  Steuerregister  (Byte) 

(siehe  Tastatur-ACIA) 

midictl 

$FF  FC06 

RAV 

ACIA  DATA  Register  (Byte) 

(READ  =  Empfangsdaten) 

(WRITE=  Sendedaten) 

midi 
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Pinbelegungen  der  Chips 


OS 
08 
D7 
0  8 
D9 
D10 
Dll 
012 
DJL3 
014 
D15 
GND 
023 
022 
021 
Ucc 
020 
019 
018 
A17 
016 
015 
014 
013 
012 
Oil 
010 
09 
08 
07 
08 
05 


fSJ  •**  fi» 
XSOICECtESKCi 


CM  ® 

ooooooocaocaoocaaisl-jac 


Abb.  N.l:  CPU -Pinbelegungen  ini  ST/STE 
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Abb.  N.2:  CPU  MC  68030  im  TT  (PIN -GRID-ARRAY -Format) 


Abb.  N.3:  CPU  MC  68030  im  TT  (SMD-Format) 
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Abb.  N.4:  Die  Pinbelegung  des  68881/68882  im  PIN -GRID -ARRAY -Format 


Abb.  N.5:  Pinbelegung  der  ST-MMU 


1384 


ATARI  Profibuch 


Abb.  N.6:  Pinbelegung  des  ST-GLUE 


Abb.  N.7:  Pinbelegung  des  STISTE-BL1TTER 
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Abb.  N.8:  Pinbelegung  des  ST-SHIFTER 


Abb.  N.9:  Pinbelegung  des  STE-SHIFTER 
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Abb.  N.10:  Pinbelegung  des  ST/STE/TT-DMA-Chips 
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Abb.  N.l  1 :  Pinbelegung  des  ST/STE/TT-PSG 


H/H 


Anhang  N:  Pinbelegungen  der  Chips 


1387 


I 


Abb.  N.12:  Pinbelegung  des  ST-MFP  und  des  STEITT-MP'P 
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Abb.  N.J3:  Pinbelegung  des  ST ISTE/TT -FDC 


Abb.  N.14:  Pinbelegung  des  ST/STE/TT-ACIA 
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Abb.  N.15:  Pinbelegung  der  STE/GSTMCU 
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Abb.  N.16:  Pinbelegung  der  STEITT-TrSCU 
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Abb.  N.  17:  Pinbelegung  derTT-MCU 
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Abb.  N.J8:  Pinbelegung  des  TT/FUNNEL-Chips 
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1395 


i“H  3D 

ffiXJJN^iT'HCDPCONuin'tf'POCNJ^aacn  m 
O'tf'UJLLJUOLJnorVDfNfvJfSitNJCMCMCNCSIfSifM^N  ft 
a.co'i&ou.Li.u.cscEcsircccccarccffiirs 


CC  C  £  S  C  3 


Udo 

m 

R/U 

05 

S3 

SIZ1 

S3 

size 

biJ 

±6MHz->  CLKIH 

is 

ns 

S3 

CBRO 

31 

STERR 

m 

CBRCK 

S3 

CRS8 

si 

cnsl 

as 

CRS2 

S3 

CRS3 

m 

Uss 

S3 

RRS 

m 

Udo 

HO 

UE 

H3 

Uss 

M 

RROIB 

eh 

RRD9 

■ 

R0 

HRD0X 
Udo  C+5U) 


a  co  «r-osD  m  m  e  «■  «  ro  o  n  m  •-(  o  x  mod  m 

■DO  M  O  *0  O  M  P  T3  □  M  □  T)  □  W  □  n  MO  M 

occoccocc=»ccoa=oa:oa;=>a:oaoa:=> 

cccEZEsrtPCcrc: 


Abb.  M2i;  Pinbelegung  der  TT-Fast-MCU 
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Abb.  N.22:  Pinbelegung  des  TT-DMAC  und  des  TT-DCU-Chips 
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Abb.  N.24:  Pinbelegung  des  TT-Uhrenchips 
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200Hz-Timer-Interrupt  55 
40-Ordner-Fehler  180 
5380  (SCSI)  1114 
6301  (IKBD)  922 
68030  imTT  1009 

68881  1019,1022 

68882  1019 
68882-Befehle  1026 

68882-FPU,  hardwaremaBige  Einbindung  1020 
68882-Register  1026 
85C30  (SCC)  1135 


A 

A1  (ACSI)  984 

ABC-GEM  289,534 

Abwartszahler  (MFP)  874 

Accessories,  Erkennung  im  Startupcode  541 

Accessories,  Laden  der  539 

Accessory  547,  607,  625  f. 

Accrued  Exception  Byte  (AEXC)  (68882)  1034 

ACFAEL  (VME-Bus)  1192 

ACIA  911 

ACIA  (MFP)  893 

ACIA-Betriebsweisen  912 

ACIA-Zeichenformat  913 

ACIAsimTT  1211 

ACK  (ACSI)  984 

ACK  (SCSI)  1077 

ACKNLG-Signal  (par.  Schnittstelle)  907 
Acknwldg.  (SCSI)  1077 
ACSI-Bus  981  f. 

ACSI-Bus  (TT/MEGA  STE)  1215  f. 
ACSI-Bus-Zugriff  817 

ACSI-Bus,  hardwaremaBige  Realisierung  des  983 
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act_pd  185 

Active-Edge-Register  (TT-MFP,  Adr.  $FF(FF)  FA83)  1064 

Active-Edge-Register,  (ST-MFP,  Adr.  $FF  FA03)  872,  875,  878,  1300 

ACCLOSE  (41)  547, 606,  720,  732,  739 

AC_OPEN  (40)  546,594 

Address  Mark-Detector  (FDC)  973 

Address  Modifier  (VME-Bus)  1 188, 1 193 

Address  Strobe  (68030)  1006 

Address  Strobe  (Megabus)  823 

Address  Strobe  (VME-Bus)  1187 

Address  Translation  Cache  (68030)  1009,  1014 

AdreBbus  (Megabus)  823 

AdreBbus,  gemultiplexter  796 

AdreBbus  (68030),  32-Bit-  1005 

AdreBfehler  (SC)  51 

AdreBleitungen  793 

AdreBraum  794 

AdreBraum  (68030)  1012 

AdreBumsetzung  (68030)  1014 

AER  (MFP,  Adr.  $FF  FA03)  1 300 

AER  (ST-MFP,  Adr.  $FF  FA03)  872 

AER_TT  (TT-MFP,  Adr.  $FF(FF)  FA83)  1064 

AES  337,533 

AES-Bindings  587  f. 

AES-Environment  66,  191, 539,  707 
AES-Opcode,  falscher  589 
AES  Parameterblock  588 
AES,  Initialisierung  538 
AESPB  588 
after  touch  (MIDI)  917 
AHDI.PRG  24  f. 

AHDI/HDX  171 
Aktionspunkt  307,  318  f.,  443 
Alarm-Box  567,643 

Alarmfunktion  (MEGA  ST(E)-Uhrenchip)  1329 
Alarmzeitregister  (TT-Uhr)  1202  f. 

Allocate  memory  251 
Allocate  memory  (with  preference)  255 
Alpha-Cursor  482,  484  ff.,  496 
ALPHA  CURSOR  DOWN  (VDI 5, 

Escape  5)  486 
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ALPHA  CURSOR  LEFT  (VDI 5, 

Escape  7)  488 

ALPHA  CURSOR  RIGHT  (VDI  5, 

Escape  6)  487 

ALPHA  CURSOR  UP  (VDI  5,  Escape  4)  485 
Alpha-Text  483  f.,  494  f. 
Altemate-Function-Code  Register  (68030)  1012 
Alternate  RAM  182,  194,  1039, 1042 
AM-Codes  (VME-Bus)  1188 
AM-Detector  (FDC)  973 
AM0..AM5  (VME-Bus)  1188 
Ankoramender  Ruf  (Ring  indicator  (RI))  56,  893 
AnschluBbelegung,  Megabus-  821 
AnschluBkabel  (Diskstation)  953 
ANSI-Standard  275 
_app  541 

APPL_BVSET  (AES  16)  604, 673 
APPLJBXIT  (AES  19)  606 
APPLJFIND  (AES  13)  599 
APPLJNIT  (AES  10)  541, 594 
APPL_READ  (AES  11)  596,599 
APPL_TPLAY  (AES  14)  601  f. 
APPL_TRECORD  (AES  15)  602 
APPLJWRITE  (AES  12)  597,599 
APPL_YDELD  (AES  17)  605 
ap_id  542,  625  f. 

Arbeitsbereich  578 
Arbeitstakt  (PSG)  859,  863 
Arbiter  (VME-Bus)  1189 
Arbitrary  Line  ($A003)  31 1 
ARBITRATION-Phase  (SCSI)  1078 
ARBITRATION,  SCSI-Systeme  ohne  1080 
Arbitrations-Bus  (VME-Bus)  1 1 85, 1 1 89 
ARC  (VDI  11,  GDP  2)  361 
Archiv-Bit  227,247 
ARGV-Verfahren  191  f.,  256,  586 
argv[0]  192 
ARHEADER  197 

Arithmetic  Processing  Unit  (APU)  (68882)  1022 
ARROW  (0)  667 
Artline  325 
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AS  (68030)  1006 

AS  (Megabus)  823 

AS  (VME-Bus)  1187 

Aspect  ratio  279 

ASSIGN.SYS  292,  330  f„  343 

Asynchrone  Steuerungsverf ahren  (SCC)  1136,  1155 

Asynchronous-Communications-Interface- Adaptor  (ACIA)  9 1 1 

ATARI  Computer  System  Interface  (ST)  813 

ATC  (68030)  1009 

ATN  (SCSI)  1076 

attack  velocity  (MIDI)  917 

Attention  (SCSI)  1076 

Auch  eine  prominente  Zahl  42 

Auflosung  62,  121,  152, 279,  1047 

Ausgabestatus  210,  216 

Ausgangsamplitude  (PSG)  864 

Ausnahmebehandlung  (68030)  1014 

Ausnahmevektoren  796, 1010 

AUTO-Ordner  20 

Auto  Turnaround  (MFP-USART)  902 
Autolautsprecher  946 
Automatic-EOI-Modus  (MFP)  888  f. 

_autopath  ($4CA)  66 


Autovektor-Interrupt 

883, 

1008 

Autovektor-Interrupt, 

Level 

1  ($64) 

53 

Autovektor-Interrupt, 

Level 

2  ($68) 

53 

Autovektor-Interrupt, 

Level 

3  ($6C) 

53 

Autovektor-Interrupt, 

Level 

4  ($70) 

53 

Autovektor-Interrupt, 

Level 

5  ($74) 

54 

Autovektor-Interrupt, 

Level 

6  ($78) 

54 

Autovektor-Interrupt, 

Level 

7  ($7C) 

54 

AUX:  161,237 
AV-Protokoll  547 
AVEC  (68030)  1008 
AY-3-8910  (PSG)  859 
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B 


Bad  sector  list  30,  994 
Badertscher,  Ken  192 
BAR  (VDI 11,  GDP  1)  360 
Base  line  35 1 , 396,  398, 401 , 407,  477 
BASEPAGE  186, 244,  267,  586, 702 
Basisbandverfahren  (SCC)  1139 
Basislinie  35 1 ,  396,  398, 401 ,  407,  477 
Baudratengenerator  (SCC)  1 135,  1 165  f. 
BBSY  (VME-Bns)  1189,1192 
BCB  171 

BCLR  (VME-Bus)  1 1 89,  1 192 
Bconin  (BIOS  2)  65, 83 
Bconmap  (XBIOS  44)  98 
BCONMAP-Struktur  12  f.,  98 
Bconout  (BIOS  3)  11,84 
Bconstat  (BIOS  1)  83,  85 
Bcostat  (BIOS  8)  1 1 ,  86 
Bedienerfiihrung  745 
Bedingungsabfrage-Bits  (68881)  1340 
Bedingungscodes  (68882)  1033 
Befehl  TRAPV  ($1C)  52 
Befehl,  illegaler  51 
Befehlsbytes  (FDC)  971 
BEG JVICTRL  (3)  691 
BEGJJPDATE  (1)  691 
bell_hook  ($5AC)  11,71 
Benutzeroberflache  745  f. 

BERR  (68030)  1008 
BERR  (Megabus)  824 
BERR  (VME-Bus)  1188,1193 
Beruhigungspause,  Kopf-  962 
Betriebsarten  (IKBD)  923 
Betriebsarten,  MIDI-  916 
Betriebssystem-ROMs  801 
Bezierkurven  288 
BG  (68030)  1008 
BG  (Megabus)  822 
BG0..BG3  (VME-Bus)  1189 
BGACK  (68030)  1008 


1410 


ATARI  Profibuch 


BGACK  (BLITTER)  857 

BGACK  (Megabus)  822,825 

BGI  (BLITTER)  857 

BGKI  (BLITTER)  857 

BGM-Partition  28 

BGO  (BLITTER)  857 

BGO  (Megabus)  822,824 

Bildpunkt  833 

Bildschirm  149, 219 

Bildschirmmanager  536  f„  599 

Bildschirmspeicher  62  f.,  133,  139,  152 

Bildschirmspeicher  (ST/STE)  832 

Bildschirmspeicher  (TT)  1047 

Bildschirmtreiber  300,  331,  337 

Bildschirmzeilenzahler,  Timer  B  (MFP)  als  878,  1065 

Bildwiederholfrequenz,  ST(E)-Mono-chrom-  827 

Binares  Realzahl-Format  (68882)  1023 

Binary  Real  Data  Format  (68882)  1023 

Bioskeys  (XBIOS  24)  100 

Biphase  Mark-/Space-Verf.  (SCC)  1 140 

Bit-Block-Transfer  789,  842  f. 

Bit-Image  563 
Bit-Planes  (Bit-Ebenen)  834 
BITBLK  563 
BITBLT  315 

Bitblt  (Bit  Block  Transfer)  ($A007)  314 

BitBlt-Funktion  841 

Bitmap-Zeichensatze  289 

Bitorientierte  Steuerungsverfahren  (SCC)  1138 

Bitsynchronismus  1136 

Bitwanderungen  (Disk)  969 

BLACK  (1)  558 

Blitmode  (XBIOS  64)  101 

Blitter  55,  101,  789,  841,  845,  1363 

Blitter  (STE)  1285 

Blitter-TOS  802 

Blitter,  Einbindung  in  ST/STE-Hardware  856 
Blitter,  Registerzugriffe  843 
Block- Anzahl  (ACSI)  991 
Block-Nummer  (ACSI)  990 
Blockadresse,  Log.  1085,  1088 
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BlockgroBe  (SCSI)  1088 
Blocktnodus  (ACSI)  987 
Blockschaltbiid  des  ST  791 
BLUE  (4)  558 

Bombchen  51 ,  54,  58,  96,  252,  304 

Bombengirlanden  57 

_bootdev  ($446)  61,  539,  708 

Bootsektor  15, 17,  38, 64, 140,  162 

Bootvorgang  44 

BPB  14,88,162 

BR  (68030)  1008 

BR  (Megabus)  824 

BR0.  .BR3  (VME-Bus)  1 1 89, 1 192 

Braner,  Moshe  82 

BREAK  (ACIA)  913 

BREAK  (SCC)  1158 

BREAK-Code  (IKBD)  931 

Break-Point  51 

Break-Zeichen  (ser.  Dateniibertragung)  899 

BSS  186 

BSY  (SCSI)  1076 

_bufl  ($4B2)  66 

Bug  bei  READ  TRACK  (FDC)  973 

Bug  im  ACSI-DMA-Baustein  1000 

Bug  im  Hostadapter  der  SH204  998 

BuginRsconf  903 

Burst-fill-Modus  (68030)  1007, 1012 

Burst-mode  (68030)  1044 

Bus- Arbitration  (VME-Bus)  1 1 90 

Bus-Ausnahmesteuerung  (68030)  1008 

Bus  Busy  (VME-Bus)  1189 

Bus  Clear  (VME-Bus)  1 189 

Bus  Error  (68030)  1008 

Bus  Error,  (Megabus)  824 

Bus-Fahrplan  (ACSI)  984 

BUS  FREE-Phase  (SCSI)  1078 

Bus  Grant  (68030)  1008 

Bus  Grant  (Megabus)  822 

Bus  Grant  (VME-Bus)  1189 

Bus  Grant  Acknowledge  (68030)  1008 

Bus  Grant  Acknowledge  (Megabus)  822,  825 
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Bus  Grant  Out  (Megabus)  822,  824 
Bus  Interface  Unit  (68882)  1022 
Bus-Phasen  (ACSI)  984 
Bus-Phasen  (SCSI)  1077 
Bus  Request  (68030)  1008 
Bus  Request  (Megabus)  821,  824 
Bus  Request  (VME-Bus)  1 1 89 
Bus-Steuersignale  (68030)  1005 
Busbetriebsarten  (68030)  1003 
Busfehler  ($8)  51 

Busfehler  von  SCSI-DMA-ControIler  (TT)  1064 
Busmaster,  Megabus-  821 
BUSY  (SCSI)  1076 

BUSY-Bit  (BLITTER,  Adr.  $FF  8A3C)  855 
BUSY-Leitung  (par.  Schnittstelle)  907 
BUSY-Leitung  an  MFP  869,875 
BUSYBEE  (2)  667 

Buszuteilung  (68030),  Steuersignale  fur  die  1008 
Buszyklus  (68030)  1005, 1012 
Buszyklus,  (Megabus)  822 
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C/D  (SCSI)  1077 
Cache  (68030)  1012 

Cache  Address  Register  (CAAR)  (68030)  1013 

Cache  Burst  Acknowledge  (68030)  1007 

Cache  Burst  Request  (68030)  1007 

Cache  Control  Register  (CACR)  (68030)  1013 

Cache  Disable  (68030)  1 009 

Cache  Inhibit  (68030)  1007 

Cache,  Mega  STE  1368 

Cache-Prinzip  1012 

Cache-Speicher  (RAM)  1044 

Cache-Steuersignale  (68030)  1007 

CACHENNN.PRG  171 

Carrier  detect  55 

Cartridge-AdreBraum  805 

Cartridge-Anschlusses,  Belegung  des  807 

Cartridge- Application-Header  810 

Cartridge-Konzept  807 

Cartridge-Port  806 

Cartridge-Programme  806,  809  ff.,  1045 
Cartridge-ROM  806 
Cartridge-Slot  807 

Cartridge,  Schaltung  fur  ein  128  KByte-  808 
Cartridgeport  beim  TT  1045 
CAS  796 

Cauxin  (GEMDOS  3)  205 
Cauxis  (GEMDOS  18)  206 
Cauxos  (GEMDOS  19)  207 
Cauxout  (GEMDOS  4)  208 
CA_SIZE  (Cartridge)  812 
CBACK  (68030)  1007 
CBREQ  (68030)  1007 
Cconin  (GEMDOS  1)  209,219 
Cconis  (GEMDOS  11)  210 
Cconos  (GEMDOS  16)  210 
Cconout  (GEMDOS  2)  211,219 
Cconrs  (GEMDOS  10)  212 
Cconws  (GEMDOS  9)  214 
CD-ROM  981 
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CDB  (SCSI)  1086,1088 
CD1S  (68030)  1009 
CELL  ARRAY  (VDI  10)  301,355 
Centronics-Interface/-Timing  907 

Centronics-Schnittstelle  55,  69,  83  f.,  86,  154, 161, 216,  861,  907 
CHANGE  GEM  VDI  FILE  NAME 
(VDI  5,  Escape  100)  528 

CHECK  CONDITION-Status  (SCSI)  1083, 1085,  1090 
Check  status  of  standard  AUX:  input 
206 

Check  status  of  standard  AUX:  output  207 

Check  status  of  standard  input  210 

Check  status  of  standard  output  210 

Check  status  of  standard  PRN:  216 

CHECKED  (0x0004)  558,663 

Chip  Select  (ACSI)  984 

CHK-Befehl  ($18)  52 

CHN  (68030)  1007 

CIOUT  (68030)  1007 

CIRCLE  (VDI  11,  GDP  4)  365 

CLEAR  DISPLAY  LIST  (VDI  5, 

Escape  22)  503 
Clear  screen  (and  home  cursor) 

(VT52  ESC  E)  8 

Clear  to  end  of  line  (VT52  ESC  K)  8 

Clear  to  send  (CTS)  55,  893 

Clear  To  Send-Bit  (ACIA)  914 

CLEAR  WORKSTATION  (VDI  3)  340, 501,  503 

Clipboard  572,  670  ff.,  751 

Clipping  280, 285,  346,  565,  631, 638 

CLK  (Megabus)  822 

CLOSE  (0x0002)  678,693 

Close  file  228 

CLOSE  VIRTUAL  SCREEN  WORKSTATION  (VDI  101)  339 
CLOSE  WORKSTATION  (VDI  2)  336 
Cluster  14,  88,  162 
CLUT  283 

_cmdload  ($482)  42,  64 
Cnecin  (GEMDOS  8)  215 

Codierungsverfahren  fur  Datensignale  (SCC)  1 1 39, 1 162 
Color  indirection  835 
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Color-Lookup-T able  283 
colorptr  ($45 A)  48,  63 
colorX  (TT,  ab  Adr.  $FF(FF)  8240)  1056 
Command-Bytes  (ACSI)  999 
Command-Code  (SCSI)  1087 
Command  Descriptor  Block  (ACSI)  989 
Command  Descriptor  Block  (CDB)  (SCSI)  1086 
Command  line  244 
Command-Phase  (ACSI)  984, 986 
Command-Phase  (SCSI)  1080 
COMMAND.PRG  64 
Common-Commands  (MIDI)  918 
CON:  64,  83  ff.,  161,237 
conterm  ($484)  9,  1 1,  64,  72,  83,  209 
CONTOUR  FILL  (VDI  103)  357 
Control  Byte  (ACSI)  991 
Control  Byte  (SCSI)  1088 
Control/Data  (SCSI)  1077 
Controller  (ACSI)  982 
Controller-Access-Register 
(Adr.  $FF  8604)  817,987,989 
Controller  execute  (IKBD  $22)  941 
Controller  Read/Write  (FDC/ACSI-DMA)  816 
Conversion  Unit  (CU)  (68882)  1022 
con_state  ($4A8)  9,  65 
Cookie  Jar  72,  743 
COORDINATE  WINDOW 
(VDI  5,  Escape  99,  Opcode  1)  526 
Coprocessor  Interface  Register  (68882)  1026 
Coprozessor  (68881)  1331 
Coprozessor  (68882)  1019 
Coprozessor-Befehlswort  (68881)  1334, 1336 
Coprozessor-Interface-Register  (68882)  1019 
Coprozessor-Interface-Register  (CIR)  (6888 1 )  1331 
Coprozessor-Operationen  (68030)  1005 
Coprozessor-Protokoll  (68881)  1333 
Coprozessorbefehle  (68882)  1026 
Copy  raster  form  ($ A00E)  319 
COPY  RASTER,  OPAQUE  (VDI  109)  415 
COPY  RASTER,  TRANSPARENT 
(VDI  121)  418 
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CP/M  275 

CP/M68K  159 

Cpmos  (GEMDOS  17)  216  f. 

Cpmout  (GEMDOS  5)  217 
_CPU  78 

CPU  address  space  (68030)  1005 
CPU-Root-Pointer  (68030)  1016 
CPX  717  ff. 

CPXHEAD  719 

CPXINFO  717,724,726 

cpx_button  731 

cpx_call  728 

cpx_close  732 

cpx_draw  729 

cpx_hook  732 

cpxjnit  727 

cpxjkey  730 

cpx_ml  731 

cpx_m2  731 

CPX_Save  742 

cpx_timer  730 

cpx_wmove  729 

Crawcin  (GEMDOS  7)  215,  218 

Crawio  (GEMDOS  6)  219 

CRC-Bytes  (Disk)  948 

CRC-Priiflogik  (SCC)  1144 

CRC-Verfahren  (Dateniibertragung)  1138 

CREATE  BASEPAGE  258 

CREATE  BASEPAGE,  RESPECTING  PRGFLAGS  260 

Create  directory  220 

Create  file  229 

Critical  error  handler  704 

criticret  ($48A)  65 

CROSSED  (0x0002)  558,663 

CRP  (68030)  1016 

crys_if  590 

CS(ACSI)  984 

CTRL-Codes  212,215 

CTS(ACIA)  914 

CTS  (Clear  to  send)  55,  893 

CTJKEY  (53)  547,726,739 
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CT_MOVE  (5 1)  547 
CT_NEWTOP  (52)  547 
CTUPDATE  (50)  547 
Cursconf  (XBIOS  21)  102 
Cursor  backward  (VT52  ESC  D)  7 
Cursor  down  (VT52  ESCB)  7 
Cursor  forward  (VT52  ESC  C)  7 
Cursor-Position  65 
Cursor  up  (VT52  ESC  A)  7 
Cl®S  JBLINK  (2)  102 
CURS_GETRATE  (5)  102 
CURS_HIDE  (0)  102 
CURS_NOBLINK  (3)  102 
CURS_SETRATE  (4)  102 
CURS_SHOW  (1)  102 
Custom-Chips,  ST-  788 
CYAN  (5)  558 

Cyclic  Redundancy  Checking  (Disk)  949 
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D 

Daisy-Chaining  (Megabus)  822 
Daisy-Chaining  (VME-Bus)  1190 
Das  Boot  20 
DATA  186 

Data-address-mark  (DAM)  (Disk)  948, 968 
Data  Buffer  Enable  (68030)  1006 
Data  Carrier  Detect  893,  913  f. 

Data  Carrier  Detect  (DCD,  ACIA)  55 
Data-Direction-Register  (TT-MFP, 

Adr.  $FF(FF)  FA85)  1064 
Data-In/-Out-Phase  (ACSI)  988 
DATA  IN/OUT-Phase  (SCSI)  1080, 1082 
Data  Request  (FDC)  968 
Data  Strobe  (68030)  1006 
Data  Terminal  Ready  (SCC)  1 158 
Data  Terminal  Ready  (ST-MFP-USART)  893 
Data  Transfer  ACKnowledge  (Megabus)  823 
Data  Transfer  ACKnowledge  (VME-Bus)  1188 
Data  Transfer  and  Size  Acknowledge  (68030)  1006 
Datei-Attribut  165,  227 
Datei-Attribut,  “hidden”  227,  229,  247,  652 
Datei-Attribut,  Archiv-Bit  227,  247 
Datei-Attribut,  Diskettenname  247 
Datei,  versteckte  227,  229,  247,  652 
Dateiauswahlbox  574,  673,  675,  753 
Dateibezeichnungen  159 
Dateiende  209,  212 
Dateikennung  173, 231 
Dateiname  159 

Dateinamen,  erlaubte  Zeichen  160 
Dateisystem  159 

Daten  Transfer  Bus  (VME-Bus)  1185,  1187 
Datenaustausch  (Computer  <->  Disk)  949 
Datenbus  793,  796 
Datenbus  (68030),  32-Bit-  1005 
Datenbus  (Megabus)  823 
Datenbus  (SCSI)  1077 
Datenbus  (TT-ROM),  32-Bit-  1037 
Datenbus  (TT),  64-Bit-Memory-  1039 
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Datenby tes  (MIDI)  917 

Datenendeinrichtung  (DEE)  892 

Datenpaket  (IKBD)  935 

Datenrichtungsregister  (IKBD)  929 

Datenseparator  (FDC)  947,  956 

Dateniibermittlungs-Steuerungsverfahren  (SCC)  1135 

Datenubertragung  (ACSI)  999 

Datenubertragung  (par.  Schnittstelle)  907 

Dateniibertragung  (SCC)  1135 

Datenubertragung  mit  ACIAs,  serielle  911 

Dateniibertragung  vom  IKBD  stoppen  938 

Datenubertragung,  asynchrone  892 

Datenubertragung,  interruptgesteuerte  895 

Datenubertragung,  MIDI-  917 

Datenubertragung,  synchrone  891 

Dateniibertragungsrate  (IKBD)  927 

Datenubertragungsrate  (Keyboard/Midi- ACIA)  9 1 1 

Dateniibertragungsrate  (SCC)  1135 

Datenubertragungsrate  (ST-MFP-USART)  894 

Datenubertragungsrate  (STE-MICRO-WIRE(TM)-Interface)  1309 

Dateniibertragungsraten  (ser.  Schnittstelle)  903 

Datum  122,153,231 

dbaseh  (Adr.  $FF  8201)  839, 1055,  1315 

dbasel  (Adr.  $FF  8203)  839, 1055, 1316 

dbaselow  (Adr.  $FF  820C)  1055, 1316 

DBEN  (68030)  1006 

DCD  (Data  carrier  detect)  893,  913  f. 

Dcreate  (GEMDOS  57)  220 

Ddelete  (GEMDOS  58)  221 

DDR  (ST-MFP,  Adr.  $FF  FA05)  872 

DDR  JT  (TT-MFP,  Adr.  $FF(FF)  FA85)  1064 

DEFAULT  (0x0002)  556 

Defect  Descriptor  (SCSI)  1098 

Defektliste  (SCSI)  1096,  1098, 1101 

defshiftmd  ($44A)  48,62 

Delay  Mode  (MFP-Timer)  874 

Delete  directory  221 

Delete  file  232 

Delete  line  (VT52  ESC  M)  8 

Density  (FDC)  950 

Descriptor  type  (DT)  (68030)  1016 
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Desktop  483, 599 
Desktop-Fenster  580 
DESKTOP.INF  539,705 

Destination-Adress-Register  (BLITTER,  Adr.  $FF  8A32)  849 

Destination-X-Increment-Register  (BLITTER,  Adr.  $FF  8A2E)  848 

Destination- Y-Increment-Register  (BLITTER,  Adr.  $FF  8A30)  848 

Device-Nummmer  (ACSI)  990 

Dezimal  Gepacktes  Realzahl-Format  (68882)  1025 

Dfree  (GEMDOS  54)  222 

Dgetdrv  (GEMDOS  25)  161, 223 

Dgetpath  (GEMDOS  71)  161 , 224 

DIABLO  11,183 

Dialogbox  753,764,776 

Die  Zahl  schlechthin  17 

Digital  Phase  Locked  Loop-Einheit  (SCC)  1 135, 1 166 
Digital/Analog-Wandler  (STE)  1294 
DIP-Switch  80 
DIR  164 

DIRECT  ALPHA  CURSOR  ADDRESS  (VDI 5,  Escape  1 1)  492 

Direct  Memory  Access  813 

Disable  cursor  (VT52  ESC  1)  9 

Disable  joysticks  (IKBD  $1  A)  940 

Disable  mouse  (IKBD  $12)  938 

DISABLE  OR  ENABLE  FILM  EXPOSURE  FOR  FRAME  PREVIEW  (VDI  5,  Escape 
93)  520 

DISABLED  (0x0008)  558, 652,  663 
Discard  at  end  of  line  (VT52  ESC  w)  9 
disked  (Adr.  $FF  8604)  817  f„  977,  999 
Diskette  945 
Diskettenformat  17 
Diskettenlaufwerk  66, 953 
Diskettenname  227, 229,  247 
Diskettenwechsel  21,  64,  92,  166, 953,  1114 
DISK1NFO  222 
Disklaufwerk,  3,5-Zoll-  945 
Disklaufwerk,  Anschliisse  am  949 
Disklaufwerk,  Schaltbild  954 
Dispatcher  54  f.,  299,  536 
Display-List  341 
DIV  52 

Division  durch  Null  ($14)  52 
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DMA  813 

DMA-Base-  und  Counter-Register 
(ab  Adr.  $FF  8609)  817,  976,  999 
DMA-Baustein  (BLITTER)  842 
DMA-Betrieb  (FDC/ACSI-DMA)  817 
DMA-Datenbus  814 
DMA-Datentransfer  (ACSI)  984 
DMA-Datentransport-Richtung,  Bit  fur  die  819 
DMA-Einheit  789,  813  f.,  981,  1352 
DMA-Einheit  (FDC)  957, 974, 976 
DMA-Einheit  (TT-SCSI)  1 1 24 

DMA-Mode-Register  (Adr.  $FF  8606)  819,  977,  987,  989,  999 
DMA-Operation  818, 1000 
DMA-Sector-Counter-Register 
(Adr.  $FF  8604)  999 
DMA-Sound  1212, 1286,  1296, 1361 
DMA-Sound,  Beispiellisting  1301 
DMA-Sound,  Schaltungsauszug  1307 
DMA-Status-Register  (Adr.  $FF  8606)  818, 978 
dmahigh,  Adr.  $FF  8609  817, 976 
dmalow,  Adr.  $FF  860D  817,  976 
dmamid,  Adr.  $FF  860B  817,  976 
DMAread  (XBIOS  42)  23, 103 
DMAwrite  (XBIOS  43)  23, 104 
DNARROW  (0x0080)  678,693 
Doppelklick  756 
Dosound  (XBIOS  32)  105 
DOSTIME  231 

Double  Real  (68882)  1023,  1027 
dpi  279 

DPLL  (SCC)  1135,  1145, 1166 
Draw  sprite  ($A0OD)  319 
DRAW3D  (0x0080)  558 
Drive  select  (FDC)  951,953,955,975 
Drive  select  (TT-PSG)  1211 
Drive-Select-Leitung  (PSG)  866 
Drive  Status  Block  (DSB)  959 
Drive-Status-Block  (TT)  1214 
Drop-Down-Menu  748  f.,  766 
DRQ  (ACSI)  984 
Drucker  154,  217 
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Drucker-Timeout  216 
Druckertreiber  321,331,341 
_drvbits  ($4C2)  14,66 
Drvmap  (BIOS  10)  14,87 
DS (68030)  1006 
DS0/DS1  (VME-Bus)  1188 
DSACKO,  DSACK1  (68030)  1006 
DSACK0,  DSACK1  (68882)  1019 
Dsetdrv  (GEMDOS  14)  87, 161,  225 
Dsetpath  (GEMDOS  59)  161, 226 
_dskbufp  ($4C6)  66 

DsCAddr  (BLITTER,  Adr.  $FF  8A32)  849 
Dst_Xinc  (BLITTER,  Adr.  $FF  8A2E)  848 
Dst_Yinc  (BLITTER,  Adr.  $FFF  8A30)  848 
DTA  186,235,244,246 
DTACK  (Megabus)  824 
DTACK  (VME-Bus)  1188 
DTR  (Data  terminal  ready)  893 
DTR(SCC)  1158 
_dumpflg  ($4EE)  142 
Duochrom-Modus  (TT-Video)  1048 
Duplicate  file  handle  233 
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E 

EACCDN  (-36)  203 
EBADRQ  (~5)  38 
EBADSF  (-16)  39 
ECS  (68030)  1005 
EDITABLE  (0x0008)  557,652 
EDRTVE  (-46)  203 
EDRVNR  (-2)  38 
EDVNRSP  (-19)  39 
EFILNF  (-33)  202 
EGENRL  (-12)  39 
EgetPalette  (XBIOS  85)  106 
EgetShift  (XBIOS  81)  107 
EGSBF  (-67)  204 
EIHNDL  (-37)  203 
EIMBA  (-40)  203 

Ein-/Ausgabeumlenkung  174,  209,  234 

Ein-Pegel  bei  MFP-Timer-Eingangen  875 

Einfachklick  756 

Eingange  (STE),  analoge  1286 

BINSERT  (-18)  39 

EINTRN  (-65)  204 

EINVFN(-32)  202 

Einzelblattpapier  154 

Einzelby te-Transfer  (ACSI)  986 

ELLIPSE  (VDI 11,  GDP  5)  367 

ELLIPTICAL  ARC  (VDI  11,  GDP  6) 

369 

ELLIPTICAL  PIE  (VDI  1 1 ,  GDP  7)  37 1 
EMEDIA  (-7)  38 
EMLNE  (-59)  203 
Empfangen  von  IKBD-Daten  935 
Empfanger  (ACIA)  911 
Empfangspuffer  (MFP-USART)  895 
Empfangsregister  (ACIA)  911,914 
Empfangsregister  (IKBD)  927 
Empfangsregister  (MFP-USART)  895 
Empfangsregister  (MIDI-ACIA, 

Adr.  $FF  FC06)  915 
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Empfangsregister  (Tastatur-ACIA, 

Adr.  $FF  FC02)  915 
Empfangsschieberegister  (ACIA)  911 
Empfangsschieberegister  (MFP-USART)  895 
Empfangsschieberegister  (SCC)  1144 
Empfangstakt  (ST-MFP-USART)  894 
Emulator-Unterstiitzung  (68030)  1009 
Enable  Clock  (Megabus)  824 
Enable  cursor  (VT52  ESC  e)  9 
END  DRAW  AREA  PRIMITIVE  (81)  524 
END  GROUP  (11)  524 
End  of  file  209,212 
End-of-Interrupt-Modus  (MFP)  888 
Endlospapier  154 
ENDMASK  (BLITTER)  845  f. 

END_MCTRL  (2)  691 
end_os  ($4FA)  42, 69 
END_UPDATE  (0)  691 
ENHNDL  (-35)  203 
ENMFIL  (—49)  203 
ENSAME  (-48)  203 
ENSMEM  (-39)  203 
ENTER  ALPHA  MODE  (VDI 5, 

Escape  3)  484 

Enter  reverse  video  mode  (VT52  ESC  p)  9 

Envelope  (PSG)  860 

Environment  66,  191,  539,  707 

EOTHER  (-17)  39 

EPAPER  (-9)  38 

EPLFMT  (-66)  204 

Epson  154 

EPTHNF  (-34)  202 

ERANGE  (-64)  204 

Erase  beginning  of  display  (VT52  ESC  d)  8 
Erase  beginning  of  line  (VT52  ESC  o)  9 
Erase  entire  line  (VT52  ESC  1)  9 

ERASE  TO  END  OF  ALPHA  SCREEN  (VDI  5,  Escape  9)  490 
ERASE  TO  END  OF  ALPHA  TEXT  LINE  (VDI  5,  Escape  10)  491 
Erase  to  end  of  page  (VT52  ESC  J)  8 
EREADF  (-11)  39 
Ereignispuffer  538,  596  f. 
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Ereigniszahler  (par.  Schnittstelle)  910 
Ereigniszahler,  MFP-Timer  als  877 
ERLCKD  (-58)  203 
ERROR  (-1)  38 

Erweiterungskarte  (Mega  ST)  820 
ESCAPE  (VDI 5)  481 
ESCAPE  2000  (VDI  5,  Escape  2000)  53 1 
ESECNF  (-8)  38 
EsetBank  (XBIOS  82)  107  f.,  1 12 
EsetColor  (XBIOS  83)  109 
EsetGray  (XBIOS  86)  107,  1 10,  1 12 
EsetPalette  (XBIOS  84)  111 
EsetShift  (XBIOS  80)  112 
EsetSmear  (XBIOS  87)  107,  1 12  f. 
etv_critic  ($404)  59,  198,  704 
etv_term  ($408)  59, 200,  212,  266 
etvjimer  ($400)  59,  197 
etv_xtra  ($40C)  59 
Eulersche  Zahl  e  (68882)  1027 
EUNCMD  (-3)  38 
EUNDEV  (-15)  39 
Event-Count-Mode  (MFP-Timer)  877 
Event-CPX  717 

EVNT_BUTTON  (AES  21)  608,615 
EVNT_DCLICK  (AES  26)  618 
EVNT_DCLICKS  (AES  26)  618 
evnt_evnt()  617 

EVNT_KEYBD  (AES  20)  607, 615 
EVNT_MESAG  (AES  23)  612,615 
EVNT_MOUSE  (AES  22)  610,615 
EVNT_MULTI  (AES  25)  614 
EVNT  TIMER  (AES  24)  537,613 
EWRITF  (-10)  38 
EWRPRO  (-13)  39 
Exception  51,54,58,96,252,304 
Exception  Enable  byte  (ENABLE)  (68882)  1032 
Exception  Status  Byte  (EXC)  (68882)  1034 
Exception  vectors  1010 

EXCHANGE  BUTTON  CHANGE  VECTOR  (VDI  125)  450 
EXCHANGE  CURSOR  CHANGE  VECTOR  (VDI  127)  453 
EXCHANGE  MOUSE  MOVEMENT  VECTOR  (VDI  126)  452 
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EXCHANGE  TIMER  INTERRUPT  VECTOR  (VDI 118)  445 
exec_os  ($4FE)  42,  69,  539, 709 
EXIT  (0x0004)  557,652 
EXIT  ALPHA  MODE  (VDI  5,  Escape  2)  483 
Exit  reverse  video  mode  (VT52  ESC  q)  9 
Exklusiv-Commands  (MIDI)  918 
Extended  Access  (VME-Bus)  1 188 
EXTENDED  INQUIRE  FUNCTION 
(VDI  102)  334,  377,  384, 456 
Extended  Precision  Format  (68882)  1023 
Extended  Real  (68882)  1024,  1027 
Extended  Sense  (SCSI)  1092 
Extent-Descriptor-List  (ACSI)  996 
External  Cycle  Start  (68030)  1005 
exteme  (Video-)Synchronisation  beim  ST  839 
Extra  High  Density  80 
E_CHNG  (-14)  39,166 
E_CRC(~4)  38 
E_OK  (0)  37,202 
E_SEEK  (-6)  38 
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Farbpalette  151,  1352 
Farbregister  150,  835,  838, 1056, 1058 
FAST-MCU  (TT)  1044 
FAST-RAM  182, 194, 1039, 1042 
Fast-RAM-Puffer  79 
FAST-RAM-Erweiterungskarte  1043 
Fastload  194,  252 
FASTLOAD-EPROMS  966 
FAT  (File-allocation-table)  14,  88, 162 
Fattrib  (GEMDOS  67)  166,227 
FA_  ARCHIVE  (0x20)  165 
FA_ATTRIB  (0x17)  246 
FAJHIDDEN  (0x02)  165 
FA_READONLY  (0x01)  165 
FA_SUBDIR  (0x10)  165 
FA_SYSTEM  (0x04)  165 
FAJVOLUME  (0x08)  165 
FBAS-Signal  830 
FBcc (68881)  1343 
FC0,  FC1 ,  FC2  (Megabus)  823 
FC0..FC2  (68030)  1005 
Fclose  (GEMDOS  62)  228 
Fcreate  (GEMDOS  60)  165,  228  f. 
Fdatime  (GEMDOS  87)  231 
FDBcc  (68881)  1341 
_FDC  22,  80,  1 14,  140,  947,  949,  956 
FDC(TT)  1214 
FDC-Chip,  Registerauswahl  816 
FDC-Command-Register  960,  978 
FDC-Data-Register  959,  978 
FDC-Feature  958 
FDC-Kommandos  960 
FDC-Kommandos,  Typ  I-  961 
FDC-Kommandos,  Typ  n-  966 
FDC-Kommandos,  Typ  III-  969 
FDC-Kommandos,  Typ  IV-  973 
FDC-Operation  mit  DMA  975 
FDC-Programmierung  974 
FDC-Register  958,974 
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FDC-Register-Durchgriff  817 
FDC-Schaltungsauszug  957 
FDC-Sector-Register  959 
FDC-Status-Register  9601,978 
FDC-Track-Register  958 
Fdelete  (GEMDOS  65)  232 
Fdup  (GEMDOS  69)  174,233 
Feedback  763 
Fehler,  intemer  204 
Fenster-Attribut  677 
Fensterattribute  578 
Fensterfarben  580 
Fensterverwaltung  772 
Fforce  (GEMDOS  70)  174,  233  f. 

Fgetdta  (GEMDOS  47)  235,  246 
fifo  (Adr.  $FF  8606)  818,  978, 999 
FIFO-Buffer  (ACSI)  992,999 
FIFO-Buffer  (FDC)  976 

FIFO-Buffer  (SCC),  Condition-/Daten-/Frame-Status-  1 144 
FIFO-Buffer  (STE-Sound)  1306 
Fifo-Buffer  loschen,  DMA-  819 
FIFO,  DMA-  814 
File  handle  173,231 
File-Locking  201 
File-Selektor  574,  673, 675,  753 
FILL  RECTANGLE  (VDI 114)  358 
FILLED  AREA  (VDI 9)  353,358 
Filled  polygon  (SA006)  3 1 3 
Filled  rectangle  ($A005)  312 
FILLED  ROUNDED  RECTANGLE 
(VDI  11,  GDP  9)  374 
Finescrolling  (STE)  1315,1318 
Fire-Button  (IKBD)  929 
Fire-Button-Informationen  (STE)  1289 
FIS  JHATCH  (3)  408 
FIS_HOLLOW  (0)  408 
FIS_PATTERN  (2)  408 
FIS_SOLED  (1)  408 
FIS_USER  (4)  408 
Fitt  746 

FLAG  (SDLC/HDLC-Verfahren)  1 1 39, 1 1 56 
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FlieBkomrnaarithmetik  (68882)  1019,  1023 
_FLK  81,201,230,236,238 

Floating  Point  Condition  Code  Byte  (FPCC)  (68882)  1033 

Floating  Point  Control  Register  (FPCR)  (68882)  1032 

Floating  Point  Coprocessor-Karte  (Megabus)  825 

Floating  Point  Instruction  Address  Register  (FPIAR)  (68882)  1035 

Floating  Point  Processor  MC6888 1  1374 

Floating  Point  Register  (68882)  1022 

Floating  Point  Status  Register  (FPSR)  (68882)  1030,  1033 

Floating  Point  Unit  (68882)  1019 

flock  ($43E)  60,  79,  964,  975,  999 

Hock  (GEMDOS  92)  —  Lock  file  236 

Hopfmt  (XBIOS  10)  22,114 

Floppy  Disk  Controller  947,  949, 1354 

Floppy  Disk  Controller  Select  (FDC/ACSI-DMA)  816 

Hoppy  Disk  Interface  (TT)  1214 

Floppy-Disk-Lock  (flock,  Adr.  $43E)  60,  79,  964,  975,  999 

Floprate  (XBIOS  41)  60,  1 16 

Floprd  (XBIOS  8)  17,118 

Hopver  (XBIOS  19)  17,119 

Hopwr  (XBIOS  9)  17, 22, 120 

FM0-/FM 1  -  Verfahren  1140,1162 

FMD_FINISH  (3)  642 

FMD„GROW(l)  642 

FMD_SHRINK  (2)  642 

FMD_START  (0)  642 

FMOVE  (68882)  1026 

FMOVEFPcr  (68881)  1338 

FMOVE  from  FPn  (68881)  1338 

FMOVECR  (68881)  1337 

FMOVECR  (68882)  1027 

FMOVEM  (68882)  1027 

FMOVEMFPcr  (68881)  1339 

FMOVEM  FPn  (68881)  1339 

FNOP  (68881)  1343 

Folder  202,  220  f„  227,  247 

FOLDR100.PRG  44,181 

Font  287,  316, 402, 472, 477,  530 

FONTHDR  291 

Fopen  (GEMDOS  61)  161,  228  f.,  237 
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Force  Extra  Source  Read  (BLITTER, 

Adr.  $FF  8A3D)  853 
Force  file  handle  234 
Force  Interrupt  (FDC)  960,  973 
FORM  ADVANCE  (VDI 5,  Escape  20)  50 1 
Form-CPX  717 
form  height  289 
form  width  289 
Format-Code  (ACSI)  997 
Format  drive  (ACSI)  994 
Format-Parameter  (SCSI-MODE  SELECT)  1 1 10 
FORMAT  UNIT  (SCSI)  1095 
Formatierung  (Disk)  1 14,  949, 970,  972 
Formatparameter  (68882)  1027 
FORM_ALERT  (AES  52)  643 
FORM_BUTTON  (AES  56)  568, 651 
FORM_CENTER  (AES  54)  647 
FORMJDIAL  (AES  51)  641,647 
FORM_DO  (AES  50)  556,  640 
FORM_ERROR  (AES  53)  645 
FORMJiEYBD  (AES  55)  568,649 
FP-Datenregister  (68881)  1333 
JFPU  78 
FPU  (68882)  1019 
FPU-Befehlsnummer  (68881)  1336 
FPU-Command-Register  (68881,  Adr. 

$FF  FA4A)  1333 

FPU-Command-Word  (68881)  1336 
FPU-Condition-Register  (68881,  Adr. 

$FF  FA4E)  1333 
FPU-Control-Register  (68881,  Adr. 

SFFFA42)  1332 

FPU-Instruction  Address-Register  (68881,  Adr.  $FF  FA58)  1333 
FPU-Konstanten-ROM  (68881)  1337 
FPU-Operand-Register  (6888 1 ,  Adr. 

$FF  FA50)  1333 
FPU-Register  538 

FPU-Register  select-Register  (68881,  Adr.  $FF  FA54)  1333 
FPU-Response  primitives  (68881)  1344 
FPU-Response-Register  (6888 1 ,  Adr. 

$FF  FA40)  1332 
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FPU-Restore-Register  (68881,  Adr. 

SFFFA46)  1333 
FPU-Save-Register  (68881,  Adr. 

$FF  FA44)  1333 

Frame  (SDLC/HDLC-Verfahren)  1138 
Frame  (STE-DMA-Sound)  1296 
Frame-Address-Counter  (STE,  ab  Adr, 

$FF  8908)  1297 

Frame-End-Adresse  (STE,  ab  Adr. 

$FF  890E)  1297 

Frame-End-Signal  (STE)  1299,  1305 
Frame-Start-Adresse  (STE,  ab  Adr. 

$FF  8902)  1297 
Framing  Error-Bit  (ACIA)  914 
_FRB  79 

Jrclock  ($466)  48,63 

Fread  (GEMDOS  63)  240 

Frename  (GEMDOS  86)  241 

Frequenzeinstellung  (PSG)  862 

FRESTORE  (68882)  1031 

FSAVE  (68882)  1031 

FScc  (68881)  1340 

Fseek  (GEMDOS  66)  242 

FSEL_EXINPUT  (AES  91)  574, 673,  675,  753 

FSELJNPUT  (AES  90)  574,  673, 675,  753 

Fsetdta  (GEMDOS  26)  244,246 

Fsfirst  (GEMDOS  78)  235,  244  f.,  248 

FSINCOS  (68881)  1337 

FSINCOS  (68882)  1028 

FSMGDOS  288 

Fsnext  (GEMDOS  79)  235,  244,  248 

FTRAPcc  (68881)  1342 

FTRAPcc  (68882)  1031 

FULL  (0x0004)  678,693 

Fullattribut  353,  360,  363,  365,  367,  371,  374,  465 

Fullfarbe  411 

Fullmuster  413 

Funktionscode  (68030)  1005 

Funktionscode  (Megabus)  823 

FUNNEL  (TT)  1039,  1053 

future  catastrophes  39 
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Jfverify  ($444)  17,61 

Fwrite  (GEMDOS  64)  249 

FXSR  (BLITTER,  Adr.  $FF  8A3D)  853 
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Ganzzahl-Format  (68882)  1023 
GAP  (Disk)  971 
GDOS.PRG  286, 295,  316,  330 
GDP  332,359 
GEM  Draw  523 
GEM-Versionen  533 
GEMDOS-Bindings  202 
GEMDOS-Dateisystem  161 
GEMDOS-Erweiterungen  200 
GEMDOS-Fehler  645 
GEMDOS-Pool  180,251 
GEMDOS-Puffer  170 
GEMDOS-Vcktoren  197 
GEMDOS-Versionsnummer  269 
GEMFILE.GEM  528 
Gemini  10,547 
GEM_MUPB  42 

General-Purpose-I/O-Port  (GPIP)  (ST)  869, 87 1 

GENERALIZED  DRAWING  PRIMITIVE  (GDP)  (VDI 11)  359 

GENERATE  SPECIFIED  TONE  (VDI  5,  Escape  61)  51 1 

GENLOCK-Anwendungen  (STE)  1285,  1313 

Geratetreiber  287,  330 

Get  current  directory  224 

Get  date  270 

Get  default  drive  223 

Get  drive  free  space  222 

Get  DTA  235 

Get  pixel  ($  A002)  3 1 1 

GET  PIXEL  (VDI  105)  423 

Get  time  271 

Get  version  number  269 

Get/Set  file  attributes  227 

Get/Set  file  timestamp  231 

Get/Set/Inquire  supervisor  mode  268 

Getbpb  (BIOS  7)  14,  88, 162,  166,  171 

getcookie  743 

GetFirstRect  740 

Getmpb  (BIOS  0)  60,65,89 

GetNextRect  740 
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Getrez  (XBIOS  4)  107,  L12, 121,  152 
Gettime  (XBIOS  23)  122 
Get_Buffer  743 
Gl-Chip  80,  105, 123, 138 
Giaccess  (XBIOS  28)  123 
giread  (PSG,  Adr.  $FF  8800)  861 
giselect  (PSG,  Adr  $FF  8800)  861 
giwrite  (PSG,  Adr.$FF  8802)  861 
GKS  275 

GLOBAL-Feld  542,  594  f. 

GLUE-Chip,  ST-  790,  804  f„  808,  822,  824 
gpip  (MFP,  Adr.  $FF  FA01)  869 
GPIP-Data-Register  (ST-MFP,  Adr. 

$FF  FA01)  869, 978,  987,  999 

GPIP-Data-Register  (TT-MFP,  Adr.  $FF(FF)  FA8 1 )  1063, 1 1 16 
GPU-Done-Signal  55,  870 
Grafik-Auflosung  62, 121,  152,  279,  1047 
Grafik-Cursor  427, 429, 443, 446  ff., 

452  f.,  499  f. 

Grafikbetriebsart  (ST(E))  836 
Grafikgrundfunktionen  332,  359 
Grafiksystem,  ST-  787,  827 
Grafiktablett  331,497 
GRAF_DRAGBOX  (AES  71)  655 
GRAF_GROWBOX  (AES  73)  658 
GRAF_HANDLE  (AES  77)  337,  540,  666 
GRAF_MBOX  (AES  72)  657 
GRAF_MKSTATE  (AES  79)  669 
GRAF_MOUSE  (AES  78)  667 
GRAF_MOVEBOX  (AES  72)  657 
GRAF_RUBBERBOX  (AES  70)  654 
GRAF_RUBBOX  (AES  70)  653 
GRAF_SHRlNKBOX  (AES  74)  660 
GRAF_SLIDEBOX  (AES  76)  664,  691 
GRAF_WATCHBOX  (AES  75)  662 
Graustufen  1 10 
GRECT  577 
GREEN  (3)  558 

Gruppe  0-Kommandos  (SCSI)  1089 
Gruppencode  (SCSI)  1087 
GSTMCU,  STE  788 
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GSX  275 
G_BOX  (20)  554 
G_BOXCHAR  (27)  555 
G_BOXTEXT  (22)  554 
G_BUTTON  (26)  554 
G_FBOXTEXT  636 
G_FBOXTEXT  (30)  555 
G_FTEXT  (29)  555,636 
G_IBOX  (25)  554 
G_ICON(31)  555 
G_IMAGE  (23)  554 
G_PROGDEF  554 
G_STRING  (28)  555 
G_TEXT  (21)  554 
G_TITLE  (32)  555 
G_USERDEF  778 
G_USERDEF  (24)  554 
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H 


H-Ablenkfrequenz,  ST(E)-Monochrom-  828 
H-Signal  bei  Colorbetrieb  (ST(E))  829 
H-Synchronimpulse  (ST(E))  838 
Hakchen  558,  620 

Halftone-Operation-Register  (BLITTER,  Adr.  $FF  8A3A)  849  f. 
Halftone-RAM  (BLITTER,  ab  Adr. 

$FF  8A00)  849 
HALT  (68030)  1008 
HALT  (Megabus)  823 
Handle  173,231 
Handshake  (ACSI)  985 
Handshake  (MIDI)  922 
Handshake  (SCSI),  REQ/ACK-  1081 
Handshake  (serielle  Schnittstelle)  870,  892,  904 
Handshaking  (par.  Schnittstelle)  907 
HARD  COPY  (VDI 5,  Escape  17)  498 
Hard  Disk  Controller  Select  (FDC/ACSI-DMA)  816 
Hardcopy  67,69,142,498 
Harddisk-Controller  (ACSI-Befehlssatz)  991 
Hardware-Register  (Kurziibersicht)  1349 
Hardware-Uhr  122,  153 
Hardwareerweiterungen  (TT),  kiinftige  1063 
Hardwareunabhangigkeit  782 
Harvard-Architektur  1003 
HBLANK-Interrupt  841,  882 
HD-Betrieb  22,  80,  950  f.,  958,  1214 

HD-Betrieb-Taktumschaltung  (TT/MEGA  STE,  Adr.  $FF(FF)  860E)  1216 

HD-Diskette  950,1214 

HDLC-Verfahren  1138,1158 

hdv_boot  ($47 A)  16,  20,  64 

hdvbpb  ($472)  16,64,88 

hdv_init  ($46A)  16,  60,  63,  94 

hdv_mediach  ($47E)  16,  64 

hdv_rw  ($476)  16,  64,  94 

Head  load  (FDC)  951 

HIDE  CURSOR  (VDI  123)  447 

Hide  mouse  ($ A00A)  308 ,  3 1 8 

HIDETREE  (0x0080)  557 

High-Density  22,  80,  950  f.,  958,  1214 
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High-Level  Data  Link  Control  1 138 

High  resolution  (ST(E))  833 

High-water  mark  (ser.  Schnittstelle)  904 

Hilfs-  und  Versorgungsleitungen  (VME-Bus)  1 192 

Hintergrund-Fenster  580 

HOG-Bit  (BLITTER,  Adr.  $FF  8A3C)  854 

Hohe  Auflosung  (ST(E))  833 

HOME  ALPHA  CURSOR  (VDI 5, 

Escape  8)  489 

Home  cursor  (VT52  ESC  H)  8 
HOP-Register  (BLITTER,  Adr. 

$FF  8A3A)  849 

Horizontal-Blanking-Interrupt  53,  841,  882 
Horizontal  line  ($A004)  3 12 
Horizontal  offset  table  290,  471 
Horizontalfrequenz,  ST(E)-Monochrom  827 
Hostadapter,  MEGA  STE-  1216 
Hotspot  307,  318  f.,  443 
HOTCLOSEBOX  (0x1000)  678 
HOURGLASS  (2)  667 
HP-Laserdrucker  321 

HScroll-Register  (STE,  Adr.  $FF  8265)  1286,  1318 

HSLIDE  (0x0800)  678,693 

Hiillkurve  (PSG)  860,  864 

HuSHI  171 

_hz_200  ($4BA)  66 
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I 

I/O  (SCSI)  1077 

I/O-Ports  (PSG)  861,864 

I/O-Redirection  174,  209,  234 

IACK  (VME-Bus)  1191,1193 

IACKIN  (VME-Bus)  1191,1193 

IACKOUT  (VME-Bus)  1191,1 193 

ICONBLK  562 

ID-Address-Mark  (Disk)  970 

ID-Feld  (Disk)  958, 962,  967, 977 

ID-Nummer  (Bootsektor)  92,  140 

Identifikation,  Disklaufwerks-  953 

IEEE  Standard  for  Binary  Floating-Point  Arithmetic  1023 

IERA  (ST-MFP,  Adr.  $FF  FA07)  886 

DERAJIT  (TT-MFP,  Adr.  $FF(FF)  FA87)  1068 

IERB  (ST-MFP,  Adr.  $FF  FA09)  886 

IERB_TT  (TT-MFP,  Adr.  $FF(FF)  FA89)  1069 

IKBD-Chip  56,  84,  86,  124,  129,  922 

IKBD-Kommandos  935 

IKBD-Treiberstatus  129 

Ikbdws  (XBIOS  25)  124 

IMG-Datei  504 

Immediate  Interrupt  (FDC)  974 

IMRA  (ST-MFP,  Adr.  $FF  FA13)  887 

IMRA_TT  (TT-MFP,  Adr.  $FF(FF)  FA93)  1069 

IMRB  (ST-MFP,  Adr.  $FF  FA15)  887 

IMRB_TT  (TT-MFP,  Adr.  $FF(FF)  FA95)  1069 

In-/Output  (SCSI)  1077 

Index  (FDC)  952 

Indeximpuls  946, 964,  974 

INDIRECT  (0x0100)  557 

Indirekte  Farbgebung  835 

JNF  81 

INFO  (0x0010)  678,693 

Inform  GEMDOS  of  “alternative”  memory  250 

IN1T  SYSTEM  FONT  (VDI 5, 

Escape  102)  530 
Initialization  ($A00O)  305 
Initiator  (ACSI)  981 
Initiator  (SCSI)  1073 
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Initmous  (XBIOS  0)  125 
INPUT  CHOICE,  REQUEST  MODE 
(VDI30)  435 

INPUT  CHOICE,  SAMPLE  MODE 
(VDI30)  437 

INPUT  LOCATOR,  REQUEST  MODE  (VDI 28)  427 
INPUT  LOCATOR,  SAMPLE  MODE  (VDI  28)  429 
INPUT  STRING,  REQUEST  MODE 
(VDI  31)  439 

INPUT  STRING,  SAMPLE  MODE 
(VDI  31)  441 

INPUT  VALUATOR,  REQUEST  MODE  (VDI  29)  43 1 
INPUT  VALUATOR,  SAMPLE  MODE  (VDI  29)  433 

INQUIRE  ADDRESSABLE  ALPHA  CHARACTER  CELLS  (VDI  5, 

Escape  1)  482 

INQUIRE  CAMERA  FILM  NAME 
(VDI  5,  Escape  92)  519 
INQUIRE  CELL  ARRAY  (VDI  27)  474 
INQUIRE  CHARACTER  CELL  WIDTH  (VDI  117)  470 
INQUIRE  COLOR  REPRESENTATION  (VDI  26)  459 
INQUIRE  CURRENT  ALPHA  CURSOR  ADDRESS  (VDI  5,  Escape  15)  496 
INQUIRE  CURRENT  FACE  INFORMATION  (VDI  131)  477 
INQUIRE  CURRENT  FILL  AREA  ATTRIBUTES  (VDI  37)  465 
INQUIRE  CURRENT  GRAPHIC  TEXT  ATTRIBUTES  (VDI  38)  466 
INQUIRE  CURRENT  POLYLINE  ATTRIBUTES  (VDI  35)  461 
INQUIRE  CURRENT  POLYMARKER  ATTRIBUTES  (VDI  36)  463 
INQUIRE  FACE  NAME  AND  INDEX  (VDI  130)  402,472 
INQUIRE  INPUT  MODE  (VDI  115)  476 
INQUIRE  JUSTIFIED  GRAPHICS  TEXT  (VDI  132)  480 
INQUIRE  PRINTER  SCAN  (VDI  5,  Escape  24)  506 
INQUIRE  TABLET  STATUS  (VDI  5,  Escape  16)  497 
INQUIRE  TEXT  EXTENT  (VDI  116)  468 
INQUIRY  (SCSI)  1103 
Insert  line  (VT52  ESC  L)  8 
INT(ACSI)  984 
INT  3  und  5  (Megabus)  825 
Integer  Data  Format  (68882)  1023 
Interleave  (ACSI)  994 
Interleave  (SCSI)  1096 
Interleaved  Bitplanes  281 
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Internal  Microsequencer  Status  (68030)  1009 
Interrogate  mouse  position  (IKBD  $D)  937 
Interrogate  time-of-day  clock  (IKBD  $IC)  940 
Interrupt  (68030)  1007 

Interrupt  (ACIA),  Sender-/Empfanger-  911,913 
Interrupt  (FDC)  961 
Interrupt  (FDC),  VBlank-  964 
Interrupt  (MFP-USART),  RCV-Buffer-full-  865,  900 
Interrupt  (MFP-USART),  RCV-Error-  895,  899  f. 

Interrupt  (MFP-USART),  XMIT-Buffer-empty-  895,  903 
Interrupt  (MFP-USART),  XMIT-Error-  895,  902 
Interrupt  (SCC),  DCD-  1 170  f. 

Interrupt  (SCC),  DSR-  1171 

Interrupt  (SCC),  Special  Receive  Condition-  1 144 

Interrupt  (SCU),  Software-  1197 

Interrupt  (TT  -SCSI)  1116 

Interrupt  (TT-Uhr)  1202 

Interrupt  (VME-Bus)  1 190 

Interrupt  an  MFP,  FDC/ACSI-  870 

Interrupt- Anforderung  (VME-Bus)  1190 

Interrupt- Ausgang  (TT -SCSI)  1116 

Interrupt-Bearbeitung  CPU<->MFP  884,  889 

Interrupt-Bus  (VME-Bus)  1 1 85,  1 190 

Interrupt-Ebenen  (ST)  882 

Interrupt-Eingang,  ST-MFP-  869 

Interrupt-Enable-Reg.  A  (ST-MFP,  Adr.  $FF  FA07)  886 

Interrupt-Enable-Reg.  A  (TT-MFP,  Adr.  $FF(FF)  FA87)  1068 

Interrupt-Enable-Reg.  B  (ST-MFP,  Adr.  $FF  FA09)  886 

Interrupt-Enable-Reg.  B  (TT-MFP,  Adr.  $FF(FF)  FA89)  1069 

Interrupt-Erkennung  (VME-Bus)  1191 

Interrupt-in-Service-Register  (MFP)  889 

Intermpt-in-Service  Register  A  (ST-MFP,  Adr.  $FF  FA0F)  888 

Interrupt-in-Service-Register  A  (TT-MFP,  Adr.  $FF(FF)  FA8F)  1069 

Interrupt-in-Service  Register  B  (ST-MFP,  Adr.  $FF  FA1 1)  888 

Interrupt-in-Service-Register  B  (TT-MFP,  Adr.  $FF(FF)  FA91)  1069 

Interrupt-Kanale  (MFP-USART)  895 

Interrupt-Leitung  zum  MFP  (BLITTER)  855 

Interrupt-Level  881 

Interrupt-Mask-Register  (SCU)  1195 

Interrupt-Mask-Register  A  (ST-MFP,  Adr.  $FF  FAB)  887 

Intenupt-Mask-Register  A  (TT-MFP,  Adr.  $FF(FF)  FA93)  1069 
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Interrupt-Mask-Register  B  (ST-MFP,  Adr.  $FF  FA15)  887 

Interrapt-Mask-Register  B  (TT-MFP,  Adr.  $FF(FF)  FA95)  1069 

Interrupt  Pending  (68030)  1007 

Interrupt-Pending-Register  (MFP)  889 

Interrupt  Pending  Register  (SCC)  1 174 

Interrupt-Pending-Register  A  (ST-MFP,  Adr.  FF  FAOB)  886 

Interrupt-Pending-Register  A  (TT-MFP,  Adr,  $FF(FF)  FA8B)  1069 

Interrupt-Pending-Register  B  (ST-MFP,  Adr.  FF  FAOD)  886 

Interrupt-Pending-Register  B  (TT-MFP,  Adr.  $FF(FF)  FA8D)  1069 

Interrupt-Prioritaten  881 

Interrupt-Prioritaten  (SCC)  1150 

Interrupt  Priority  Level  (68030)  1007 

Interrupt-Priority-Level-Anschliisse  (CPU)  881 

Interrupt  Request-Bit  (ACIA)  915 

Interrupt-Request-Leitungen  (VME-Bus)  1190 

Interrupt  Request  vom  SCC-DMA  1063 

Interrupt  Request  vom  SCSI-Controller  (TT)  1064 

Interrupt  Request  von  TT-Uhrenchip  1 064 

Interrupt-Service-Routine  (VME-Bus)  1192 

Interrupt  Stack  Pointer  (ISP)  (68030)  1010 

Interrupt-Steuerregister  (MFP)  886,  1068 

Interrupt  Vektor  (SCC)  1 174 

Interrupt- Vektor-Adresse  883 

Interrupt  Vektor-Register  (SCC)  1 153 

Interrupt- Vektor-Register  (ST-MFP,  Adr.  $FF  FA17)  888 

Intenupt-Vektor-Register  (TT-MFP,  Adr.  $FF(FF)  FA97)  1069 

Interrupt-Vektoren,  Lage  der  ST-MFP  885 

Interrupt-Vektomummer  882,  889 

Interrupt,  ACSI-  987, 989 

Interrupt,  Autovektor  882 

Interrupt,  FDC-  960,  978 

Interrupt,  HBLANK-  882 

Interrupt,  VBLANK-  882 

Interruptbehandlung  (TT-  und  ST-MFPs  (TT))  1066 
Interruptbehandlung,  MC68000-  881 
Interruptkanal  (MFP)  886 
Interruptkanal,  MFP-Timer-  873 
Interruptroutine,  Tips  fur  HBlank-  882 
Interrupts  (68030),  Steuersignale  fur 
1007 

Interrupts  (SCC),  Empfanger-  1149 
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Interrupts  (SCU),  Verwaltung  der  1195 
Interrupts  durch  Megabus  825 
Interrupts  durch  MFP  883 
Interrupts  durch  TT-MFP  1066 
Interrupts  softwaregesteuert  ausgelost  (SCU)  1195 
Interrupts  vom  Systemboard  (SCU)  1 195 
Interrupts  vom  VME-Bus  (SCU)  1196 
Interrupts,  Prioritiiten  der  MFP-  883 
Interruptsteuerung,  Video-Controller-  840 
Interruptvektoren,  Lage  der  TT-MFP-  1068 
INTJN  310 

INTR-AnschluB  (FDC)  960  f„  974 

IOA6  (TT-PSG)  1212 

IOA7  (TT-PSG)  1212 

Iorec  (XBIOS  14)  98, 127 

IOREC-Struktur  127 

IPEND  (68030)  1007 

IPL0..IPL2  (68000)  881 

IPL0..IPL2  (68030)  1007 

IPRA  (ST-MFP,  Adr.  $FF  FA0B)  886 

IPRA_TT  (TT-MFP,  Adr,  $FF(FF)  FA8B)  1069 

IPRB  (ST-MFP,  Adr.  $FF  FA0D)  886 

IPRB_TT  (TT-MFP,  Adr.  $FF(FF)  FA8D)  1069 

IRQ-AnschluB  (ACIA)  9 1 5,  9 19 

IRQ  1 .  .7  (VME-Bus)  1 190,  1 193 

isatty()  178, 242 

ISRA  (ST-MFP,  Adr.  $FF  FA0F)  888 
ISR A_TT  (TT-MFP,  Adr.  $FF(FF)  FA8F)  1 069 
ISRB  (ST-MFP,  Adr.  SFF  FA11)  888 
ISRBJTT  (TT-MFP,  Adr.  SFF(FF)  FA91)  1069 
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J 

Jdisint  (XBIOS  26)  128 
Jenabint  (XBIOS  27)  128 
JOYBSTAT  (STE,  Adr.  $FF  9200)  1289 
JOYDIR  (STE,  Adr.  $FF  9202)  1289  f. 

Joystick  129,  497,  929, 938 
Joystick-Button-Status  (STE,  Adr. 

$FF  9200)  1289 

Joystick-Direction  (STE,  Adr.  $FF  9202)  1289 
Joystick  interrogation  (IKBD  $16)  939 
Joystick-Modus  943 

Joystick-Richtungsinformation  (STE)  einlesen  1288 

Joystickabfrage  939,  943 

Joystickports  beim  STE  1287,  1289  ff.,  1293, 1368 

JUST  GO  258 

JUST  GO,  THEN  FREE  260 

JUSTIFIED  GRAPHICS  TEXT  ( VDI 1 1 ,  GDP  1 0)  375 
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K 

k-Faktor  (68881)  1338 
k-Faktor  (68882)  1027 
Kamera-Treiber  327,  331 
Kanal  (MIDI)  917 
Kanale  173 

Kbdvbase  (XBIOS  34)  129 
KBDVECS  129 
Kbrate  (XBIOS  35)  131 
Kbshift  (BIOS  11)  44,  65,  83,  91,  209 
kcljhook  ($5B0)  11,72 
Keksdose  72,743 

keybd  (Tastatur- ACIA,  Adr.  $FF  FC02)  9 1 5 
Keyclick  64,  859 

keyctl  (Tastatur-AdA,  Adr.  $FF  FC00)  915 
KEYTAB  132 
Keytbl  (XBIOS  16)  100,  132 
Klammeraffe  559 
Klangerzeugung,  digitate  916 
Kommandos  an  IKBD  935 
Kommandozeile  244 
Kommunikationskanale  (SCC)  1141 
Kommunikationsprotokoll  (68881)  1331 
Kommunikationsprotokoll  (68882)  1026 
Konsole  64,  83  ff.,  161,  237 
Konstanten-ROM  (68882)  1027 
Kontrollelemente  578 
Kontrollregister  (TT-Uhr)  1203 
Konvention  748 
Koordinatensystem  277,  288 
Koordinatensystem,  normalisiertes  277 
Kopfberuhigungszeit  (FDC)  962 
Kopfschlitten  (Disk)  946 
Kreiszahl  (68882)  1027 
Kurzzeitgedachtnis  748 
K_ALT  (0x0008)  455,  602, 609,  611,  669 
K_CTRL  (0x0004)  455 ,  602,  609,  61 1 ,  669 
K_LSHIFT  (0x0002)  455,  602, 609,  6 1 1 ,  669 
K_RSHIFT  (0x0001)  455,  602,  609, 61 1 , 669 
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L 

LAN-AnschluB  umschalten  (TT-PSG)  1212 
Landerkennung  43 

Langsparitatsverfahren  (Dateniibertragung)  1137 
LASTOB  (0x0020)  557 
Laufwerk  66,  953 

Laufwerk,  aktuelles  160,  222  f.,  225  f. 

Laufwerk,  extemes/intemes  955 
Laufwerk,  logisches  87,  95,  226 
Laufwerke,  vorhandene  225 
Laufwerksmotor  (Disk)  964 
Laufwerksparameter  (ACSI)  997 
Lautsprecher  im  TT  Ein-/Ausschalten  1212 
Lautstarke,  Kontrolle  der  PSG-  859 
LBA  (SCSI)  1088 
LBLACK  (9)  559 
LBLUE  (12)  559 
LCYAN  (13)  559 
LDS  (Lower  Data  Strobe)  793,  807 
LDS  (Megabus)  823 
Lese-Elektronik  (Disk)  945 
Level-Control-Bits  (PSG)  864 
LFARROW  (0x0200)  678,693 
LGREEN  (11)  559 
Library-Format  197 
Light-Gun/-Pen  (STB)  1286, 1289 
Lightpen,  X-Position  (STE,  Adr. 

$FF  9220)  1290 
Lightpen,  Y-Position  (STE,  Adr. 

$FF  9222)  1290 
Line-A  301 

Line-A-Vektor  ($28)  52 
Line-F-Trap  (68881)  1331 
Line-F-Trap  (68882)  1026 
Line-F-Vektor  ($2C)  53 

Line-Number-Register  (BLITTER,  Adr.  $FF  8A3C)  850 
Line-width-Register  (STE,  Adr.  $FF  820F)  1319 
LINEA  307 

linewid  (STE,  Adr.  $FF  820F)  1319 
Linie  347, 369,  384,  386  ff.,  461 
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Linked  Commands  (SCSI)  1089 
Lisa  159 

LMAGENTA  (15)  559 
LMC1992  (STE)  1308,1311 
LOAD  AND  GO  256 
LOAD  FONTS  (VDI 119)  343 
Load  mouse  position  (IKBD  $E)  937 
LOAD,  DON’T  GO  257 
Load/Execute  Process  256 
Logbase  (XBIOS  3)  62,  133,  152 
Logical  Unit  (SCSI)  1073,  1087 
Jongframe  ($59E)  71 
Lost  data-Bit  (FDC)  968  f. 

Loveman,  Jason  159 
Low  resolution  (ST(E))  834 
Low-water  mark  (ser.  Schnittstelle)  904 
Lower-Data-Strobe  793 
Lower-Data-Strobe  (Megabus)  823 
LRED(10)  559 
LUN  (SCSI)  1087 
L WHITE  (8)  559 
LYELLOW  (14)  559 
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M 

MACCEL3  595 

Macintosh  572,  580 

Maddalt  (GEMDOS  20)  183,  250 

MAGENTA  (7)  558 

magisches  Langwort,  (Cartridge)  809 

Magnetfelder,  fremde  946 

Magnetschicht  945 

Make-Code  (IKBD)  931 

Malloc  (GEMDOS  72)  179, 181,  251,  254, 266,  594,  695 
Manchester-Codierung  (SCC)  1 140 
MAPTAB  12 

Marker  349,  391 ,  393,  395,  463 
Markierungsbyte  (Disk)  973 
Maschinentyp  79 

Maskierung  eines  Interrupt-Kanals  (MFP)  887 

Master  (VME-Bus)  1 1 87,  1 1 89 

Master  Stack  Pointer  (MSP)  (68030)  1010 

Mastergerat  (MIDI)  916 

Mastertakt  (STE)  1313 

Matrixdrucker  154 

Maus  125, 446, 448, 450, 452, 497, 929,  93 1  f. 

Maus-Ereignis  543 

Maus-Skalierung  937,  942 

Mausabfirage  129,  938 

Mausbewegung  931,933,935,937,942 

Mausbewegungsmodus,  absoluter/relativer  936,  942 

Mauselektronik  933 

Mausknopf-Ereignis  543 

Mausposition  669 

Maustaste  (IKBD)  929,936 

Mauszeiger  632,  756,  764 

MC146818A  1201 

MC68000  793  f. 

MC68030  1003 
_MCH  79 
MCU  (TT)  1042 
MD  89 

_ md($49E)  65 

MD_ERASE  (4)  378 
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MD_REPLACE  ( 1 )  378 
MD_TRANS  (2)  378 
MDJXOR  (3)  378 

Media  change  21 ,  64,  92,  166,  953,  1114 
Mediabytes  165 

Mediach  (BIOS  9)  15,  64,  92,  162 
Medienwechsel  21,  64,  92,  166,  953, 1114 
Medium  Resolution  (ST(E))  834 
MEGAST-ROMs  802 
MEGAST-Serie  787 
Megabit-RAMs  798 
Megabit-ROM-Chips,  ST-  802, 804 
Megabit-ROM-Chips,  TT-  1037 
Megabus  821 

Megabus- AnschluBbelegung  821 
Megabus-Stromversorgung  825 
Megabus,  Interrupts  durch  881 
Megabus,  Signaltiming  am  821 
_membot  ($432)  60 
memcntrl  ($424)  59,  801 
memconf  (Adr.  $FF  8001)  801 
Memory-Configuration-Register  (Adr. 

$FF  8001)  801 

Memory  Control  Unit  (TT)  1042 
Memory  Form  Definition  Block  284 
Memory  load  (IKBD  $20)  941 

Memory  Management  Status  Register  (MMUSR)  (68030)  1017 

Memory  Management  Unit  (68030)  1014 

Memory-Management-Unit  (MMU)  790,  797 

Memory  read  (IKBD  $21)  941 

jmemtop  ($436)  60 

memval2  ($43A)  59  f.,  70 

memval3  ($51  A)  59,  70 

memvalid  ($420)  59  f.,  70 

Menu  749, 764 

Meniihintergrund  540 

Menuleiste  619 

Meniititel  622 

MENU_BAR  (AES  30)  549,  619, 624  f. 

MENU.CLICK  (AES  37)  548,  627 
MENUJCHECK  (AES  31)  620 
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MENUJENABLE  (AES  32)  621 
MENUJREGISTER  (AES  35)  625 
MENUTEXT  (AES  34)  585,623 
MENU_TNORMAL  (AES  33)  622 
MENUUNREGISTER  (AES  36)  626 
Message  (SCSI)  1076 
Message  Codes  (SCSI)  1085 
message  event  543 
MESSAGE-Phase  (SCSI)  1080,  1084 
Message-Queue  538,  596  f. 

Meta-DOS  14, 24,  36,  160, 162,  183,  191,  201,  575 

Metafile-Treiber  323,  33 1 ,  340,  521 ,  523,  528 

METAHDR  324 

Metainit  (XBIOS  48)  134 

MEVENT  617 

MFDB  284  f„  417 

MFORM  318,668 

MFP(ACSI)  987 

MFP(FDC)  958,960 

MFP  (MIDI/Tastatur)  919,929 

MFP  (par.  Schnittstelle)  909 

MFP  (ser.  Schnittstelle)  893 

MFP  68901 -Timer  157 

MFP-Einbindung  beim  TT  1062 

MFP-I/O-Port-Datenrichtung  872 

MFP-USART-Register  895 

MFP,  Interrupts  128,  135 

MFP,  Monochrom-Detect-Signal  zum  829 

MFP,  ST-  869 

MFP,  Takt  fur  872 

MFP,  TT-  1063 

Mfpint  (XBIOS  13)  50,  135 

Mfree  (GEMDOS  73)  253 

MFsave  744 

Microwire-Interface  1286,  1308  f. 

MIDI  56,  83  ff„  129,  136,  916 
midi  (MIDI-ACIA,  Adr.  $FF  FC06)  915, 1380 
MIDI-ACIA,  Interrupt  von  870 
MIDI-Bus  919 

MIDI-Empfangsregister  (MIDI-ACIA,  Adr.  $FF  FC06)  915, 1380 
MIDI-in/out  919 
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MIDI-Schnittstelle,  technische  Realisierung  der  919 
MIDI-Senderegister  (MIDI-ACIA,  Adr.  $FF  FC04)  9 1 5 
MIDI-Statusregister  (MIDI-ACIA,  Adr.  $FF  FC04)  915 
MEDI-Steuerregister  (MIDI-ACIA,  Adr.  $FF  FC04)  915 
MIDI-Thru  919 

midictl  (MIDI-ACIA,  Adr.  $FF  FC06)  9 1 5 
Midiws  (XBIOS  12)  136 
Mikrocontroller  (Keyboard)  922 
Miller  748 
Minix  20, 24 
MiNT  252 

Mitteilungs-Ereignis  543 

Mitdere  Auflosung  (ST(E))  833 

MMU  (68030)  1014 

MMU  Disable  (68030)  1009 

MMU,  ST-  790,796 

MMUDIS  (68030)  1009 

MMUs,  IMP-  799 

MN_SELECTED  (10)  544 

Mode-Control-Block  (IKBD)  923 

Mode  Control  Byte  (MODE)  (68882)  1032 

Mode  select  996 

Mode  sense  998, 1111 

MODEM  1  (TT-MFP)  1061 

MODEM  2  (TT-MFP)  1063 

Modulator  (ST(E))  832 

Modus  Commands  (MIDI)  919 

Monitorbuchse  827,  1047,  1314 

MONO-Modus  (MIDI)  917 

Mono-Modus  (STE)  1296 

Monochrom-Betrieb  (STE)  827  f. 

Monochrom-Betriebsart  837, 1047 

Monochrom-Detect-Signal  57,  829,  870,  1061 

Monochrom-Monitor  fur  die  Colorbetriebsart  (ST(E))  832 

Motor  on  (FDC)  95 1 ,  962 

MOVE  (0x0008)  678,693 

MPB  89 

MRETS  724 

MS-DOS  140,159,645,748 
MSG  (SCSI)  1076 
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Mshrink  (GEMDOS  74)  195, 251 , 254 
Multifunktionsbaustein  MFP  68901  869,  1061, 1369 
Multitasking  536 
Mupfel  10 

Musical-Instruments-Digital-Interface  (MIDI)  916 

Muskelgedachtnis  746 

MU-BUTTON (0x0002)  616 

MUKEYBD  (0x0001)  616 

MU_M1  (0x0004)  616 

MU_M2  (0x0008)  616 

MU_MES  AG  (0x0010)  616 

MUTIMER  (0x0020)  616 

MWDATA  (STE,  Adr.  $FF  8922)  1 309 

MWMASK  (STE,  Adr.  $FF  8924)  1 309 

Mxalloc  (GEMDOS  68)  183,255,266 

M_OFF  (256)  668 

M_ON  (257)  668 


1452 


ATARI  Profibuch 


N 

NAME  (0x0001)  678,693 
NAMENLOS  751 
NAN  (68882)  1024,1031 
NDC-Koordinatensystem  277,  332 
_NET  81, 200  f. 

Netzwerk-Standard  81,2001 
NetzwerkanschluB  (SCC)  1141 
NEWDESK.INF  539,705 
_nflops  ($4A6)  16, 63, 65 
NFSR  (BLITTER,  Adr.  $FF  8A3D)  853 
Nibble-Mode-Zugriffe  (TT)  1044 
Niedrige  Auflosung  (ST(E))  834 
NIL  552 

No  Final  Source  Read  (BLITTER,  Adr.  $FF  8A3D)  853 

Non-Autovektor-Interrupt  884,  888 

Non  Maskable  Interrupt  (Megabus)  825 

Non  Volatile  Memory  137 

NONE  556 

NONEXTENDED  SENSE  (SCSI)  1091 
NORMAL  (0x0000)  557,663 
NOT -READY -LIST  536 
NOTE  (1)  644 
NOJCON(O)  644 
NRZ(I)-Veifahren  1140,1162 
NTSC-Modus  61 
nvbls  ($454)  49,62 
NVM  137 

NVMaccess  (XBIOS  46)  137 
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o 

OBJC_ADD  (AES  40)  628 

OBJC_  CHANGE  (AES  47)  638 

OBJCDELETE  (AES  41)  629 

OBJC_DRAW  (AES  42)  565,  630,  647 

OBJC_EDIT  (AES  46)  636,649 

OBJCJFIND  (AES  43)  557,632 

OBJC_OFFSET  (AES  44)  55 1 ,  634 

OBJC_ORDER  (AES  45)  635 

OBJECT  553 

Objekt-Datei  196 

Objekt-Flags  556 

Objektfarben  558 

Objektstatus  557 

Objekttypen  554 

ob_spec  555 

ob_state  638 

ob_type  554 

OCS  (68030)  1005 

Offgibit  (XBIOS  29)  138 

OHEADER  196 

OMNI-Modus  (MIDI)  916 

On-Chip-Cache  1003 

Ongibit  (XBIOS  30)  138 

_OOL  81 

OP  (BLITTER,  Adr.  $FF  8A3B)  845 
OP-Code  (SCSI)  1087 
Open  file  237 

OPEN  VIRTUAL  SCREEN  WORKSTATION  (VDI 100)  337,  339 
OPEN  WORKSTATION  (VDI  1)  330, 337  f„  456 
Operand  Cycle  Start  (68030)  1005 
Operation-Register  (BLITTER,  Adr. 

SFF8A5B)  845 
Operationscode  (ACSI)  990 
Operationsende  (FDC)  958,  960 
Optokoppler  (MIDI)  919 
Ordner  202,  220  f.,  227,  247 
Oren,  Tim  159 
OSHEADER  40,144 
os_magic  144 
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OUTLINED  (0x0010)  558, 663 
OUTPUT  ALPHA  TEXT  (VDI 5, 

Escape  25)  508 

OUTPUT  BIT  IMAGE  FILE  (VDI  5,  Escape  23)  504 
OUTPUT  CURSOR  ADDRESSABLE  ALPHA  TEXT  (VDI  5,  Escape  12) 
493 

OUTPUT  WINDOW  (VDI  5,  Escape  21 )  502 
Overrun  Error  (MFP-USART)  900 
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Packed  Decimal  Real  Data  Format  (68882)  1025 
PADDLO  (STE,  Adr.  $FF  9210)  1292 
PADDL1  (STE,  Adr.  $FF  9212)  1292 
PADDL2  (STE,  Adr.  $FF  9214)  1.292 
PADDL3  (STE,  Adr.  $FF  9216)  1292 
Paddle  0-Position  (STE,  Adr.  $FF  9210)  1292 
Paddle  1-Position  (STE,  Adr.  $FF  9212)  1292 
Paddle  2-Position  (STE,  Adr.  $FF  9214)  1292 
Paddle  3-Position  (STE,  Adr.  $FF  9216)  1292 
Paddle-Zahler-Register  (STE)  1292 
Page-Descriptor  (68030)  1015 

Paged  Memory  Management  Unit  (PMMU)  (68030)  1003,  1015 

PAL-Modus  61 

Paletteregister  1056,  1314 

palmode  ($448)  61 

Papierformate  288 

Parallelport  als  Eingang  (PSG)  909 

Parallelport-Register,  MFP-  869 

Parameter  fur  Fehlerbehebung  (SCSI-MODE  SELECT)  1 1 08 

Parameterblock  (ACSI-MODE  SELECT)  996 

Paritat  (MFP-USART)  896 

Paritat  (SCSI)  1077 

Paritatsbit  896 

Parity  Error-Bit  (ACIA)  915 

Parity-Fehler  (MFP-USART)  900 

Parity,  Even-/Odd-  896 

PARMBLK  564 

Partitionseintrag  26  f. 

Partitionstypen  27 

Patch-Programme  (ser.  Schnittstelle)  905 
PATH  61 

Pause  output  (IKBD  $13)  938 
PBDEF  142 

PC-GEM  642,646,659,661,667 
PCM-Soundkanale  1286 

Pexec  (GEMDOS  75)  69,  161, 191, 193,  233, 256, 539,  702  ff. 
Pexec-Cookbook  41 
Pfad,  absoluter  160 
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Pfad,  aktueller  226 
Pfad,  relativer  160 
PH  194 

Physbase  (XBIOS  2)  139, 152 
PHYSICAL  PAGE  SIZE  (VDI 5, 

Escape  99,  Opcode  0)  525 
phystop  ($42E)  60 
ph_prgflags  194, 260 
Picture  cell  833 

PIESLICE  (VDI  1 1,  GDP  3)  363 
Ping!  65 

Pipeline  Refill  (68030)  1009 
Pipes  176 
Pixel  833 

PixelgroBenverhaltnis  279 
pixelorientiertes  Format  28 1 

PLACE  GRAPHIC  CURSOR  AT  LOCATION  (VDI  5,  Escape  1 8)  499 
planeorientiertes  Format  281 

Plattenparameter,  unveranderliche  (SCSI-MODE  SENSE)  1113 

Plottertreiber  320,  331 

PMMU  (68030)  252, 1003,  1015 

Polaroid  Palette  327 

Polling  885 

POLY-Modus  (MIDI)  917 
Polygonzug  347,  353,  389 
POLYLINE  (VDI  6)  347 
POLYMARKER  (VDI  7)  349 
POOLFIX3.PRG  182,191,269 
Popup  734 
PORTAB.H  783 
Portabilitat  782 

Position  cursor  (VT52  ESC  Y)  8 

Positionierungsbefehl  (FDC)  965 

Post-Mortem  57 

Postscript  321,400 

Potentialtrennung  (MIDI)  919 

Pratt,  Allan  99,  159 

Prekompensations-Bit  (FDC)  969 

PREVENT/ALLOW  MEDIUM  REMOVAL  (SCSI)  1114 

Privilegverletzung  ($20)  52 
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PRN:  161,237 

Process  descriptor  186,  244, 267,  586,  702 

proc_aregs  ($3A4)  58 

proc_dregs  ($384)  58 

proc_enum  ($3C4)  58 

procjives  ($380)  58 

proc_stk  ($3CC)  58 

proc_usp  ($3C8)  58 

Programm-Flags  194, 260 

Programmformat  193 

Programmierrichtlinien  719 

Programmstart  187 

Programmzahler  (68000)  793 

Protobt  (XBIOS  18)  18,  22, 140, 161 

ProzeB  184,  266  f. 

ProzeB,  aktueller  185 

ProzeBhierarchie  184 

Prozessor-Status  268 

Prozessorsignale  (68030)  1004 

_prtabt  ($4F0)  67 

Prtblk  (XBIOS  36)  67, 142,  149 

prt_cnt  49,  66 

Priifsumme  (Disk)  948 

Priifzeichen  (Dateniibertragung)  1 1 37 

prv_aux  ($512)  70,  143 

prv_auxo  ($50E)  70,  143 

prv_lst($50A)  69,143 

prvjsto  ($506)  69,  143 

Pseudo-Sound-Prozessor  866 

PSG  (FDC)  955,975 

PSG  (par.  Schnittstelle)  908 

PSG  (Programmable-Sound-Generator)  859 

PSG  (ser.  Schnittstelle)  893 

PSG(STE)  1308 

PSG(TT)  1211 

PSG-Port  864 

PSG-Register  861 

Pterm  (GEMDOS  76)  266 

RermO  (GEMDOS  0)  265 

Ptermres  (GEMDOS  49)  173, 191 ,  267 

Pl’SIN  310 
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Pull-Down  749 

Pulsbreitenmessung  (MFP-Timer)  875 
Punkt  279 

Puntaes  (XBIOS  39)  42,  144 
PUNJNFO  33,70,172 
pun_ptr  ($516)  70,  94, 171 
Put  pixel  ($A001)  310 
_p_cookies  ($5 AO)  71,73 


Q 

Quarter  Screen  Buffer  540 
Quotient  Byte  (68882)  1033 
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R/_W  (68030)  1005 

R/_W(ACSI)  984 

R/_W  (Megabus)  823 

Rahmenfehler  (ser.  DatenUbertxagung)  899 

Rainbow-TOS  166 

RAM  (IKBD)  924 

RAM  (STE)  1322 

RAM  (TT)  1037,1039 

RAM-Chips  796 

RAM  erweitem  (TT),  ST-  1042 

RAM-Speicherbanke  (ST)  797 

RAM-Streifen  (STE)  1322 

RAM,  Alternate  1039 

RAM,  batteriegepuffert  (TT-Uhr)  1201 

RAM,  Single  purpose  1042 

RAM,  ST-  1039 

ramtop  ($5A4)  71 

ramvalid  ($5A8)  71 

Random  (XBIOS  17)  145 

RAS  796 

Raster  415,418,421,529 
Rasterformate  280 
Rasterkoordinaten  277,  332 

Rate-  and  Mode-Control-Register  (RMCR)  (IKBD)  928 

Rauschgenerator  (PSG)  859,  863 

Raw  I/O  to  standard  input/output  219 

Raw  input  from  standard  input  218 

RAWCON  84 

RBUTTON  (0x0010)  557 

RC-Koordinatensystem  277,  332 

RCS-Programm  560,  585 

rc_intersect  577 

READ  (SCSI)  1101 

READ  ADDRESS  (FDC)  970 

READ  CAPACITY-Kommando  (SCSI)  1088 

Read  character  from  standard  AUX:  205 

Read  character  from  standard  input  209 

Read  character  from  standard  input,  no  echo  215 

Read  Data  (FDC)  952 
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Read  edited  data  from  standard  input  212 
Read  from  file  240 

Read-Modify-Write  Cycle  (68030)  1005 

Read  Sector  (ACSI)  995 

READ  SECTOR  (FDC)  967 

READ  TRACK  (FDC)  971 

Read/Write  (68030)  1005 

Read/Write-Leitung  (Megabus)  823 

READ/WRITE  MULTIPLE  SECTORS  (FDC)  967,  973 

Ready  (FDC)  953 

READY-LIST  536 

Real-Time-Commands  (MIDI)  918 

REASSIGN  BLOCKS  (SCSI)  1100 

Receive  Data  Register  Full-Bit  ( ACIA)  9 1 4 

Receiver  Clock  (ST-MFP-USART)  894 

Receiver  Overrun-Bit  (ACIA)  914 

Receiver-Status-Register  (ST-MFP-USART,  Adr.  SFF  FA2B)  895,  898 
Receiver-Status-Register  (TT-MFP-USART,  Adr.  $FF(FF)  FAAB)  1071 
Rechteckliste  577 

Record  not  found-Bit  (FDC)  965,  967 
RED  (2)  558 
REFILL  (68030)  1009 
Register  (Kurziibersicht),  Hardware-  1349 
Register  (PSG)  861 

Registerauswahl  (TT-Uhr,  Adr.  $FF(FF)  8961)  1202 
Registeriibersicht  (68030)  1010  f. 

Release  memory  253 
release  velocity  (MIDI)  917 
Relozierungsinformationen  195 

REMOVE  LAST  GRAPHIC  CURSOR  (VDI 5 ,  Escape  19)  500 

Rename  file  241 

REPLACE  413,418 

REQ  (SCSI)  1077 

Request  (SCSI)  1077 

Request  joystick  availibilty  (IKBD  $9A)  943 
Request  joystick  mode  (IKBD  $94, 

IKBD  $95,  DCBD  $99)  943 
Request  mouse  availibility  (IKBD  $92)  943 
Request  mouse  button  action  (IKBD  $87)  942 
Request  mouse  mode  (IKBD  $88, 

IKBD  $89,  IKBD  $8A)  942 
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Request  mouse  scale  (IKBD  $8C)  942 
Request  mouse  threshold  (IKBD  $8B)  942 
Request  mouse  vertical  coordinates 
(IKBD  $8F,  IKBD  $90)  943 
Request  Sense  992, 1090 
Request  to  send  (RTS)  893 
Request  to  send  (SCC)  1 1 57 
Request/Acknowledge-Protokoll  (ACSI)  984 
Request/Acknowledge-Protokoll  (SCSI)  1073 
RESELECTION-Phase  (SCSI)  1079 
Reset  46,51,591. 

RESET  (68030)  1008 

RESET  (ACSI)  984 

RESET  (IBKD  $80)  935 

RESET  (Megabus)  822 

RESET  (SCC)  1162 

RESET  (SCSI)  1076 

RESET,  680XX-CPU-  796 

Reset:  PC  ($4)  51 

Reset:  SSP  ($0)  51 

Resource  Construction  Set  552,  701 

Resource-Datei  584 

Response  Primitives  (68881)  1332 

RESTORE  (FDC)  965 

Restore  cursor  position  (VT52  ESC  k)  9 

Restore  to  Zero  (ACSI)  991 

Resume  (IKBD  $11)  938 

resvalid  ($426)  46,59 

resvector  ($42A)  46,  59 

RETURN  TABLET  X  AND  Y  DIMENSIONS  (VDI 5,  Escape  84)  516 
Reverse  index  (VT52  ESC  I)  8 
REVERSE  TRANSPARENT  418 
REVERSE  VIDEO  OFF  (VDI  5, 

Escape  14)  495 
REVERSE  VIDEO  ON  (VDI  5, 

Escape  13)  494 
REZERO  UNIT  (SCSI)  1090 
RGB-Signale  (ST(E))  829 
RGB-Signale  (TT)  1048 
Richtungsinformation  (Joysticks)  931 
Ring  indicator  (RI)  56,  893 
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RMC  (68030)  1005 
ROM  (IKBD)  924 
ROM-Bereich  (TT)  1037 
ROM-Cartridge  805 
ROM-Chips,  ST-  802 
ROM-TOS  802 

ROM3  sel./ROM4  sel.  (Cartridge)  807 
ROMs,  TT-  1037 
Root-Pointer  (68030)  1016 
Rootsektor  23 
Rotation  401 

ROUNDED  RECTANGLE  (VDI 11, 

GDP  8)  373 
Row  Adress  Strobe  796 
RS-232C-Standard  891 

RS232-Port  55  f.,  70,  83  ff„  98,  127,  146,  154,  161,  205  ff.,  869,  891,  894 

RS422  (SCC)  1141 

Rsconf  (XBIOS  15)  98,146 

Rsconf  (XBIOS  15),  Fehler  903 

RSHDR  584 

rsh_fix  733 

rsh_obfix  733 

rsr  147 

RSR  (ST-MFP-USART,  Adr.  $FF  FA2B)  898 

RSRC_FREE  (AES  1 1 1)  695, 697 

RSRC.GADDR  (AES  112)  588, 698 

RSRC_LOAD  (AES  1 10)  552,  594, 695, 697  f„  701 , 707 

RSRC_OBFIX  (AES  114)  701 

RSRC_SADDR  (AES  113)  700 

RSR_TT  (TT-MFP-USART,  Adr. 

$FF(FF)  FAAB)  1071 
RST  (SCSI)  1076 
RTARROW  (0x0400)  678,693 
rtc_data  (TT-Uhr,  Adr.  $FF(FF)  8963)  1202 
rtc_mr  (TT-Uhr,  Adr.  $FF(FF)  8961)  1202 
RTS  (Request  to  send)  893 
RTS  (SCC)  1157 
RTS/CTS-Handshake  127, 904 
Rubberbox  653 

Rwabs  (BIOS  4)  16, 64,  94,  118,  162, 

166 
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RxCLK(ACIA)  911 
RxDATA  (ACIA)  911 
RxINT  (ACTA)  913  ff. 
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s 

S.A.L.A.D.  307 
Sample  (STE)  1294 

SAMPLE  KEYBOARD  STATE  INFORMATION  (VDI  128)  455 

SAMPLE  MOUSE  BUTTON  STATE  (VDI  124)  448 

Samplefrequenzen  (STE)  1294 

Save  cursor  position  (VT52  ESC  j)  9 

savptr  ($4A2)  37,57,65 

sav_context  ($4AE)  66 

sav_row  ($4AC)  9,  65 

Scancode  1 1 ,  83,  132,  209,  607,  935 

SC  ART  -Eingang,  AnschluB  eines  ST  (E)  iiber  einen  830 

SCC  (Serial  Communications  Controller)  1135 

SCC-Baudrate  1165 

SCC-Beispielinitialisierung  1182 

SCC-Control-Reg.  Kanal  A  (Adr, 

$FF(FF)  8C81)  1146 
SCC-Control-Reg.  Kanal  B  (Adr. 

$FF(FF)  8C85)  1146 
SCC-Data-Reg.  Kanal  A  (Adr, 

$FF(FF)  8C83)  1146 
SCC-Data-Reg.  Kanal  B  (Adr. 

$FF(FF)  8C87)  1146 

SCC-DMA-Address-Pointer  (ab  Adr.  $FF(FF)  8C01)  1 179 
SCC-DMA-AnschluB  1152 
SCC-DMA-Bytezahler  (ab  Adr. 

$FF(FF)  8C09)  1179 
SCC-DMA-Einheit  1 1 46,  1 1 78 
SCC-DMA-Kontrollregister  (Adr. 

$FF(FF)  8C14)  1179 
SCC-DMA-Register  1 1 79, 1365 

SCC-DMA-Restdatenregister  (ab  Adr.  $FF(FF)  8C10)  1179 

SCC-Einbindung  im  TT  1181 

SCC-Empfanger  1143 

SCC-Empfangersteuerung  1154 

SCC  im  TT,  Betrieb  des  1 178 

SCC-Kommando  Register  1 147 

SCC-Loop  Mode  1 162 

SCC-Loop/Clock  Status  1175 
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SCC-Master  Interrupt  Control  1 160 
SCC-Moduseinstellungen  fiir  Sender/Empfanger  1155 
SCC-Read-Register  1146,  1172  ff. 

SCC-Sendedatenregister  1160 
SCC -Sender  1145 
SCC-Sendersteuerung  1156 
SCC-Takteinstellung  1165 

SCC-Write-Register  1146,  1150,  1153  ff.,  1158  ff.,  1162,  1165  f„  1168 

SCC-Write-Register  0  1147 

SCC,  Blockdiagramm  des  1 142 

SCC,  Programmierung  des  1 176 

sccctLa  (SCC,  Adr.  $FF(FF)  8C81)  1 146 

sccctl_b  (SCC,  Adr.  $FF(FF)  8C85)  1 146 

sccdat_a  (SCC,  Adr.  $FF(FF)  8C83)  1 146 

sccdat„b  (SCC,  Adr.  $FF(FF)  8C87)  1 146 

sedmabas  (SCC,  ab  Adr.  $FF(FF)  8701)  1 179 

sedmaent  (SCC,  ab  Adr.  $FF(FF)  8709)  1 179 

scdmactl  (SCC,  Adr.  $FF(FF)  8C1 4)  1 179 

sedmarsd  (SCC,  ab  Adr.  $FF(FF)  8710)  1179 

Schattenregister,  “memconf 801 

Schieberegister  im  Video-Controller  (ST)  836 

Schieberegler  664 

Schleife  (MFP-USART)  901 

Schneckennudel  559 

Schnittstelle  (IKBD),  serielle  927 

Schnittstelle  (SCC),  Multiprotokoll-  1135 

Schnittstelle  als  Eingang,  parallele  909 

Schnittstelle  fiir  Coprozessoren  1019 

Schnittstelle,  Hardwaremabige  Realisierung  der  par.  908 

Schnittstelle,  MIDI-  916,919 

Schnittstelle,  parallele  55,  69, 83  f„  86, 154,  161,  216,  861,  907 

Schnittstelle,  serielle  55  f„  70,  83  ff.,  98, 127,  146,  154,  161,  205  ft,  869,  891,  894 

Schnittstellen-Steuerbaustein  (SCC)  1135 

Schreib-/Lese-Kopf  (Disk)  945,  952 

Schreib-Elektronik  (Disk)  945 

Schreibmodus  377 

Schreibschutz  39,  227, 229, 247 

Schreibvorkompensation  (FDC)  969 

Schreibzugriff  (VME-Bus)  1188 

SciGraph  756 

SCR  (ST-MFP-USART,  Adr.  $FF  FA27)  896 
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scrap  572,  670  ff.,  751 
Scrdmp  (XBIOS  20)  69,149 
Screen  manager  536  f.,  599 
screenpt  ($45E)  48,  63 
SCRENMGR  536  f„  599 
Scrolling  62 

SCRP_CLEAR  (AES  82)  672 

SCRP.READ  (AES  80)  670 

SCRP_WRITE  (AES  81)  671 

scr_dump  ($502)  49, 69,  149 

SCRJTT  (TT-MFP-USART,  Adr.  $FF(FF)  FAA7)  1070 

SCSI-AdreBregister  (TT-SCSI,  Adr.  $FF(FF)  8789)  1 1 22 

SCSI-Ausgabedaten  (TT-SCSI,  Adr.  $FF(FF)  8781)  1116 

SCSI-Betriebsartenregister  (TT-SCSI,  Adr.  $FF(FF)  8785)  1 1 19 

SCSI-Bus  (ACSI)  981 

SCSI-Bus(TT)  1073 

SCSI-Bus-AbschluB  1074 

SCSI-Bus-AnschluBbelegung  1074  f. 

SCSI-Bus-Signale  1076 
SCSI-Buskontrolle  1078 

SCSI-Busstatusregister  (TT-SCSI,  Adr.  $FF(FF)  8789)  1121 
SCSI-Controller  (TT)  1073,  1 1 16,  1357 
SCSI-Datenbus  (TT-SCSI,  Adr. 

$FF(FF)  8781),  Aktueller  Inhalt  des  1116 
SCSI-Datentransfer  mit  DMA-Unterstiitzung  1124 
SCSI-DMA- Address-Pointer  (TT-SCSI,  ab  Adr.$FF(FF)  8701)  1 125 
SCSI-DMA-Betrieb  1124,1126,1356 
SCSI-DMA-Bytezahler  (TT-SCSI,  ab  Adr.  $FF(FF)  8709)  1 125 
SCSI-DMA-Controller  (TT)  1 1 16 
SCSI-DMA-Kanal  1124 

SCSI-DMA-Kontrollregister  (TT-SCSI,  Adr.  $FF(FF)  8714)  1126 
SCSI-DMA-Register  1125 

SCSI-DMA-Restdatenregister  (TT-SCSI,  ab  Adr.  $FF(FF)  8710)  1125 

SCSI-Eingabe-Register  (TT-SCSI,  Adr.  $FF(FF)  878D)  1124 

SCSI-Inititator-Befehlsregister  (TT-SCSI,  Adr.  $FF(FF)  8783)  1117 

SCSI-Interface  beim  TT  1114 

SCSI-Kommandos  1085 

SCSI-Ports,  Programmierung  des  TT-  1 127 

SCSI-Resetreg,  Int.+Parityfehler  (TT-SCSI,  Adr.  $FF(FF)  878F)  1124 
SCSI-Start  DMA-Ausgabe-Register  (TT-SCSI,  Adr.  $FF(FF)  878B)  1 123 
SCSI-Start  Initiator-DMA-Eingabe-Register  (TT-SCSI,  Adr.  $FF(FF)  878F)  1124 
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SCSI-Start  Target-DMA-Eingabe-Register  (TT-SCSI,  Adr.  $FF(FF)  878D)  1 123 
SCSI-Statusregister  (TT-SCSI,  Adr.  $FF(FF)  878B)  1 122 
SCSI-Target  Befehlsregister  (TT-SCSI,  Adr.  $FF(FF)  8787)  1 121 
SCSI-Tool  171 
SCU  1195 

SCI)  General  Purpose  Reg.  1  (Adr.  $FF  8E09)  1199 

SCU  General  Purpose  Reg.  2  (Adr.  $FF  8E0B)  1 199 

SCU  im  TT/MEGA  STE,  hardwaremaBige  Einbindung  der  1 198 

SCU-Universal-Register  1199 

scu _gpl  (SCU,  Adr.  $FF  8E09)  1199 

scu _gp2  (SCU,  Adr.  $FF  8E0B)  1199 

SDB  319 

SDLC- Verfahren  1 1 38,  1 1 58 
Search  first  245 
Search  next  248 

Sector-Counter-Register  (Adr.  $FF  8604)  81 8, 977 

Seedfill  ($A00F)  320 

SEEK  (ACSI)  995 

SEEK  (FDC)  965,978 

SEEK  (SCSI)  1102 

Seek  file  pointer  242 

seekrate  ($440)  60,63,116 

Sektor  118  ff . 

Sektor-Header  (Disk)  947 
Sektorbeginn  (Disk)  947 
Sektoren,  logische  94 
Sektoren/Spur  (ACSI)  997 
SektorgroBe  (Disk)  947,  956 
SEL  (SCSI)  1076 
Select  (SCSI)  1076 

SELECT  PALETTE  (VDI 5,  Escape  60)  510 
SELECTABLE  (0x0001)  556 
SELECTED  (0x0001)  558,663 
SELECTION-Phase  (SCSI)  1079 
Selektion  762 

Sende-Schieberegister  (ACIA)  9 1 1 
Sendepuffer  (MFP-USART)  895 
Sender  (ACIA)  911 
Senderegister  (ACIA)  911 
Senderegister  (IKBD)  927 
Senderegister  (MFP-USART)  895 
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Senderegister  (MIDI-ACIA,  Adr. 

$FF  FC04)  915 

Senderegister  (Tastatur-ACIA,  Adr. 

$FF  FC02)  915 

Sendeschieberegister  (MFP-USART)  895 
Sendeschieberegister  (SCC)  1145 
Sendetakt  (ST-MFP-USART)  894 
Sense-Daten  (SCSI)  1090,  1093,  1095 
Separator  750 
Sequenzer  916 

SERIAL  1  (TT-MFP)  1062,1070 

SERIAL  2  (SCC)  1141 

SERIAL  2  (TT-PSG)  1212 

Serial  Communications  Controller  (Ubersicht)  1366 

Serial-Communications-Element  (IKBD)  927 

Serial  Port  C  (TT)  1061 

Seriennummer  92,  140 

Set  absolute  mouse  positioning  (IKBD  $09)  936 
SET  ATTRIBUTE  SHADOW  OFF  (5 1 )  524 
SET  ATTRIBUTE  SHADOW  ON  (50)  524 
Set  background  color  (VT52  ESC  c)  8 

SET  CAMERA  FILM  TYPE  AND  EXPOSURE  TIME  (VDI 5,  Escape  91)  518 
SET  CHARACTER  BASELINE  VECTOR  (VDI  13)  401 
SET  CHARACTER  HEIGHT,  ABSOLUTE  MODE  (VDI  12)  396 
SET  CHARACTER  HEIGHT,  POINTS  MODE  (VDI  107)  398 
SET  CLIPPING  RECTANGLE  (VDI  129)  346 
SET  COLOR  REPRESENTATION 
(VDI  14)  382 
Set  current  directory  226 
Set  date  272 
Set  default  drive  225 
Set  DTA  244 

SET  FILL  COLOR  INDEX  (VDI  25) 

411 

SET  FILL  INTERIOR  INDEX  (VDI  23)  408 

SET  FILL  PERIMETER  VISIBILITY  (VDI  104)  412 

SET  FILL  STYLE  INDEX  (VDI  24)  409 

Set  fire  button  monitoring  (IKBD  $18)  939 

Set  foreground  color  (VT52  ESC  b)  8 

SET  GRAPHIC  TEXT  ALIGNMENT  (VDI  39)  406 

SET  GRAPHIC  TEXT  COLOR  INDEX  (VDI  22)  403 
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SET  GRAPHIC  TEXT  SPECIAL  EFFECTS  (VDI 106)  404 

SET  INPUT  MODE  (VDI 33)  425 

Set  joystick  event  reporting  (IKBD  $14)  938 

Set  joystick  interrogation  mode  (IKBD  $15)  939 

Set  joystick  keycode  mode  (IKBD  $19)  939 

Set  joystick  monitoring  (IKBD  $  1 7)  939 

SET  LINE  OFFSET  (VDI  5,  Escape  101)  529 

Set  mouse  button  action  (IKBD  $07)  936 

SET  MOUSE  FORM  (VDI  111)  443 

Set  mouse  keycode  mode  (IBKD  $A) 

937 

Set  mouse  scale  (IKBD  $C)  937 
Set  mouse  threshold  (IKBD  $B)  937 
SET  NO  LINE  STYLE  (49)  524 
SET  POLYLINE  COLOR  INDEX 
(VDI  17)  388 

SET  POLYLINE  END  STYLES  (VDI  108)  389 

SET  POLYLINE  LINE  TYPE  (VDI  1 5)  384,  386 

SET  POLYLINE  LINE  WIDTH  (VDI  16)  387 

SET  POLYMARKER  COLOR  INDEX  (VDI  20)  395 

SET  POLYMARKER  HEIGHT  (VDI  1 9)  393 

SET  POLYMARKER  TYPE  (VDI  18)  391 

Set  relative  mouse  position  reporting  (IKBD  $08)  936 

SET  TABLET  ALIGNMENT  (VDI  5,  Escape  85)  517 

SET  TABLET  AXIS  RESOLUTION  IN  LINES  (VDI  5,  Escape  82)  514 

SET  TABLET  AXIS  RESOLUTION  IN  LINES/INCH  (VDI  5,  Escape  81)  513 

SET  TABLET  X  AND  Y  ORIGIN  (VDI  5,  Escape  83)  515 

SET  TEXT  FACE  (VDI  21)  402 

Set  time  273 

SET  USER-DEFINED  FILL  PATTERN  (VDI  1 12)  413 

SET  USER-DEFINED  LINE  STYLE  PATTERN  (VDI  113)  386 

SET  WRITING  MODE  (VDI  32)  377 

Set  Y=0  at  bottom  (IKBD  $F)  938 

Set  Y-0  at  top  (IKBD  $10)  938 

SET/CLEAR  TONE  MUTING  FLAG  (VDI  5,  Escape  62)  512 

Setcolor  (XBIOS  7)  150 

Setexc  (BIOS  5)  50,96,197 

Setpalette  (XBIOS  6)  151 

Setprt  (XBIOS  33)  11,  84,  149,  154, 217 

Setscreen  (XBIOS  5)  63,  152, 183 

Settime  (XBIOS  22)  153 
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Set_Evnt_Mask  740 
SHADOWED  (0x0020)  558,663 
SHDRIVER.SYS  24  f. 

Shell-Puffer  586 
_shell_p  ($4F6)  68 
SHEL_ENVRN  (AES  125)  191,  539, 

708 

SHELFIND (AES  124)  539, 695, 707 
SHEL_GET  (AES  122)  705 
SHELJPUT  (AES  123)  706 
SHEL_RDEF  (AES  126)  710 
SHELREAD  (AES  120)  702, 707 
SHEL_WDEF  (AES  127)  711 
SHEL_WR1TE  (AES  121)  599,  702  f. 
Shift-Mode-Register  (ST(E)),  Adr, 

$FF  8260  107,838 
Shift-Mode-Register  (IT,  Adr. 

$FF(FF)  8260),  ST(E)-  1056 
Shift-Mode-Register  (TT,  Adr. 

$FF(FF)  8262),  TT-  1057 
Shifter  62,  156,  788,  836,  841,  1053,  1057 
shiftmd  (TT,  Adr.  $FF(FF)  8260)  1057 
shiftJTT  (TT,  Adr.  $FF(FF)  8262)  1057 
Short- Access  (VME-Bus)  1188 
SHOW  CURSOR  (VDI 122)  446 
Show  mouse  ($A009)  317 
Shrink  size  of  allocated  block  254 
Shugart-Bus  949, 953 

Sicherungsverfahren  (Dateniibertragung)  1137 

Side  select  (FDC)  951,955,975 

Side  select  (TT-PSG)  1211 

Signalleitungen  (FDC)  950 

SIMM  (STE)  1322 

Single-Chip-Modus  (IKBD)  924 

Single  Real  (68882)  1023,  1027 

SIZ0/SIZ1  (68030)  1005 

SIZE  (0x0020)  678,693 

Skew  (BLITTER,  Adr.  $FF  8A3D)  852 

Slave  (VME-Bus)  1187 

_SLM  81,531 

SLM-Laserdrucker  342 
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Sl_arrow  737 
Sl_dragx  738 
SLdragy  738 
Sl_size  735 
Sl_x  736 
Sl_y  736 

Small  Computer  Systems  Interface  (TT)  1073 
SMUDGE-Bit  (BLITTER,  Adr. 

$FF  8A3C)  854 
_SND  80 

sndadrhi  (STE,  Adr.  $FF  8908)  1297 
sndadrlo  (STE,  Adr.  $FF  890C)  1297 
sndadrmi  (STE,  Adr.  $FF  890A)  1 297 
sndbashi  (STE,  Adr.  $FF  8902)  1297 
sndbaslo  (STE,  Adr.  $FF  8906)  1297 
sndbasmi  (STE,  Adr.  $FF  8904)  1297 
sndendhi  (STE,  Adr.  $FF  890E)  1297 
sndendlo  (STE,  Adr.  $FF  8912)  1297 
sndendmi  (STE,  Adr.  $FF  891 0)  1297 
sndmactl  (STE,  Adr.  $FF  8900)  1297 
sndmode  (STE,  Adr.  $FF  8920)  1297 
Software-EOI-Modus  (MFP)  888 
Sound-Chip  (FDC)  955 
Sound-DMA-ControlReg.  (STE,  Adr. 

SFF8900)  1297 
Sound-DMA-Modul  (STE)  1296 
Sound-Mode-Control  (STE,  Adr.  $FF  8920)  1297 
Soundchip  (par.  Schnittstelle)  908 
Soundchip  (PSG)  80,  105,  123,  138 
Soundchip,  hardwaremaBige  Einbindung  des  860 
Sounderzeugung  (STE)  1294 
Soundgenerator  (PSG)  859, 1359 
SOUNDSHIFTER  (TT)  1212 

Source-Address-Register  (BLITTER,  Adr.  $FF  8A24)  851 
Source-Buffer  (BLITTER)  852 

Source-X-Increment-Register  (BLITTER,  Adr.  $FF  8A20)  851 

Source-Y -Increment-Register  (BLITTER,  Adr.  $FF  8 A22)  851 

Speicher,  virtueller  1014 

Speicheraufteilung  des  ST  795 

Speicherbestiickung  (ST)  796 

Speichererweiterung  (ST)  799 
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Speicherkapazitat  (Floppy-Disk)  945 

Speicherkonfiguration  (ST)  799,  1349 

Speicherraumreservierungen,  Megabus-  825 

Speichertest,  ST-  800 

Speicherverwaltung  36,  179 

Spur  38,114,945 

Spur  im  Speicher  (Disk)  97 1 

Spur  suchen  (FDC)  965 

Spurwechsel  (Disk)  946 

Spuranfang  (Disk)  952 

Spuren  (Disk)  945 

Spurious  Interrupt  ($60)  53 

Spurwechselzeit  1 16, 959,  961 

Src_Addr  (BLITTER,  Adr.  $FF  8A24)  85 1 

Src_Yinc  (BLITTER,  Adr.  $FF  8 A22)  85 1 

SRP  (68030)  1016 

Ssbrk  (XBIOS  1)  155 

sshiftmd  ($44C)  62 

SSP  268 

ST-Betriebsmodi  (TT-Video)  1048 
ST-Blitter  842 

ST-High-Resolution  (TT)  1048 
ST-Low-Resolution  (TT)  1049 
ST-Magazin  82 

ST-Medium-Resolution  (TT)  1049 

ST-MFP  (TT)  1061 

ST-RAM  (TT)  1039 

ST-RAM-Erweiterungskarte  (TT)  1040 

Stack  188, 268 

Stack-Pointer  (68000)  793 

Stackpointer  (68030)  1010 

Stacy,  LCD-Steuerung  1351 

Standard  Access  (VME-Bus)  1 1 88 

Standardformat  415, 421 

Standardkanal  174,  206  f.,  216,  233  f. 

Standardzugriffspfad  696 

Stapelzeiger  (68000)  793 

START  DRAW  AREA  PRIMITIVE  (80)  524 

START  GROUP  (10)  524 

Start/Stop-Betrieb  (SCC)  1 136, 1 142 

START/STOP  UNIT  (SCSI)  1113 
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Startadresse  des  FAST-RAM  1 045 

Startbit  (MFP-USART)  892 

Startbit  (MIDI)  919 

Startbit  (SCC)  1136 

Startupcode  189,  541 

Startwert,  Supervisor-Stack-Pointer-  796 

State  Frame  (68882)  1031 

Status  266  f. 

STATUS  (68030)  1009 

Status  der  Sende-  und  Bmpfangsbuffer  (SCC)  1 169 

Status  inquiries  (IKBD  $87-$9A)  941 

STATUS-Phase  (ACSI)  984,  989 

STATUS-Phase  (SCSI)  1080, 1082 

Statusbyte  (ACSI)  989,  998 

Statusbyte  (SCSI)  1082 

Statusbytes  (MIDI)  917 

Statuspaket  (IKBD)  942 

Statusregister  (68000)  52, 793 

Statusregister  (68030)  1010 

Statusregister  ( ACI A)  9 1 1 ,  9 1 4,  92 1 

Statusregister  (MIDI-ACIA,  Adr, 

$FF  FC04)  915 

Statusregister  (Tastatur-ACIA,  Adr. 

$FFFC00)  915 
stdaux  173,  237 
stderr  176 

stdin  173,  209  f.,  212, 218  f.,  233  1,  237 

stdout  173,  210  f„  214,  219,  233  f„  237 

stdpm  173,  237 

STE,  Hardware  1285 

Steckerformat  (Disk)  953 

Step  (FDC)  952 

Step  direction  (FDC)  952,  962 

Step-Impuls  (FDC)  962,  966 

STEP  IN  (FDC)  966 

STEP  OUT  (FDC)  966 

Steprate  (FDC)  1 16,  959,  961 

Stereo-Modus  (STE)  1296 

STERM  (68030)  1006 

Steuerpegel  (FDC)  956 

Steuerregister  (AC1A)  912 
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Steuerregister  (MIDI-ACIA,  Adr. 

$FF  FC04)  915 

Steuerregister  (Tastatur-ACIA,  Adr. 

$FF  FCOO)  915 

Steuersignale  fur  die  Floppy-Disk-Steuerung  (PSG)  861 
Steuerung,  FDC/ACSI-  816 
Steuerungsverfahren  (SCC)  1 1 37  f. 

Steuerungsverfahren  (SCC),  synchrone/asynchrone  1 136 

STOP  (3)  644 

Stopbit  (MFP-USART)  892 

Stopbit  (MIDI)  919 

Stopbit  (SCC)  1136,1156 

Stopbits  (MFP-USART),  Anzahl  896 

STROBE  (par.  Schnittstelle)  907 

Stromsteuerung  (MIDI)  921 

Stromversorgungsanschlusse  (VME-Bus)  1 193 

Struktur  (Disk)  947 

Super  (GEMDOS  32)  268 

Supervisor-Betrieb  (68030)  1010 

Supervisor-Modus  52,  156,  268,  793 

Supervisor-Root-Pointer  (68030)  1016 

Supexec  (XBIOS  38)  156 

Sversion  (GEMDOS  48)  269 

_SWI  80 

swv_vec  ($46E)  48,  63 
Symboltabelle  195 
Sync-Mode-Register  (ST(E)),  Adr. 

SFF820A  839 

Sync-Mode-Register  (TT,  Adr.  $FF(FF)  820A),  ST(E)-  1055 
Synchronbetrieb  (SCC)  1136, 1142, 1155 
Synchronimpulse  (TT)  1048 
Synchronisation  der  Dateniibertragung  (ACSI)  987 
Synchronisationsbyte  (Disk)  970 
Synchronisationssignale  (ST(E)-Video)  829 

Synchronous-Character-Register  (ST-MFP-USART,  Adr.  $FF  FA27)  896 

Synchronous-Character-Register  (TT -MFP-USART,  Adr.  $FF(FF)  FAA7)  1070 

Synchronous  Data  Link  Control  1138 

Synchronous  Termination  (68030)  1006 

Synchronzeichen  (MFP-USART)  891 , 896 

Synchronzeichen  (SCC)  1137 
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syncmode  (TT,  Adr.  $FF(FF)  820A) 

1056 

Synthesizer  9 16 
Syquest  32,34,1114 
_sysbase  ($4F2)  1 1, 67,  91,  181,  270 
SYSCLK  (VME-Bus)  1192 
SYSFAIL  (VME-Bus)  1192 
SYSRESET  (VME-Bus)  1 1 92  f. 

System  Commands  (MIDI)  920 
System  Control  Unit  (SCU)  1195, 1367 
System  Int.  Mask-Register  (SCU,  Adr. 

$FF  8E01)  1195 

System  Int.  Status-Register  (SCU,  Adr.  $FF  8E03)  1196 
System-RESET  (Megabus)  823 
System  Software  Int.  (SCU,  Adr. 

SFF8E05)  1197 
System-Timer  97 
system()  68 

Systembus  des  MEGA  ST  820 
Systemdatei  227,  229,  247 
Systemdatum  270,  272 
Systemdiskette  801 
Systeminitialisierung  44 
Systemtakt  (68030)  1003 
Systemtakt  (IKBD)  925 
Systemtakt  (STE)  1313 
Systemvariablen  796 
Systemzeichensatze  287,  666 
Systemzeit  129,  231, 271,  273 
sysjnt  (SCU,  Adr.$FF  8E05)  1 197 
sys_mask  (SCU,  Adr.SFF  8E0 1 )  1195 
sys_stat  (SCU,  Adr.SFF  8E03)  1 1 96 
s_data  (TT-SCSI,  Adr.  $FF(FF)  8781)  1116 
s_dmastat  (TT-SCSI,  Adr.  $FF(FF)  878B)  1 1 22 
sjcr  (TT-SCSI,  Adr.  $FF(FF)  8783)  1 1 17 
sjdstat  (TT-SCSI,  Adr.  $FF(FF)  8789)  1 121 
sjnircv  (TT-SCSI,  Adr.  $FF(FF)  878F)  1 124 
s_mode  (TT-SCSI,  Adr.  $FF(FF)  8785)  1 1 19 
sjargrcv  (TT-SCSI,  Adr.  $FF(FF)  878D)  1 123 
s_tcr  (TT-SCSI,  Adr.  $FF(FF)  8787) 

1121 
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T 

Tabellen-Deskriptor  (68030)  1015 

TACR  (ST-MFP,  Adr.  $FF  FA19)  879 

TACR_TT  (TT-MFFP,  Adr.  $FF(FF)  FA99)  1 065 

TADR  (MFP,  Adr.SFF  FA  IF)  878 

TADR_TT  (TT-MFP,  Adr.  $FF(FF)  FA9F)  1066 

TAI  (par.  Schnittstelle)  910 

TAI(Timer-A-InputdesMFP)  875 

Takt  (68030)  1009 

Takt  (68882)  1020 

Taktflanke  (FDC),  fehlende  970 

Taktfrequenz  (ACIA)  9 1 1 

Taktfrequenz  (MFP-USART)  897 

Taktquelle  fur  Kanal  A/B  (SCC)  1 141,  1 165 

Taktrilckgewinnung  (Dateniibertragung)  1 139  f. 

Taktriickgewinnung  (SCC)  1167 

Taktumschaltung  (STE)  1314 

Target  (ACSI)  982,990 

Target  (SCSI)  1073 

Task  (68030)  1014 

Tastatur  129,131,219,922 

Tastatur  (MEGA  ST(E)),  AnschluBbild  der  932 

Tastatur  (ST)  (Schaltbild)  930 

Tastatur-ACIA  (Ubersicht)  1379 

Tastatur- ACIA,  Interrupt  von  870 

Tastatur-Empfangsregister  (Tastatur-ACIA,  Adr.  $FF  FC02)  915 
Tastatur-Ereignis  543 

Tastatur-Senderegister  (Tastatur-ACIA,  Adr.  $FF  FC02)  915 

Tastatur-Statusregister  (Tastatur-ACIA,  Adr.  $FF  FC00)  915 

Tastatur-Steuerregister  (Tastatur-ACIA,  Adr.  $FF  FCOO)  915 

Tastaturbelegung  100,758 

Tastaturchip  56,  84,  86,  124, 129,  922 

Tastaturmatrix  929,931 

Tastaturprozessor  (IKBD)  923 

Tastaturzeichen  (IKBD)  929 

Tastencode  11,  83,  132, 209,  607 

Tastendynamik  (MIDI)  917 

TA_ASCENT  (2)  407 

TA_BASELINE  (0)  407 

TA_BOTTOM  (3)  407 
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TA_CENTER  (1)  407 
TA_DESCENT  (4)  407 
TA_HALF  (1)  407 
TAJLEFT  (0)  407 
TA_RIGHT  (2)  407 
TA_TOP  (5)  407 

TBCR  (ST-MFP,  Adr.  $FP  FA  1 B)  880 
TBCRJTT  (TT-MFP,  Adr.  $FF(FF)  FA9B)  1 065 
TBDR  (ST-MFP,  Adr.  $FF  FA21)  879 
TBDRJTT  (TT-MFP,  Adr. 

$FF(FF)  FAA1)  1066 
TBI  (Timer-B-Input  des  MFP)  875 
TCDCR  (ST-MFP,  Adr.  $FF  FAl  D)  880 
TCDCR_TT  (TT-MFP,  Adr. 

$FF(FF)  FA9D)  1066 
TCDR  (ST-MFP,  Adr.  $FF  FA23)  879 
TCDR_TT  (TT-MFP,  Adr. 

$FF(FF)  FAA3)  1066 
TDDR  (ST-MFP,  Adr.  $FF  FA25)  879 
TDDR_TT  (TT-MFP,  Adr. 

$FF(FF)  FAA5)  1066 
TEDINFO  559,561 
Terminate  and  stay  resident  267 
Terminate  Process  265  f. 

Test  Drive  Ready  (ACSI)  991 

TEST  UNIT  READY  (SCSI)  1 089 

TEXT  (VDI 8)  186,  351, 401,  406, 441,  466,  468, 470 

Textattribut  375,  404 

TextBlt  (Text  Block  Transfer)  ($A008)  315 

Texteffekte  375,  404 

TE_CNTR  (2)  560 

TEJLEFT  (0)  560 

TEJRIGHT  (1)  560 

TFJLIGHTENED  (0x02)  405 

TFJNORMAL  (0x00)  405 

TF_OUTLINED  (0x10)  405 

TF_SHADOWED  (0x20)  405 

TF_SLANTED  (0x04)  405 

TFJTHICKENED  (0x01)  405 

TFJJNDERLINED  (0x08)  405 

Tgetdate  (GEMDOS  42)  23 1 , 270  ff. 
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Tgettime  (GEMDOS  44)  231,271,273 

themd  ($48E)  65 

the_env  ($4BE)  66 

Tickcal  (BIOS  6)  61,97 

Time-of-day  clock  set  (IKBD  $  IB)  940 

Timer  (IKBD)  925 

Timer  (TT-MFP)  1065 

Timer-A-Control-Register  (ST-MFP,  Adr.  $FF  FA19)  879 
Timer- A-Control-Register  (TT-MFP,  Adr.  $FF(FF)  FA99)  1065 
Timer-A-Data-Register  (MFFP,  Adr. 

$FF  FA  IF)  878 

Timer-A-Data-Register  (TT-MFP,  Adr.  $FF(FF)  FA9F)  1066 

Timer-A-Input  (MFP)  875 

Timer- A-Input  (par.  Schnittstelle)  910 

Timer-A-Input  (TT-MFP)  1065 

Timer-A-Interrupts  (STE-Sound)  1299 

Timer-B-Control-Register  (ST-MFP,  Adr.  $FF  FA  IB)  880 

Timer-B-Control-Register  (TT-MFP,  Adr.  $FF(FF)  FA9B)  1065 

Timer-B-Data-Register  (ST-MFP,  Adr.  $FF  FA21)  879 

Timer-B-Data-Register  (TT-MFP,  Adr.  $FF(FF)  FAA1)  1066 

Timer-B-Input  (MFP)  875 

Timer-B-Input  (TT-MFP)  1065 

Timer-Betriebsarten,  MFP-  873 

Timer-C  (TT-MFP)  als  SCC-Taktgeber  1066 

Timer-C-Data-Register  (ST-MFP,  Adr.  $FF  FA23)  879 

Timer-C-Data-Register  (TT-MFP,  Adr.  $FF(FF)  FAA3)  1066 

Timer  C-Interrupt  866 

Timer-C/D-Control-Register  (ST-MFP,  Adr.  $FF  FA1D)  880 
Timer-C/D-Control-Register  (TT-MFP,  Adr.  $FF(FF)  FA9D)  1066 
Timer-Control/Status-Register  (TCSR)  (IKBD)  926 
Timer-D-Data-Register  (ST-MFP,  Adr.  $FF  FA25)  879 
Timer-D-Data-Register  (TT-MFP,  Adr.  $FF(FF)  FAA5)  1066 
Timer-D-Output  (ST-MFP-USART)  894 
Timer-Data-Register  (MFP)  874  f. 

Timer-Ereignis  543 
Timer-Interrupt  (MFP)  877 
Timer-Programmierung  878 
Timer,  ST-MFP-  872 
Timerinterrupt  445 

Timing-Logik,  ST-Video-Controller-  837 
_timr_ms  ($442)  61,97 
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Tonerzeugung  (PSG)  862 

Tongenerator-Control-Register  (PSG)  863 

Tonhohe-Rauschen-Register  (PSG)  863 

Tonsignal  “zusammenbauen”  (STE)  1294 

Tonsignal,  extemes  (ST)  866 

TOS  1.02  802 

TOS  1.04  166 

TOS14FIX.PRG  904 

TOUCHEXIT  (0x0040)  557, 652 

TPA  187 

Trace  ($24)  52 

Track  38,114,945 

Track  00  (FDC)  952,965 

Track-Layout  (Disk)  947,  972 

Track-Register  (FDC)  962 

Transfer  Size  (68030)  1005 

Transferlange  (SCSI)  1088,  1091,  1101, 1112 

Transferphase  (SCSI)  1080 

Transferrate  (TT-SCSI)  1116 

TRANSFORM  FORM  (VDI 1 10)  415, 421 

Transform  mouse  ($A00B)  318 

Translation  Control  Register  (TC)  (68030)  1017 

Transmit/Receive-Control  and  Status-Register  (TRCSR)  (IKBD)  928 

Transmitter  Clock  (ST-MFP-USART)  894 

Transmitter-Status-Register  (ST-MFP-USART,  Adr.  $FF  FA2D)  895, 900 
Transmitter-Status-Register  (tsr,  Adr. 

$FF  FA2D)  147,190 

Transmitter-Status-Register  (TT-MFP-US ART,  Adr.  $FF(FF)  FAAD)  1 07 1 
TRANSPARENT  418 
Transparent  Translation  Register 

(TTO/TTl)  1014 
TRAP  #0  ($80)  54 
TRAP#1  ($84)  54 
TRAP  #13  ($B4)  54 
TRAP  #14  ($B8)  55 
TRAP  #15  ($BC)  55 
TRAP  #2  ($88)  54 
Treiberstufen  (FDC)  956 
trpl4ret  ($486)  65 
True-Color  288 
Tsetdate  (GEMDOS  43)  272 
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Tsettime  (GEMDOS  45)  273 

tsr  ($FF  FA2D)  147,190 

TSR  (ST -MFP-US ART,  Adr.$FF  FA2D)  900 

TSR_TT  (1T-MFP-USART,  Adr. 

$FF(FF)  FAAD)  1071 
TT-Cartridgeport  1045 
TT-DMA-Soundteil  1213 
TT-FAST-RAM-Memory  Controller  Unit  1044 
TT-Grafik-Betriebsarten  1049 
TT-MFP  1063,  1374 
TT-RAM  182,  194,  1039,  1042 
TT-Uhrenchip  1201  f. 

TTFMCU  1044 

TTSCU  (68882)  1019 

TT_colX,  (ab  Adr.  $FF(FF)  8400)  1058 

tt_dmabas  (TT-SCSI,  ab  Adr. 

$FF(FF)  8701)  1125 
tt„dmacnt  (TT-SCSI,  ab  Adr. 

$FF(FF)  8709)  1125 

tt_dmactl  (TT-SCSI,  Adr.  $FF(FF)  8714)  1126 
tt_dmarsd  (TT-SCSI,  ab  Adr. 

$FF(FF)  8710)  1125 
Turbo-DOS  269 
Turbolader  813,818 
TxCLK(ACIA)  911 
TxDATA  (ACIA)  911 
TxINT(ACIA)  913 
Typenraddrucker  154 


Stichwortverzeichnis 


1481 


u 

ucr  ($FF  FA29)  147 

UCR  (ST-MFP-USART,  Adr.  $FF  FA29)  896 
UCR_TT  (TT-MFP-USART,  Adr. 

$FF(FF)  FAA9)  1070 

UDR  (ST-MFP-USART,  Adr.  $FF  FA2F)  903 
UDR_TT  (TT-MFP-USART,  Adr. 

$FF(FF)  FAAF)  1071 
UDS  (68000)  793,807 
UDS  (Megabus)  823 

Obertragungsprotokoll  (STE-MICROWIRE(TM)-Interface)  1309 

Ubertragungsrate  (ser.  Schnittstelle)  903 

Uhr  im  IKBD-Chip  940 

Uhrenchip  (MEGA  ST(E))  1325 

Uhrenchip  (TT)  1201 1, 1362 

Uhrenchip-Register  (MEGA  ST(E)) 

1327 

Uhrenchips  (TT-Uhr),  Programmierung  des  1208 
Uhrenregister  (TT)  1202 
Uhrzeit  129,231,271,273 
Umrahmung  412 
UmriB  655 

Umschalttasten  1 1,  455 
Undraw  sprite  ($A00C)  318 

Universal  Synchronous/  Asynchronous  Receiver/  Transmitter,  ST-MFP-  894 

UNLOAD  FONTS  (VDI 120)  345 

Unterbrechungen  (ST(E))  840 

Unterbrechungsmaske  (CPU)  881 

UP  ARROW  (0x0040)  678,693 

UPDATE  METAFILE  EXTENTS  (VDI  5,  Escape  98)  521 
UPDATE  WORKSTATION  (VDI  4)  341,502 
Upper-Data-Strobe  (68000)  793 
Upper-Data-Strobe  (Megabus)  823 
usage  count  263 

US ART-Control-Register  (ST-MFP-USART,  Adr.  $FF  FA29)  896 
U S  ART -Control-Register  (TT-MFP-USART,  Adr.  $FF(FF)  FAA9)  1070 
USART-Control-Register  (ucr,  Adr. 

$FF  FA29)  147 

USART-Data-Register  (ST-MFP-USART,  Adr.  $FF  FA2F)  903 
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USART-Data-Register  (TT-MFP-USART,  Adr.  $FF(FF)  FAAF)  1071 

USART-Empfanger  (MFP)  895 

USART-Sender  (MFP)  895 

USART,  ST-MFP-  894 

User-Modus  (68000)  268,  793 

User-Modus  (68030)  1010 

USERBLK  564 

USP  268 
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V 

V-Signal  bei  Colorbetrieb  (ST(E))  829 
V-Synchronimpulse  (ST(E))  838 
Valid  Memory  Address  (Megabus)  824 
Valid  Peripheral  Address  (Megabus)  824 
_vbclock  ($462)  48,  63 

VBlank  21, 48,  53,  62  f.,  66,  151,  156,  840,  866,  882 
_vblqueue  ($456)  49,  62,  66 
vblsem  ($452)  48,62f. 

_vbl_list  ($4CE)  66 

vcounthi  (Adr.  $FF  8205)  840,  1055, 1317 

vcountlow  (Adr.  $FF  8209)  840,  1055,  1317 

vcountmid  (Adr.  $FF  8207)  840,  1055,  1317 

VDI-Bindings  296  f. 

vdi()  299 

VDIESC  310 

_VDO  80 

Vektor  Base  Register  (VBR)  (68030)  1010 
Vektomummer  (MFP)  888 
Vektornummer  (SCC)  1 1 53  f. 

Vektomummer  (TT-MFP)  1067 
Vektomummer  (VME-Bus)  1191,1193 
Verify  61,962,966 

Verknupfungsmoglichkeiten  (BLITTER)  843 

Versorgungs-  und  Hilfsleitungen  (VME-Bus)  1 1 86 

Vertical-Blank-Intemipt  21, 48,  53,  62  f.,  66,  151, 156,  829,  840 

Vertical-Blank-Interrupt  (ST(E))  829,  840 

Verzogerungs-Timer  (MFP)  874 

vex„butv  (VDI  125)  450 

vex_curv  (VDI 127)  453 

vex_motv  (VDI  126)  452 

vex_timv(VDI  118)  445 

VGA-Monitor  (TT)  1048 

Video-Address-Counter  (ST)  840 

Video-Address-Counter  (STE)  1316  f. 

Video-Address-Counter  (TT)  1055 
Video-Addr. -Counter  High-Byte  (Adr. 

$FF  8205)  840 

Video-Addr.-Counter  Low-Byte,  (Adr. 

SFF8209)  840 
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Video- Addr.-Counter  Mid-Byte  (Adr. 

$FF  8207)  840 
Video-Base-Register  (ST)  839 
Video-Base-Register  (STE)  1285,  1316 
Video-Base-Register  (TT)  1055 
Video -Controller  (Megabus)  822 
Video-Controller,  Prinzipschaltbild  des  ST-  837 
Video-Hardware  (STE)  829 
VideoanschluB  (TT)  1047 
Videocontroller  80 
Videocontroller,  ST-  835,1349 
Videocontroller,  TT-  1053 
Videohardware  (STE)  1285, 1313 
Videohardware  (TT)  1047 
V ideosignale  mischen  (STE)  1313 
Virenprogramme  21 
Virgin-Byte  (ACSI)  994 
VME-Bus  1185 

VME-Bus  im  TT/MEGA  STE,  HardwaremaBige  Realisierung  des  1194 

VME-Bus  Int.  Level  3  erzeugen  (SCU,  Adr.  SFF  8E07)  1 198 

VME-Bus  Int.  Mask-Register  (SCU,  Adr.  $FF  8E0D)  1196 

VME-Bus  Int.  Status-Register  (SCU,  Adr.  $FF  8E0F)  1 197 

VME-Bus-Interruptquellen  (SCU)  1197 

VME-Bus-Standard,  Einschrankungen  gegcniiber  dem  1192 

VME-Bus-Stecker  1186 

VME-Bus,  Lesezugriff  1188 

VME-Buskonzept  1185 

vme_int  (SCU,  Adr.$FF  8E07)  1198 

vme_mask  (SCU,  Adr.$FF  8E0D)  1 1 96 

vme_stat  (SCU,  Adr.$FF  8E0F)  1197 

vm_coords  (VDI 5,  Escape  99,  Opcode  1)  324,  526 

vm_filename  (VDI  5,  Escape  100)  528 

vm_pagesize  (VDI  5,  Escape  99, 

Opcode  0)  324,  525 
Voice-Commands  (MIDI)  917 
volume  name  227, 229,  247 
Volume/Tone-Controller  LMC1992  (STE)  1308, 131 1 
Vorteiler  (MFP)  874,  879,  897 
VPA  (Megabus)  824 
vqf_attributes  (VDI  37)  465 
vqin_mode  (VDI  115)  476 
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vql_attributes  (VDI  35)  461 

vqm_attributes  (VDI  36)  463 

vqp_filmname  (VDI  5,  Escape  92)  5 1 8  f. 

vqt_attributes  (VDI  38)  466 

vqt_extent  (VDI  116)  468 

vqt_fontinfo  (VDI  131)  477 

vqt  justified  (VDI  132)  480 

vqt_name  (VDI  130)  472 

vqt_width  (VDI  1 17)  470 

vq_cellarray  (VDI  27)  474 

vq_chcells  (VDI  5,  Escape  1)  482 

vq_color  (VDI  26)  308, 459 

vq_curaddress  (VDI  5,  Escape  15)  496 

vq_extnd  (VDI  102)  283,  297,  307, 456 

vq_gdos()  289,343 

vq_key_s  (VDI  128)  455 

vq_mouse  (VDI  124)  448 

vq_scan  (VDI  5,  Escape  24)  322,  506 

vq_tabstatus  (VDI  5,  Escape  16)  497 

vqjdimensions  (VDI  5,  Escape  84)  516 

VR  (ST-MFP,  Adr.  $FF  FA17)  888 

vro_cpyfm  (VDI  109)  415 

vrq_choiee  (VDI  30)  435 

vrq Jocator  (VDI  28)  427 

vrq_string  (VDI  31)  439 

vrq_valuator  (VDI  29)  431 

vrt_cpyfm  (VDI  121)  418 

vr_recfl  (VDI  1 14)  358 

vr_tmfm(VDI  110)  421 

VR_TT  (TT-MFP,  Adr.  $FF(FF)  FA97)  1069 

vsc_expose  (VDI  5,  Escape  93)  520 

vsc_form  (VDI  1 1 1)  443 

vsf_color  (VDI  25)  411 

vsfjnterior  (VDI  23)  408, 4 1 3 

vsf_perimeter  (VDI  104)  412 

vsf_style  (VDI  24)  409 

vsf_udpat  (VDI  112)  413 

vsin. jnode  (VDI  33)  425 

VSLIDE  (0x0100)  678,693 

vsl_color  (VDI  17)  388 

vsl_ends  (VDI  108)  389 
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vsl_type  (VDI 15)  384 

vsl_udsty  (VDI 113)  386 

vsLwidth  (VDI  16)  387 

vsm_choice  (VDI  30)  437 

vsm.  coloT  (VDI  20)  395 

vsmjieight  (VDI  19)  393 

vsrnjocator  (VDI  28)  429 

vsm_string  (VDI  31)  441 

vsm_type  (VDI  18)  391 

vsm_valuator  (VDI  29)  433 

vsp_film  (VDI  5 ,  Escape  91)  518 

vst_alignment  (VDI  39)  406 

vst_color  (VDI  22)  403 

vst_effects  (VDI  106)  404 

vst_font  (VDI  21)  402 

vst_height  (VDI  12)  396 

vstjoadfonts  (VDI  1 19)  287,  289,  343, 472 

vst_point  (VDI  107)  398 

vst_rotation  (VDI  13)  401 

vst_unload_fonts  (VDI  120)  345 

vswr_mode  (VDI  32)  377 

Vsync  (XBIOS  37)  156 

vs_clip  (VDI  129)  346 

vs„color  (VDI  14)  382 

vs_mute  (VDI  5,  Escape  62)  512 

vs_palette  (VDI  5,  Escape  60)  510 

VT52-Emulator  7 

vt_alignment  (VDI  5,  Escape  85)  517 
vt_axis  (VDI  5,  Escape  82)  514 
vt_origin  (VDI  5,  Escape  83)  515 
vt_resolution  (VDI  5 ,  Escape  81)  513 
v_alpha_text  (VDI  5,  Escape  25)  322, 508 
v_arc  (VDI  1 1 ,  GDP  2)  361 
v_bar  (VDI  1 1,  GDP  1)  360 
_v_bas_ad  ($44E)  48,62 
v_bit_image  (VDI  5,  Escape  23)  504 
v_cellarray  (VDI  10)  355 
v_circle  (VDI  1 1,  GDP  4)  365 
v_clear_disp_list  (VDI  5,  Escape  22)  503 
v_clrwk  (VDI  3)  340 
v_clsvwk(VDI  101)  339 
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v_clswk  (VDI 2)  325,336 
v_contourfill  (VDI  103)  357 
v_curaddress  (VDI  5,  Escape  11)  492 
v_curdown  (VDI  5,  Escape  5)  486 
v_curhome  (VDI  5,  Escape  8)  489 
v_curleft  (VDI  5,  Escape  7)  488 
v_cuiright  (VDI  5,  Escape  6)  487 
v_curtext  (VDI  5,  Escape  12)  493 
v_curup  (VDI  5,  Escape  4)  485 
v_dspcur  (VDI  5,  Escape  18)  499 
v_eeol  (VDI  5,  Escape  10)  491 
v_eeos  (VDI  5,  Escape  9)  490 
v_ellarc  (VDI  1 1 ,  GDP  6)  369 
v_ellipse  (VDI  1 1 ,  GDP  5)  367 
v_ellpie  (VDI  1 1 ,  GDP  7)  37 1 
v_enter_cur  (VDI  5,  Escape  3)  484 
v_escape2000  (VDI  5,  Escape  2000)  531 
v_exit_cur  (VDI  5,  Escape  2)  483 
v_fillarea  (VDI  9)  353 
v_fontinit  (VDI  5,  Escape  102)  530 
v_form_adv  (VDI  5,  Escape  20)  501 
v_get_pixel  (VDI  105)  283,  423 
v_gtext  (VDI  8)  351 
v_hardcopy  (VDI  5,  Escape  17)  498 
v_hide_c  (VDI  123)  447 
v  Justified  (VDI  1 1 ,  GDP  10)  375 
v_raeta_extents  (VDI  5,  Escape  98)  324,  521 
v_offset  (VDI  5 ,  Escape  101)  529 
v_opnvwk  (VDI  100)  121,  337 
v_opnwk  (VDI  1)  308,  325,  330, 456, 

539 

v_output_window  (VDI  5,  Escape  21)  502 
v_pieslice  (VDI  1 1,  GDP  3)  363 
v_pline  (VDI  6)  347 
v_pmarker  (VDI  7)  349 
v_rbox  (VDI  11,  GDP  8)  373 
v_rfbox  (VDI  11,  GDP  9)  374 
v„rmcur  (VDI  5,  Escape  19)  500 
vjrvoff  (VDI  5,  Escape  14)  495 
v_rvon  (VDI  5,  Escape  13)  494 
v_show_c  (VDI  122)  3 1 7, 446 
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v.sound  ( VDI 5 ,  Escape  61)  511 
v_updwk  (VDI 4)  341 
v_write_meta  (VDI  5,  Escape  99)  523 


Stichwortverzeichnis 
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W 

WAIT  (2)  644 
Warmstart  60 
WC_BORDER(0)  693 
WC_WORK  (1)  693 
WD1772  956 
Wechselplatte  32,  34,  1 1 14 
Werkzeugleiste  755 
WF_COLOR  (18)  688 
WF_CURRXYWH  (5)  683,687 
WF_CXYWH  (5)  684 
WF_DCOLOR  (19)  688 
WFJFIRSTXYWH(ll)  683 
WF_FULLXYWH  (7)  683 
WFJFYXWH(7)  684 
WF_HSLIDE  (8)  683,687 
WFJHSLSIZE  (15)  684,687 
WF_INFO  (3)  687 
WF_NAME  (2)  687 
WF_NEWDESK  ( 1 4)  687 
WF_NEXTXYWH  (12)  683 
WF_PREVXYWH  (6)  683 
WF_PXYWH  (6)  684 
WF_SCREEN  (17)  684 
WF_SIZTOP  (19)  687 
WFJTATTRB  (18)  687 
WF_TOP  (10)  683,687 
WFJVSLIDE  (9)  683,687 
WF_VSLSIZE  (16)  684,687 
WF_WORKXYWH  (4)  683 
WF_WXYWH  (4)  684 
WHITE  (0)  558 
WHITEBAK  (0x0040)  558 
Wiederholrate  131 
Wildcards  245 

Wilde,  Kim:  “Love  moves”  23 
W1NDCALC  (AES  108)  581,692 
WIND_CLOSE  (AES  102)  582,  680 
WIND_CREATE  (AES  100)  582, 677,  679 
WINDJDELETE  (AES  103)  582,  680  f. 
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WIND_FIND  (AES  106)  551,689 
WIND_GET  (AES  104)  581,682 
WIND_NEW  (AES  109)  694 
WIND_OPEN  (AES  101)  582,  679  f. 

WINDJSET  (AES  105)  535,  679,  686 
WIND_UPDATE  (AES  107)  594,  690 
WM_ARROWED  (24)  545 
WMJXOSED  720,732,739 
WM_CLOSED  (22)  545 
WM_FULLED  (23)  545 
WMJHSLID  (25)  545 
WM_MOVED  (28)  546 
WM_NEWTOP  (29)  546 
WMJREDRAW  (20)  544,  597, 739 
WM_SIZED  (27)  546 
WM_TOPPED  (21)  545 
WM_UNTOPPED  (30)  546 
WM_VSLID  (26)  546 
work  area  578 

Workstation  276,  330,  336  f.,  339  ff.,  666 

Workstation,  virtuelle  277 

Wortlangenzahler  (MFP-USART)  899 

Wortzugriff  (CPU)  794 

Wrap  at  end  of  line  ( VT52  ESC  v)  9 

WRITE  (SCSI)  1102 

Write  character  to  standard  AUX:  208 

Write  character  to  standard  output  211 

Write  character  to  standard  PRN:  217 

Write  Data  (FDC)  952 

Write  gate  (FDC)  951,969 

WRITE  METAFILE  ITEM  (VDI 5,  Escape  99)  523 

Write  protect  (FDC)  952,  968 

WRITE  SECTOR  (ACSI)  995 

WRITE  SECTOR  (FDC)  968 

Write  string  to  standard  output  214 

Write  to  file  249 

WRITE  TRACK  (FDC)  970 

Writing  Mode  377 

WYSIWYG  746,764 


Stichwortverzeichnis 
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X 


X-Count-Register  (BLITTER,  Adr. 

$FF  8A36)  847 
XBRA  16,82,167 
Xbtimer  (XBIOS  31)  157 
xconin  ($53E)  6,  70 
xconout  ($57E)  6,71 
xconstat  ($5  IE)  6,  70,  98 
XCONTROL  580,688,717 
xcostat  ($55E)  6,71 
XCPB  724  f. 

Xformdo  739 
XGen_AJert  741 
XGM-Partition  29 
XGRF_2BOX  (AES  131)  714 
XGRF_STEPCALC  (AES  130)  712 
XOFF-/XON — Zeichen  904 
XON/XOFF-Betrieb  127 
XOR  418 

XPEN  (STE,  Adr.  $FF  9220)  1290 
XSINT  (STE-Sound)  1299 
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Y 

Y-Count-Register  (BLITTER,  Adr. 

SFF8A38)  847 
YELLOW  (6)  558 
YM  2149  (PSG)  859 
YPEN  (STE,  Adr.  $FF  9222)  1290 


Z 


Zahlenformate  (68882)  1023 
Zeichen  (MIDI)  919 
Zeichenausgabe  (par.  Schnittstelle)  909 
Zeichenlange  (MFP-USART)  897 
Zeichenorientierte  Steuerungsverfahren  1137 
Zeichensatz  287,  3 16, 402,  472,  477,  530 
Zeichensatzformat  289 
Zeichensatznamen  292 
Zeit  129,231,271,273 
Zentraleinheit  787,  793 
Zwischenabiage  572,  670  ff.,  75 1 
Zyklische  Blockpriifung  (Disk)  949 
Zylinder  (ACSI)  997 


ATARI  Profibuch 
ST-STE-TT 


I  mpluhlen  far 


✓  Einsteiger 

✓  Forljinchriltme 


✓  Profis 


I  ✓  Anleitung 


✓  Referent 


look 


HuelireciilStsteiiuilik 


Atari  ST/STE/TT:  Software/Hardware/Peripherie 


Hie  Vulnreii  I l.ni'-l tieler  JunUn\ki.  Dielniui  K  ninth  unci  Julian  I.  Kr^hkc  huheii  wilder 
ilir  geliullfes  Wiwni  /ii  den  VlarUKeehneru  iler  M-.MI  ■  uml  I  l-Mii<lellreihcii  /uvummen- 
t>elraj>eii  mid  iihersicttltieli  dukumenlierl. 

Jel/I  neu  in  dieser  kinii|ilelt  tilicrarln-ilelen  Vusgabc: 

•  Dukuiiieiilaliitii  /it  alien  iieuen  I  OS-Versiiinen  uu«  Sit  .  MEC.A  Ml  mill  II 

•  Vnsliihrliihe  .,(  ser  Interface  t>uillelincs*‘  mil  Progrumntheisiiielen 

•  Her  t  nokie-Jur 

•  Itie  I'riigriitiimieriiiii:  mil  \(  ON  I  KOI  -Mudnlen 
■  Dus  VKOV-Vcrfuliren 

•  N  idlig  uiierurltcilcle  einliihieude  K.i|iilel  /u  ItlOS.  MtlOS.  t.l  MOOS.  \  Ol  mill  VI  S 

•  Nine  llantware  in  M  I  mid  Ml  (>  \  Nil  (t.rulik.  OM  \-Smind.  I  VN-Schnillstclle 
|St  t  |.  Micrnwirr-lnterluce.  V  Ml.-Rus) 

•  Weilere  neur  Hardware  ini  I  I II.W  <  t.rulik.  I  I- VI I  |*  scrielte  Sctiiiillslcllcii.  St  SI- 
t  imlndler.  ST- RAM  mill  I  l-K  VM.  tier  Ml  hXXKI/2.  die  S(  I  .  Kealliine-t  luck) 

•  si.iiidiirdlieleliUs.il/  cun  S(  s|-|  esl|ilulien 

Viilterdem  findeii  Sie  uueh  nlle  ..althewuhrlvn*'  I  heinen  also  Kelrielissi stem  mid 
Hardware  uller  Sl-Modelle  wieder. 


Ik-st..  Nr.  DOM 
ISIIN  .t-WI745-KJtX-? 
I)M  7V.-/i.s  ftllk- 


